gemini-cli

Gemini CLI 集成技能

此技能可帮助 Claude Code 高效编排 Gemini CLI（v0.16.0+）与 Gemini 3 Pro，用于代码生成、审查、分析和专用任务。

何时使用此技能

理想用例

1. 第二意见／交叉验证

   • 编写代码后进行代码审查（获取不同的 AI 视角）
   • 通过替代分析进行安全审计
   • 查找 Claude 可能遗漏的错误

2. Google 搜索检索

   • 需要获取当前互联网信息的问题
   • 最新的库版本、API 变更、文档更新
   • 当前事件或近期发布内容

3. 代码库架构分析

   • 使用 Gemini 的 codebase_investigator 工具
   • 理解不熟悉的代码库
   • 梳理跨文件依赖关系

4. 并行处理

   • 委派任务的同时继续其他工作
   • 同时运行多个代码生成任务
   • 在后台生成文档

5. 专用生成

   • 生成测试套件
   • 生成 JSDoc／文档
   • 在不同语言之间转换代码

何时不使用

• 简单、快速的任务（开销不值得）
• 需要立即响应的任务（速率限制会造成延迟）
• 上下文已加载且理解清楚时
• 需要通过对话进行交互式优化时

核心说明

1. 验证安装

command -v gemini || which gemini

2. 基本命令模式

gemini "[prompt]" --yolo -o text 2>&1

重要标志：

• --yolo 或 -y：自动批准所有工具调用
• -o text：输出便于人类阅读的内容
• -o json：输出包含统计数据的结构化内容
• -m gemini-2.5-flash：简单任务使用更快的模型

3. 重要行为说明

YOLO 模式行为：自动批准工具调用，但不会阻止规划提示。Gemini 仍可能展示计划并询问“这个计划看起来不错吗？”。请使用明确的措辞：

• “立即应用”
• “立即开始”
• “无需确认即可执行”

速率限制：免费版每分钟有 60 次请求、每天有 1000 次请求。CLI 会自动退避重试。请预期会看到类似“配额将在 X 秒后重置”的消息。

4. 输出处理

对于 JSON 输出（-o json），解析：

{
  "response": "actual content",
  "stats": {
    "models": { "tokens": {...} },
    "tools": { "byName": {...} }
  }
}

快速参考命令

代码生成

gemini "Create [description] with [features]. Output complete file content." --yolo -o text

代码审查

gemini "Review [file] for: 1) features, 2) bugs/security issues, 3) improvements" -o text

修复错误

gemini "Fix these bugs in [file]: [list]. Apply fixes now." --yolo -o text

生成测试

gemini "Generate [Jest/pytest] tests for [file]. Focus on [areas]." --yolo -o text

文档

gemini "Generate JSDoc for all functions in [file]. Output as markdown." --yolo -o text

架构分析

gemini "Use codebase_investigator to analyze this project" -o text

网络调研

gemini "What are the latest [topic]? Use Google Search." -o text

更快的模型（简单任务）

gemini "[prompt]" -m gemini-2.5-flash -o text

错误处理

超出速率限制

• CLI 会自动退避重试
• 优先级较低的任务使用 -m gemini-2.5-flash
• 长时间运行的操作可在后台执行

命令失败

• 检查 JSON 输出中的详细错误统计信息
• 验证 Gemini 已通过身份验证：gemini --version
• 检查 ~/.gemini/settings.json 是否存在配置问题

生成后的验证

始终验证 Gemini 的输出：

• 检查是否存在安全漏洞（XSS、注入）
• 测试功能是否符合要求
• 检查代码风格是否一致
• 验证依赖项是否适用

集成工作流

标准的生成－审查－修复循环

# 1. Generate
gemini "Create [code]" --yolo -o text

# 2. Review (Gemini reviews its own work)
gemini "Review [file] for bugs and security issues" -o text

# 3. Fix identified issues
gemini "Fix [issues] in [file]. Apply now." --yolo -o text

后台执行

对于耗时较长的任务，请在后台运行并监控：

gemini "[long task]" --yolo -o text 2>&1 &
# Monitor with BashOutput tool

Gemini 的独特能力

这些工具仅可通过 Gemini 使用：

1. google_web_search - 通过 Google 实时搜索互联网
2. codebase_investigator - 深入分析架构
3. save_memory - 跨会话持久记忆

配置

项目上下文（可选）

在项目根目录中创建 .gemini/GEMINI.md，提供 Gemini 会自动读取的持久上下文。

会话管理

列出会话：gemini --list-sessions
恢复会话：echo "follow-up" | gemini -r [index] -o text

另请参阅

• reference.md - 完整的命令和标志参考
• templates.md - 常见操作的提示词模板
• patterns.md - 高级集成模式
• tools.md - Gemini 内置工具文档