gemini-cli
Gemini CLI integration for context offloading. Use when calling gemini CLI, delegating large file analysis, summarizing code, or needing second opinions. Covers correct syntax, flags, environment variables, and common errors. Keywords: gemini, context offloading, large files, summarize, second opinion, gemini-assistant, gemini CLI.
安装与使用
请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。
查看来源 ↗使用指南技能说明
Gemini CLI: Context Offloading
Para: Claude Code Versão CLI: 0.19.1 Verificado: 2026-01-09
Esta skill instrui como usar o Gemini CLI para context offloading. NÃO ADIVINHE FLAGS - use apenas o documentado aqui.
Sintaxe
gemini [OPTIONS] "PROMPT_TEXT" [FILES...]
Flags Disponíveis
| Flag | Tipo | Descrição |
|---|---|---|
-m, --model |
string | Modelo (ex: gemini-2.5-flash) |
-o, --output-format |
string | text, json, stream-json |
-y, --yolo |
boolean | Auto-aprovar ações |
--approval-mode |
string | default, auto_edit, yolo |
-s, --sandbox |
boolean | Rodar em sandbox |
-d, --debug |
boolean | Modo debug |
-r, --resume |
string | Retomar sessão |
-e, --extensions |
array | Lista de extensões |
--include-directories |
array | Diretórios adicionais |
Flags que NÃO EXISTEM
-
--no-stream -
--sys-prompt -
--token-limit -
--fix -
--auto-apply
Variável de Ambiente
export GEMINI_API_KEY="sua-chave"
IMPORTANTE: Use apenas GEMINI_API_KEY. Se GOOGLE_API_KEY também estiver setada, ela tem precedência.
Padrões de Uso
Análise de Arquivos (Recomendado)
Passe arquivos como argumentos - Gemini lê diretamente:
gemini -y "Analise a arquitetura" CLAUDE.md ARCHITECTURE.md src/**/*.ts
Output Estruturado
gemini -y -o json "Liste problemas" src/*.py
Dados via Pipe
git diff main | gemini -y "Explique mudanças"
Context Offloading
Use Gemini quando:
| Situação | Usar Gemini? |
|---|---|
| Arquivo > 500 linhas | ✅ Sim |
| Múltiplos arquivos | ✅ Sim |
| Diff grande | ✅ Sim |
| Logs extensos | ✅ Sim |
| Edição pequena | ❌ Claude direto |
CORRETO
gemini -y "Analise" src/**/*.ts
INCORRETO
content=$(cat src/**/*.ts)
gemini -y "Analise: $content" # NÃO FAÇA ISSO
Erros Comuns
| Erro | Causa | Solução |
|---|---|---|
| "Both API keys set" | GOOGLE + GEMINI | Usar apenas GEMINI_API_KEY |
| "Unknown argument" | Flag inexistente | Usar apenas flags desta skill |
| Auth error | Key inválida | Verificar Google Cloud |
| Timeout | Esperando input | Usar -y |
Exemplo Completo
gemini -y -m gemini-2.5-flash "Você é um auditor. Analise:
1. Estrutura geral
2. Consistência doc/código
3. Problemas
4. Sugestões
Baseie-se APENAS no que leu." \
CLAUDE.md ARCHITECTURE.md README.md
使用示例
查看来源仓库中的使用示例与配置说明。
查看来源 ↗来源历史
- 收录时间
- 2026-01-20
- 索引更新时间
- 2026-01-26
- Branch
- main
收录与同步日期属于本站记录。源码修改历史请查看来源仓库。
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!