Gemini 技能指南：代码审查与自动化分析工具使用教程

gemini by davila7/claude-code-templates

222 周安装量

23,400 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/davila7/claude-code-templates --skill gemini

AI/机器学习开发自动化

🇨🇳中文介绍

Gemini 技能指南

何时使用 Gemini

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

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

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

对于自动化/后台审查：

✅ 使用 --approval-mode yolo 进行完全自动化执行
✅ 或者使用超时包装：timeout 300 gemini ...
❌ 切勿在非交互式终端中使用 --approval-mode default

Gemini 挂起的症状：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

794,900 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

265,000 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

213,800 周安装

进程运行 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 "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` ✅	`-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 编码，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 \
  "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"

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

# 仅在交互式终端中使用 default 模式
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 进程挂起问题

# 检查挂起的进程
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 输出结构化报告，以便保存供参考

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

2026 年 1 月 25 日

🇺🇸English

Gemini Skill Guide

When to Use Gemini

WHEN ASKED TO BE ACTIVATED
Code Review : Comprehensive code reviews across multiple files
Plan Review : Analyzing architectural plans, technical specifications, or project roadmaps
Big Context Processing : Tasks requiring >200k tokens of context (entire codebases, documentation sets)
Multi-file Analysis : Understanding relationships and patterns across many files

⚠️ Critical: Background/Non-Interactive Mode Warning

NEVER use--approval-mode default in background or non-interactive shells (like Claude Code tool calls). It will hang indefinitely waiting for approval prompts that cannot be provided.

For automated/background reviews:

✅ Use --approval-mode yolo for fully automated execution
✅ OR wrap with timeout: timeout 300 gemini ...
❌ NEVER use --approval-mode default without interactive terminal

Symptoms of hung Gemini:

Process running 20+ minutes with 0% CPU usage
No network activity
Process state shows 'S' (sleeping)

Fix hung process:

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

# Kill if necessary
pkill -9 -f "gemini.*gemini-3-pro-preview"

Running a Task

Ask the user (via AskUserQuestion) which model to use in a single prompt. Available models:
- gemini-3-pro-preview ⭐ (flagship model, best for coding & complex reasoning, 35% better at software engineering than 2.5 Pro)
- gemini-3-flash (sub-second latency, distilled from 3 Pro, best for speed-critical tasks)
- gemini-2.5-pro (legacy option, strong all-around performance)
- gemini-2.5-flash (legacy option, cost-efficient with thinking capabilities)
- gemini-2.5-flash-lite (legacy option, fastest processing)
Select the approval mode based on the task:
- default: Prompt for approval (⚠️ ONLY for interactive terminal sessions)

Quick Reference

Use case	Approval mode	Key flags
Background code review	`yolo` ✅	`-m gemini-3-pro-preview --approval-mode yolo`
Background analysis	`yolo` ✅	`-m gemini-3-pro-preview --approval-mode yolo`
Background with timeout	`yolo` ✅	`timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo`

Model Selection Guide

Model	Best for	Context window	Key features
`gemini-3-pro-preview` ⭐	Flagship model : Complex reasoning, coding, agentic tasks	1M input / 64k output	Vibe coding, 76.2% SWE-bench, $2-4/M input
`gemini-3-flash`	Sub-second latency, speed-critical applications	1M input / 64k output	Distilled from 3 Pro, TPU-optimized
`gemini-2.5-pro`	Legacy: Strong all-around performance	1M input / 65k output	Thinking mode, mature stability
`gemini-2.5-flash`

Gemini 3 Advantages : 35% higher accuracy in software engineering, state-of-the-art on SWE-bench (76.2%), GPQA Diamond (91.9%), and WebDev Arena (1487 Elo). Knowledge cutoff: January 2025.

Coming Soon : gemini-3-deep-think for ultra-complex reasoning with enhanced thinking capabilities.

Common Use Cases

Code Review (Background/Automated)

# 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..."

Plan Review (Background/Automated)

# 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"

Big Context Analysis (Background/Automated)

# 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"

Interactive Code Review (Terminal Only)

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

Following Up

Gemini CLI sessions are typically one-shot or interactive. Unlike Codex, there's no built-in resume functionality.
For follow-up analysis, start a new Gemini session with context from previous findings.
When proposing follow-up actions, restate the chosen model and approval mode.
Use AskUserQuestion after each Gemini command to confirm next steps or gather clarifications.

Error Handling

Stop and report failures whenever gemini --version or a Gemini command exits non-zero.
Request direction before retrying failed commands.
Before using high-impact flags (--approval-mode yolo, -y, --sandbox), ask the user for permission using AskUserQuestion unless already granted.
When output includes warnings or partial results, summarize them and ask how to adjust using AskUserQuestion.

Troubleshooting Hung Gemini Processes

Detection

# 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

Diagnosis

# 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

Resolution

# 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

Prevention

ALWAYS use--approval-mode yolo for background/automated tasks
Add timeout wrapper for safety: timeout 300 gemini ...
Never use --approval-mode default in non-interactive shells
Monitor first run with ps to ensure process completes

Tips for Large Context Processing

Be specific : Provide clear, structured prompts for what to analyze
Use include-directories : Explicitly specify all relevant directories
Choose the right model :
- Use gemini-3-pro-preview for complex reasoning, coding tasks, and maximum analysis quality (recommended default)
- Use gemini-3-flash for speed-critical tasks requiring sub-second response times
- Use gemini-2.5-flash for cost-optimized high-volume processing
Leverage Gemini 3's strengths : 35% better at software engineering tasks, exceptional at agentic workflows and vibe coding
Break down complex tasks : Even with large context, structured analysis is more effective
Save findings : Ask Gemini to output structured reports that can be saved for reference

CLI Version

Requires Gemini CLI v0.16.0 or later for Gemini 3 model support. Check version: gemini --version

Weekly Installs

205

Repository

davila7/claude-…emplates

GitHub Stars

22.6K

First Seen

Jan 25, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

opencode174

gemini-cli167

codex160

claude-code155

github-copilot142

cursor139

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

144,300 周安装

auto_edit: Auto-approve edit tools only (for code reviews with suggestions)

yolo: Auto-approve all tools (✅ REQUIRED for background/automated tasks)

Assemble the command with appropriate options:

-m, --model <MODEL> - Model selection
--approval-mode <default|auto_edit|yolo> - Control tool approval
-y, --yolo - Alternative to --approval-mode yolo
-i, --prompt-interactive "prompt" - Execute prompt and continue interactively
--include-directories <DIR> - Additional directories to include in workspace
-s, --sandbox - Run in sandbox mode for isolation

For background/automated tasks, ALWAYS use--approval-mode yolo or add timeout wrapper. NEVER use default in non-interactive shells.

Run the command and capture the output. For background/automated mode:

# 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"

For interactive sessions with an initial prompt:

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

After Gemini completes , inform the user: "The Gemini analysis is complete. You can start a new Gemini session for follow-up analysis or continue exploring the findings."