gemini-review 是一个基于 Google Gemini CLI 的代码审查技能,使用 Gemini 2.5 Pro 模型,具备 100 万 token 上下文窗口,可一次性分析整个仓库,适合大型代码库的审查场景。
主要能力:
- 使用 Gemini 2.5 Pro 进行代码审查,支持 1M token 上下文,无需分块即可容纳整个仓库。
- 通过 Code Review 扩展提供交互式审查,分析当前分支的代码变更、识别质量问题并给出修复建议。
- 支持无头模式(headless)自动化,可输出 JSON 或 stream-json,并可指定模型。
- 支持 GitHub 集成,包括 Gemini Code Assist 应用(PR 打开时自动审查,支持 /gemini review、/gemini summary、/gemini help 命令)以及自定义 GitHub Action 和官方 Google GitHub Action。
- 支持 GitLab CI/CD 集成。
- 提供 session 追踪,可用 --session-summary 记录 token 用量和成本。
- 支持全局配置(~/.gemini/settings.json)和项目配置(GEMINI.md),可定义技术栈、审查关注点和代码约定。
使用方式:
- 前置要求:Node.js 20+。可通过 npm install -g @google/gemini-cli、brew install gemini-cli 或 npx @google/gemini-cli 安装。
- 安装扩展:gemini extensions install https://github.com/gemini-cli-extensions/code-review,用 gemini extensions list 验证。
- 认证:方式一为 Google 账号登录(免费层每天 1000 次请求、每分钟 60 次);方式二为设置 GEMINI_API_KEY 环境变量(免费层每天 100 次请求);方式三为 Vertex AI 企业方案,需设置 GOOGLE_API_KEY、GOOGLE_GENAI_USE_VERTEXAI=true、GOOGLE_CLOUD_PROJECT。
- 交互式审查:运行 gemini 后执行 /code-review,或输入自然语言提示要求审查指定文件或提交。
- 无头模式:gemini -p "提示内容",可加 --output-format json、--output-format stream-json、-m gemini-2.5-pro 等参数。
- GitHub Action 示例与 GitLab CI 示例代码均在资料中提供。
适用场景:
- 快速在流程内进行代码审查。
- 大型代码库(100+ 文件)的审查。
- 需要免费自动化审查的场景。
- 在 CI/CD 中自动审查 PR 或合并请求。
限制与注意事项:
- 即使 1M token 上下文对于超大 monorepo 仍有上限。
- 应使用 secrets 管理密钥,避免在日志中暴露 API key。
- 建议仅在 PR 上运行以节省配额。
- 需要设置项目上下文(GEMINI.md)以获得更好审查效果。
- 资料中未提供具体定价、效果保证或与其他工具的详细对比结论。
- 使用前必须先配置认证,否则 CI/CD 无法运行。