gemini

Gemini 技能指南

何时使用 Gemini

• 当被要求激活时
• 代码审查：跨多个文件的全面代码审查
• 方案审查：分析架构方案、技术规格或项目路线图
• 大上下文处理：需要超过 200k tokens 上下文的任务（完整代码库、文档集）
• 多文件分析：理解众多文件之间的关系和模式

⚠️ 关键：后台/非交互模式警告

绝不要在后台或非交互式 shell 中使用 --approval-mode default（如 Claude Code 工具调用）。它会无限期挂起，等待无法提供的批准提示。

对于自动化/后台审查：

• ✅ 使用 --approval-mode yolo 进行全自动执行
• ✅ 或用超时包装：timeout 300 gemini ...
• ❌ 绝不要在非交互式终端中使用 --approval-mode default

Gemini 挂起的症状：

• 进程运行 20+ 分钟且 CPU 使用率为 0%
• 无网络活动
• 进程状态显示为 'S'（休眠）

修复挂起的进程：

# Check if hung
ps aux | grep gemini | grep -v grep

# Kill if necessary
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 <MODEL> - 模型选择
   • --approval-mode <default|auto_edit|yolo> - 控制工具批准
   • -y, --yolo - --approval-mode yolo 的替代写法
   • -i, --prompt-interactive "prompt" - 执行提示并继续交互
   • --include-directories <DIR> - 要包含到工作区的额外目录
   • -s, --sandbox - 在沙箱模式下运行以实现隔离

4. 对于后台/自动化任务，始终使用 --approval-mode yolo 或添加超时包装。绝不要在非交互式 shell 中使用 default。

5. 运行命令并捕获输出。对于后台/自动化模式：

   # Recommended: Use yolo for background tasks
   gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase for security issues"
   
   # Or with timeout (5 min limit)
   timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "Review this codebase"
   

6. 对于带初始提示的交互式会话：

   gemini -m gemini-3-pro-preview -i "Review the authentication system" --approval-mode auto_edit
   

7. Gemini 完成后，告知用户："Gemini 分析已完成。你可以启动新的 Gemini 会话进行后续分析，或继续探索这些发现。"

快速参考

使用场景	批准模式	关键标志
后台代码审查	yolo ✅	-m gemini-3-pro-preview --approval-mode yolo
后台分析	yolo ✅	-m gemini-3-pro-preview --approval-mode yolo
带超时的后台	yolo ✅	timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo
交互式代码审查	default	-m gemini-3-pro-preview --approval-mode default（仅限交互式终端）
带自动编辑的代码审查	auto_edit	-m gemini-3-pro-preview --approval-mode auto_edit
自动化重构	yolo	-m gemini-3-pro-preview --approval-mode yolo
速度关键型后台	yolo ✅	-m gemini-3-flash --approval-mode yolo
成本优化后台	yolo ✅	-m gemini-2.5-flash --approval-mode yolo
多目录分析	yolo（如果是后台）	--include-directories <DIR1> --include-directories <DIR2>
带提示的交互式	auto_edit 或 default	-i "prompt" --approval-mode <mode>

模型选择指南

模型	最适合	上下文窗口	关键特性
gemini-3-pro-preview ⭐	旗舰模型：复杂推理、编码、Agent 任务	1M 输入 / 64k 输出	Vibe coding、76.2% SWE-bench、$2-4/M 输入
gemini-3-flash	亚秒级延迟、对速度要求极高的应用	1M 输入 / 64k 输出	从 3 Pro 蒸馏、TPU 优化
gemini-2.5-pro	旧版：全面的强劲性能	1M 输入 / 65k 输出	思考模式、成熟稳定
gemini-2.5-flash	旧版：高性价比、大批量任务	1M 输入 / 65k 输出	最优价格（$0.15/M）、思考模式
gemini-2.5-flash-lite	旧版：最快处理、高吞吐量	1M 输入 / 65k 输出	最高速度、最低延迟

Gemini 3 优势：软件工程准确率提升 35%，在 SWE-bench（76.2%）、GPQA Diamond（91.9%）和 WebDev Arena（1487 Elo）上达到业界领先水平。知识截止时间：2025 年 1 月。

即将推出：gemini-3-deep-think，具备增强思考能力，适用于超复杂推理。

常见用例

代码审查（后台/自动化）

# For background execution (Claude Code, CI/CD, etc.)
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"

# With timeout safety (5 minutes)
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo \
  "Perform a comprehensive code review..."

方案审查（后台/自动化）

# For background execution
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"

大上下文分析（后台/自动化）

# For background execution
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"

交互式代码审查（仅限终端）

# ONLY use default mode in interactive terminal
gemini -m gemini-3-pro-preview --approval-mode default \
  "Review the authentication flow for security issues"

后续跟进

• Gemini CLI 会话通常是一次性或交互式的。与 Codex 不同，它没有内置的恢复功能。
• 如需后续分析，请基于之前的发现启动一个新的 Gemini 会话。
• 在提出后续操作建议时，请重申所选的模型和审批模式。
• 在每个 Gemini 命令之后使用 AskUserQuestion 来确认下一步操作或收集澄清信息。

错误处理

• 当 gemini --version 或任何 Gemini 命令以非零状态退出时，停止并报告失败。
• 在重试失败的命令之前，先询问方向。
• 在使用高影响标志（--approval-mode yolo、-y、--sandbox）之前，除非已获授权，否则使用 AskUserQuestion 向用户请求许可。
• 当输出包含警告或部分结果时，请进行总结，并使用 AskUserQuestion 询问如何调整。

排查 Gemini 进程卡死

检测

# Check for hung processes
ps aux | grep -E "gemini.*gemini-3" | grep -v grep

# Look for these symptoms:
# - Process running 20+ minutes
# - CPU usage at 0%
# - Process state 'S' (sleeping)
# - No network connections

诊断

# Get detailed process info
ps -o pid,etime,pcpu,stat,command -p <PID>

# Check network activity
lsof -p <PID> 2>/dev/null | grep -E "(TCP|ESTABLISHED)" | wc -l
# If result is 0, process is hung

解决

# Kill hung Gemini processes
pkill -9 -f "gemini.*gemini-3-pro-preview"

# Or kill specific PID
kill -9 <PID>

# Verify cleanup
ps aux | grep gemini | grep -v grep

预防

• 后台/自动化任务务必使用 --approval-mode yolo
• 为安全起见添加超时包装：timeout 300 gemini ...
• 切勿在非交互式 shell 中使用 --approval-mode default
• 用 ps 监控首次运行，确保进程完成

大上下文处理技巧

1. 明确具体：为要分析的内容提供清晰、结构化的提示词
2. 使用 include-directories：显式指定所有相关目录
3. 选择正确的模型：
   • 复杂推理、编码任务和最高分析质量请使用 gemini-3-pro-preview（推荐的默认选择）
   • 需要亚秒级响应时间、对速度要求极高的任务请使用 gemini-3-flash
   • 成本优化的高批量处理请使用 gemini-2.5-flash
4. 发挥 Gemini 3 的优势：软件工程任务表现提升 35%，在 Agent 工作流和 vibe coding 方面表现卓越
5. 分解复杂任务：即使上下文很大，结构化分析也更有效
6. 保存发现：请 Gemini 输出可保存以备参考的结构化报告

CLI 版本

需要 Gemini CLI v0.16.0 或更高版本以支持 Gemini 3 模型。检查版本：gemini --version