SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

用途

该技能用于对给定的 GitHub 拉取请求执行代码审查,并自动在拉取请求上发布审查评论。

主要能力

  • 审查前进行资格检查:确认拉取请求是否已关闭、是否为草稿、是否无需审查(如自动生成的拉取请求或明显简单的改动),或是否已有来自本技能的早期审查。若不符合条件则终止。
  • 收集相关 AGENTS.md 文件路径:包括根目录及被修改文件所在目录中的 AGENTS.md 文件。
  • 获取拉取请求的变更摘要。
  • 启动 5 个并行 Sonnet 代理,分别从不同角度独立审查:
    1. 检查变更是否符合 AGENTS.md 的指导。
    2. 对变更文件进行浅层扫描,寻找明显缺陷(避免小问题和吹毛求疵)。
    3. 查看被修改代码的 git blame 和历史,结合历史上下文识别缺陷。
    4. 查看曾修改这些文件的过往拉取请求及其评论,检查是否有可适用于当前拉取请求的反馈。
    5. 查看被修改文件中的代码注释,确保变更符合注释中的指导。
  • 对每个发现的问题,启动并行的 Flash 子代理进行置信度评分(0-100),过滤掉低于 80 分的问题。
  • 在发布评论前再次进行资格检查。
  • 使用 gh 命令将审查结果作为评论发布到拉取请求。

使用方式

该技能通过自然语言指令驱动,内部使用多个子代理(Flash 和 Sonnet)并行执行任务。最终评论格式固定,包含问题列表(附链接和引用)或“未发现问题”的说明,并附带“🤖 Generated with Google Antigravity”标识及反馈表情符号。链接代码时必须使用完整的 git SHA,并遵循特定的链接格式(如 https://github.com/owner/repo/blob/<full-sha>/path#L10-L15),行范围格式为 L[start]-L[end],并提供前后各至少一行上下文。

适用场景

  • 团队希望自动化拉取请求的初步代码审查。
  • 需要从多个角度(规范、缺陷、历史、过往评论、代码注释)综合审查变更。
  • 希望仅关注高置信度问题,减少噪音。

限制

  • 不检查构建信号,不尝试构建或类型检查应用(这些由 CI 单独运行)。
  • 避免报告预先存在的问题、明显误报、吹毛求疵、linter/类型检查器/编译器可捕获的问题、一般代码质量问题(除非 AGENTS.md 明确要求)、已被代码中显式忽略注释静默的问题、可能是有意或与整体变更直接相关的功能变更,以及用户未修改行上的真实问题。
  • 必须使用 gh 与 GitHub 交互,而非网页抓取。
  • 评论需简洁,避免使用表情符号(但格式模板中的固定表情除外)。
  • 需要提供完整 git SHA 用于代码链接。