SuperAPI AI 工具集

gemini-review

编程与开发

查看项目

更新于 10-15 11:58

技能介绍

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 无法运行。