自动化与脚本
需要 Gemini CLI 做代码审查…
当用户要求运行 Gemini CLI 进行代码审查、计划/架构评审、>200k tokens 大上下文或多文件分析时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要 Gemini CLI 做代码审查、特定
解决思路
- 在后台或非交互 shell(如 Claude Code 工具调用)中,绝不要使用 `--approval-mode default`,因为它会一直等待无法提供的审批提示而挂起。
- 对自动化/后台审查,使用 `--approval-mode yolo` 进行全自动执行。
- 或用 timeout 包裹命令:`timeout 300 gemini ...`。
- 仅在交互式终端中使用 `--approval-mode default`;不要在非交互 shell 中使用。
- 识别 Gemini 挂起症状:进程运行 20+ 分钟、CPU 使用率 0%、无网络活动、进程状态为 'S'(sleeping)。
- 修复挂起进程:检查 `ps aux | grep gemini | grep -v grep`。
- 必要时杀掉挂起进程:`pkill -9 -f "gemini.*gemini-3-pro-preview"`。
- 运行任务前,通过 `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`(旧版,最快处理)。
- 根据任务选择审批模式:`default` 提示审批(⚠️ 仅用于交互式终端会话);`auto_edit` 仅自动批准编辑工具(用于带建议的代码审查);`yolo` 自动批准所有工具(✅ 后台/自动化任务必需)。
- 用适当选项组装命令:`-m, --model <MODEL>` 选择模型;`--approval-mode <default|auto_edit|yolo>` 控制工具审批;`-y, --yolo` 作为 `--approval-mode yolo` 的替代;`-i, --prompt-interactive "prompt"` 执行提示并继续保持交互;`--include-directories <DIR>` 添加要包含到工作区的目录;`-s, --sandbox` 以沙箱模式运行以隔离。
- 对后台/自动化任务,始终使用 `--approval-mode yolo` 或添加 timeout wrapper;绝不要在非交互 shell 中使用 `default`。
- 运行命令并捕获输出。后台/自动化模式推荐示例:`gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase for security issues"`。
- 后台/自动化模式也可加超时(5 分钟限制):`timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase"`。
- 交互式会话带初始提示示例:`gemini -m gemini-3-pro-preview -i "Review the authentication system" --approval-mode auto_edit`。
- Gemini 完成后,告知用户:Gemini 分析已完成。你可以启动新的 Gemini 会话进行后续分析,或继续探索发现。
- 快速参考:后台代码审查用 `yolo` ✅,关键 flags 为 `-m gemini-3-pro-preview --approval-mode yolo`。
- 快速参考:后台分析用 `yolo` ✅,关键 flags 为 `-m gemini-3-pro-preview --approval-mode yolo`。
- 快速参考:后台带超时用 `yolo` ✅,关键 flags 为 `timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo`。
- 快速参考:交互式代码审查用 `default`,关键 flags 为 `-m gemini-3-pro-preview --approval-mode default`(仅交互式终端)。
- 快速参考:带自动编辑的代码审查用 `auto_edit`,关键 flags 为 `-m gemini-3-pro-preview --approval-mode auto_edit`。
- 快速参考:自动化重构用 `yolo`,关键 flags 为 `-m gemini-3-pro-preview --approval-mode yolo`。
- 快速参考:速度关键后台用 `yolo` ✅,关键 flags 为 `-m gemini-3-flash --approval-mode yolo`。
- 快速参考:成本优化后台用 `yolo` ✅,关键 flags 为 `-m gemini-2.5-flash --approval-mode yolo`。
- 快速参考:多目录分析(若后台)用 `yolo`,关键 flags 为 `--include-directories <DIR1> --include-directories <DIR2>`。
- 快速参考:交互式带 prompt 用 `auto_edit` 或 `default`,关键 flags 为 `-i "prompt" --approval-mode <mode>`。
- 模型选择指南:`gemini-3-pro-preview` ⭐ 最适合旗舰模型、复杂推理、编码、agentic 任务;上下文窗口 1M input / 64k output;关键特性 Vibe coding、76.2% SWE-bench、$2-4/M input。
- 模型选择指南:`gemini-3-flash` 最适合亚秒级延迟、速度关键应用;1M input / 64k output;从 3 Pro 蒸馏,TPU 优化。
- 模型选择指南:`gemini-2.5-pro` 旧版,强全能性能;1M input / 65k output;思考模式,成熟稳定。
- 模型选择指南:`gemini-2.5-flash` 旧版,成本高效、高容量任务;1M input / 65k output;最佳价格($0.15/M),思考模式。
- 模型选择指南:`gemini-2.5-flash-lite` 旧版,最快处理、高吞吐;1M input / 65k output;最大速度,最小延迟。
- 利用 Gemini 3 优势:软件工程准确率高 35%,在 SWE-bench(76.2%)、GPQA Diamond(91.9%)、WebDev Arena(1487 Elo)达到最先进水平;知识截止 2025 年 1 月;即将推出 `gemini-3-deep-think` 用于超复杂推理。
- 常见用例:后台/自动化代码审查执行 `gemini -m gemini-3-pro-preview --approval-mode yolo "Perform a comprehensive code review focusing on: 1. Security vulnerabilities 2. Performance issues 3. Code quality and maintainability 4. Best practices violations"`。
- 常见用例:后台/自动化代码审查加 5 分钟超时安全执行:`timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "Perform a comprehensive code review..."`。
- 常见用例:后台/自动化计划评审执行 `gemini -m gemini-3-pro-preview --approval-mode yolo "Review this architectural plan for: 1. Scalability concerns 2. Missing components 3. Integration challenges 4. Alternative approaches"`。
- 常见用例:后台/自动化大上下文分析执行 `gemini -m gemini-3-pro-preview --approval-mode yolo "Analyze the entire codebase to understand: 1. Overall architecture 2. Key patterns and conventions 3. Potential technical debt 4. Refactoring opportunities"`。
- 常见用例:交互式代码审查(仅终端)执行 `gemini -m gemini-3-pro-preview --approval-mode default "Review the authentication flow for security issues"`。
- 后续跟进:Gemini CLI 会话通常是一次性或交互式;与 Codex 不同,没有内置 resume 功能。
- 后续分析:启动新的 Gemini 会话,并带上之前发现的上下文。
- 提出后续动作时,重申所选择的模型和审批模式。
- 每次 Gemini 命令后使用 `AskUserQuestion` 确认下一步或收集澄清。
- 错误处理:每当 `gemini --version` 或 Gemini 命令以非零退出时,停止并报告失败。
- 错误处理:重试失败命令前,先请求方向。
- 错误处理:使用高影响 flags(`--approval-mode yolo`、`-y`、`--sandbox`)前,除非已授权,先用 `AskUserQuestion` 请求用户许可。
- 错误处理:当输出包含警告或部分结果时,总结它们并用 `AskUserQuestion` 询问如何调整。
- 排查挂起:检测命令 `ps aux | grep -E "gemini.*gemini-3" | grep -v grep`;注意 20+ 分钟、CPU 0%、状态 'S'、无网络连接等症状。
- 排查挂起:诊断命令 `ps -o pid,etime,pcpu,stat,command -p <PID>`。
- 排查挂起:检查网络活动 `lsof -p <PID> 2>/dev/null | grep -E "(TCP|ESTABLISHED)" | wc -l`;如果结果为 0,进程挂起。
- 排查挂起:解决命令 `pkill -9 -f "gemini.*gemini-3-pro-preview"`。
- 排查挂起:或杀特定 PID:`kill -9 <PID>`。
- 排查挂起:验证清理:`ps aux | grep gemini | grep -v grep`。
- 预防挂起:后台/自动化任务始终使用 `--approval-mode yolo`。
- 预防挂起:加 timeout wrapper 保证安全:`timeout 300 gemini ...`。
- 预防挂起:绝不在非交互 shell 中使用 `--approval-mode default`。
- 预防挂起:用 `ps` 监控首次运行以确保进程完成。
- 大上下文处理技巧:具体——提供清晰、结构化提示说明要分析什么。
- 大上下文处理技巧:使用 include-directories——显式指定所有相关目录。
- 大上下文处理技巧:选择合适模型——复杂推理、编码任务和最高分析质量用 `gemini-3-pro-preview`(推荐默认);速度关键且需亚秒响应时间用 `gemini-3-flash`;成本优化高容量处理用 `gemini-2.5-flash`。
- 大上下文处理技巧:利用 Gemini 3 优势——软件工程任务好 35%,擅长 agentic 工作流和 vibe coding。
- 大上下文处理技巧:分解复杂任务——即使上下文很大,结构化分析也更有效。
- 大上下文处理技巧:保存发现——让 Gemini 输出结构化报告,以便保存供参考。
- CLI 版本:需要 Gemini CLI v0.16.0 或更高以支持 Gemini 3 模型;检查版本:`gemini --version`。
适用边界 · 注意事项
- 无法安装或授权 Gemini CLI、不能使用 Gemini 模型时,不适用。
- 需要交互式终端审批且不希望自动批准工具时,不要使用 `--approval-mode yolo`;此时应使用 `default`(仅交互式终端)。
- 任务不需要大上下文、多文件或复杂推理,或只需轻量快速处理时,不必使用 Gemini 3 Pro,可改用更快/更便宜的模型或不用 Gemini CLI。