gemini-cli
Gemini CLI集成,用于上下文卸载。在调用gemini CLI、委托大文件分析、总结代码或需要第二意见时使用。涵盖正确语法、标志、环境变量和常见错误。关键词:gemini、上下文卸载、大文件、总结、第二意见、gemini-assistant、gemini CLI。
📖 中文导读:Gemini CLI集成,用于上下文卸载。在调用gemini CLI、委托大文件分析、总结代码或需要第二意见时使用。涵盖正确语法、标志、环境变量和常见错误。关键词:gemini、上下文卸载、大文件、总结、第二意见、gemini-assistant、gemini CLI。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: gemini-cli description: 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.
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