⚡

GeminiCLI代码审查与分析技能Skill gemini

这个技能用于运行Gemini CLI工具，进行代码审查、计划审查和大上下文处理。它利用先进的AI模型（如Gemini 3 Pro）提供全面的分析能力，适用于软件开发、项目管理和数据处理任务。关键词：Gemini CLI, 代码审查, AI分析, 大模型处理, 自动化测试。

AI应用 0 次安装 0 次浏览 更新于 3/21/2026

名称: gemini 描述: 当用户要求运行Gemini CLI进行代码审查、计划审查或大上下文（>200k）处理时使用。适用于需要大上下文窗口的全面分析。默认使用Gemini 3 Pro，以实现最先进的推理和编码能力。

Gemini 技能指南

何时使用 Gemini

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

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

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

对于自动化/后台审查：

  • ✅ 使用 --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"

运行任务

  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. 运行命令并捕获输出。对于后台/自动化模式：

    # 推荐：对后台任务使用yolo
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"

  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 ⭐ 旗舰模型：复杂推理、编码、代理任务 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 用于具有增强思考能力的超复杂推理。

常见用例

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

# 对于后台执行（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 监控首次运行以确保进程完成

大上下文处理技巧

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

CLI 版本

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