gemini

# Gemini 技能指南 ## 何时使用 Gemini - 当被要求激活时 - **代码审查**：跨多个文件的全面代码审查 - **计划审查**：分析架构计划、技术规范或项目路线图 - **大数据量上下文处理**：需要 >200k token 上下文的任务（整个代码库、文档集） - **多文件分析**：理解跨多个文件的关系和模式 ## ⚠️ 关键：后台/非交互模式警告 **严禁**在后台或非交互式 Shell（如 Claude Code 工具调用）中使用 `--approval-mode default`。它会因为等待无法提供的批准提示而无限挂起。 **对于自动化/后台审查：** - ✅ 使用 `--approval-mode yolo` 进行全自动执行 - ✅ 或者使用超时包装：`timeout 300 gemini ...` - ❌ 严禁在没有交互式终端的情况下使用 `--approval-mode default` **Gemini 挂起的症状：** - 进程运行 20 分钟以上，CPU 使用率为 0% - 无网络活动 - 进程状态显示为 'S' (睡眠) **修复挂起的进程：** bash # 检查是否挂起 ps aux | grep gemini | grep -v grep # 必要时杀死进程 pkill -9 -f "gemini.*gemini-3-pro-preview" ## 运行任务 1. 在**单个提示词**中询问用户（通过 `AskUserQuestion`）使用哪个模型。可用模型： - `gemini-3-pro-preview` ⭐（旗舰模型，最适合编码和复杂推理，软件工程能力比 2.5 Pro 强 35%） - `gemini-3-flash`（亚秒级延迟，由 3 Pro 蒸馏而来，最适合速度敏感型任务） - `gemini-2.5-pro`（旧版选项，强大的综合性能） - `gemini-2.5-flash`（旧版选项，具有思考能力的成本效益型模型） - `gemini-2.5-flash-lite`（旧版选项，处理速度最快） 2. 根据任务选择批准模式： - `default`：提示批准（⚠️ 仅限交互式终端会话） - `auto_edit`：仅自动批准编辑工具（用于带有建议的代码审查） - `yolo`：自动批准所有工具（✅ 后台/自动化任务必需） 3. 使用适当的选项组装命令： - `-m, --model ` - 模型选择 - `--approval-mode ` - 控制工具批准 - `-y, --yolo` - `--approval-mode yolo` 的替代方案 - `-i, --prompt-interactive "prompt"` - 执行提示词并继续交互 - `--include-directories ` - 工作区中包含的额外目录 - `-s, --sandbox` - 在沙盒模式下运行以实现隔离