gemini

用途

本技能通过 Google Gemini CLI 补充第二意见、联网佐证（grounding）、广泛分析、验证、代码审查，或把任务委托给 Gemini 自主执行。当用户表达“使用……”一类意图时触发。

主要能力

联网佐证（grounding）：把代码与外部真实状态连接，可联网查当前文档、API、最佳实践、GitHub issue 等。
宽上下文分析：1M token 上下文，可处理整个代码库，而非片段。
研究导向：在回答前可查论文、库、模式。
与其他模型形成三角验证：思考方式不同于 Claude 与 Codex，可交叉印证结论。
任务类型对比：判断做法是否标准、库用法是否正确、生态现状、架构对照最佳实践等更适合 Gemini；实现功能、修 bug、找安全漏洞等 Codex 也可胜任。

使用方式

不强制指定模型

不要用 -m 强制模型。让自动模式负责路由——它会选择可用的最佳模型为主，并内置对暂时性 429 的回退。用 -m 强制模型会关闭该自动回退，遇到限流会硬失败。

正确 —— 自动路由带回退：

gemini -p "<PROMPT>" -y

错误 —— 关闭回退，会在 429 时失败：

gemini -m gemini-3.1-pro-preview -p "<PROMPT>" -y

三种模式

快速模式（Quick Mode）：简单问题、短答案，Claude 已有答案上下文只需第二意见。Bash 超时 120000ms。使用示例如：

OUTPUT_FILE="~/.claude/subagent-results/gemini-output-$(date +%s).md" ERROR_FILE="~/.claude/subagent-results/gemini-errors-$(date +%s).log" gemini
-p "<PROMPT>"
-o text -y \

"$OUTPUT_FILE" 2>"$ERROR_FILE" [ -s "$OUTPUT_FILE" ] || { echo "EMPTY OUTPUT — errors:"; cat "$ERROR_FILE"; }

分析模式（Analysis Mode）：Claude 整理上下文，Gemini 负责分析。当 Claude 已读过代码或文档、能给出聚焦简报、Gemini 不需要文件系统访问时使用。Bash 超时 300000ms。先写结构化提示文件，再用 stdin + 文件输出调用：

gemini
-p "Respond to the analysis request provided on stdin."
-o text -y
< "$PROMPT_FILE" \

"$OUTPUT_FILE" 2>"$ERROR_FILE"

提示模板包含 Goal、Context、What We Need、Grounding Request 四段。

委托模式（Delegated Mode）：Gemini 自主工作，需要探索代码库、分析文件、联网搜索或独立作业时使用，赋予其在项目目录内的完整工具访问。Bash 超时 600000ms；预计超过 10 分钟的任务，在 Bash 工具上使用 run_in_background: true 并稍后查看输出文件。多目录项目使用 --include-directories：

gemini
--include-directories /path/to/other/dir
-p "<PROMPT>"
-o text -y \

"$OUTPUT_FILE" 2>"$ERROR_FILE"

委托模式无输出约束，可读取整个代码库文件、联网搜当前文档与最佳实践、查 GitHub 相关 issue 或模式、核实依赖是否为最新且安全，并把分析落到实处。

模式选择

“向 gemini 问 X”且 Claude 已有上下文 → 分析模式。
“让 gemini 审查仓库” → 委托模式。
“向 gemini 快速提问” → 快速模式。
“让 gemini 就该架构给意见”且代码已探索 → 分析模式。
“让 gemini 探索并分析该项目” → 委托模式。
“用当前最佳实践佐证” → 委托模式。
“用 gemini 实现 X” → 委托模式。

输出与错误处理

始终把 stdout 重定向到文件；除快速模式外不要依赖内联捕获。每次调用后都要验证输出非空。若 Bash 工具超时，进程被杀、输出丢失；委托任务可改用 run_in_background: true 重跑。绝不用 2>/dev/null 抑制 stderr，始终重定向到带时间戳的错误文件。常见错误包括认证过期（交互式运行 gemini 重新认证）、模型不可用、限流。不要静默重试，先报告错误再带上下文重试。自动路由会处理 429，这也是不强制 -m 的原因。

上下文工程（仅分析模式）

架构用自己的话总结，不要粘贴 README；代码只给相关片段；依赖给名称与版本；问题编号且具体；告知 Gemini 需联网核对哪些当前状态。除非用户要求简短，不要人为限制输出长度。

推理与压缩韧性

Gemini 默认最大推理深度（thinkingLevel: HIGH），无需额外标志，不要降低思考等级。输出文件写入 ~/.claude/subagent-results/（持久，非 /tmp/）。上下文压缩后可重新用 Read 工具读取；若丢失路径，运行：ls -t ~/.claude/subagent-results/gemini-output-* | head -1

适用场景

grounding、广泛研究、架构验证、长上下文分析、生态检查。适合需要联网查证当前最佳实践与文档、核对依赖、在 1M token 上下文内分析大型代码库，或需要模型独立探索并形成意见的任务。

限制

认证使用 Google OAuth，需交互式运行 gemini 一次完成认证；Gemini 的 -p 标志会追加到 stdin，批量上下文用 stdin、指令用 -p。关于收费、价格、具体模型列表与平台支持范围，资料暂未提供。