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