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'（睡眠）

修复挂起的进程：

# 检查是否挂起
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 或添加超时包装。切勿在非交互式 shell 中使用 default。

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

# 推荐：后台任务使用 yolo
gemini -m gemini-3-pro-preview --approval-mode yolo "审查此代码库的安全问题"

# 或带超时（5 分钟限制）
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "审查此代码库"

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

gemini -m gemini-3-pro-preview -i "审查认证系统" --approval-mode auto_edit

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` ⭐	旗舰模型：复杂推理、编码、代理任务	1M 输入 / 64k 输出	Vibe 编码，SWE-bench 76.2%，$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，用于超复杂推理，具备增强的思考能力。

常见用例

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

# 后台执行（Claude Code、CI/CD 等）
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "执行全面代码审查，重点关注：
   1. 安全漏洞
   2. 性能问题
   3. 代码质量和可维护性
   4. 最佳实践违规"

# 带超时安全（5 分钟）
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo \
  "执行全面代码审查..."

计划审查（后台/自动化）

# 后台执行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "审查此架构计划：
   1. 可扩展性问题
   2. 缺失组件
   3. 集成挑战
   4. 替代方案"

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

# 后台执行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "分析整个代码库以了解：
   1. 整体架构
   2. 关键模式和约定
   3. 潜在技术债务
   4. 重构机会"

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

# 仅在交互式终端中使用 default 模式
gemini -m gemini-3-pro-preview --approval-mode default \
  "审查认证流程的安全问题"

后续跟进

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

错误处理

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

排查挂起的 Gemini 进程

检测

# 检查挂起的进程
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，则进程已挂起

解决

# 终止挂起的 Gemini 进程
pkill -9 -f "gemini.*gemini-3-pro-preview"

# 或终止特定 PID
kill -9 <PID>

# 验证清理
ps aux | grep gemini | grep -v grep

预防

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

大上下文处理技巧

具体明确：提供清晰、结构化的提示，说明要分析的内容
使用 include-directories：明确指定所有相关目录
选择合适的模型：
- 使用 gemini-3-pro-preview 进行复杂推理、编码任务和最高分析质量（推荐默认）
- 使用 gemini-3-flash 进行需要亚秒级响应时间的速度关键型任务
- 使用 gemini-2.5-flash 进行成本优化的高容量处理
利用 Gemini 3 的优势：软件工程任务提升 35%，在代理工作流和 vibe 编码方面表现出色
分解复杂任务：即使有大上下文，结构化分析也更有效
保存发现：要求 Gemini 输出结构化报告，以便保存供参考

CLI 版本

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

你可能还喜欢

ponytail-gain

85Kprompting-reasoning

Show ponytail's measured impact as a compact scoreboard: less code, less cost, more speed, from the benchmark medians. One-shot display, not a persistent mode, and not a per-repo number. Trigger: /ponytail-gain, "ponytail gain", "what does ponytail save", "show ponytail impact", "ponytail scoreboard".

dietrichgebert

获取

evaluation-methodology

38Kprompting-reasoning

PluginEval quality methodology — dimensions, rubrics, statistical methods, and scoring formulas. Use this skill when understanding how plugin quality is measured, when interpreting a low score on a specific dimension, when deciding how to improve a skill's triggering accuracy or orchestration fitness, when calibrating scoring thresholds for your marketplace, or when explaining quality badges to external partners like Neon.

wshobson

获取

cavecrew

75Kprompting-reasoning

将任务委托给穴居人风格子代理的决策指南。告诉主线程何时生成 `cavecrew-investigator`（定位代码）、`cavecrew-builder`（1-2 文件编辑）或 `cavecrew-reviewer`（差异审查），而不是内联执行或使用普通的 `Explore`。子代理输出经过穴居人压缩，因此注入回主上下文的工具结果约小 60%——在长时间会话中，主上下文能维持更久。触发词：“委托给子代理”、“使用 cavecrew”、“生成 investigator/builder/reviewer”、“节省上下文”、“压缩代理输出”。

juliusbrussee

获取

继续探索

浏览 prompting-reasoning 热门 Skills 最近更新