用途
该技能用于对给定的 GitHub 拉取请求执行代码审查,并自动在拉取请求上发布审查评论。
主要能力
- 审查前进行资格检查:确认拉取请求是否已关闭、是否为草稿、是否无需审查(如自动生成的拉取请求或明显简单的改动),或是否已有来自本技能的早期审查。若不符合条件则终止。
- 收集相关 AGENTS.md 文件路径:包括根目录及被修改文件所在目录中的 AGENTS.md 文件。
- 获取拉取请求的变更摘要。
- 启动 5 个并行 Sonnet 代理,分别从不同角度独立审查:
- 检查变更是否符合 AGENTS.md 的指导。
- 对变更文件进行浅层扫描,寻找明显缺陷(避免小问题和吹毛求疵)。
- 查看被修改代码的 git blame 和历史,结合历史上下文识别缺陷。
- 查看曾修改这些文件的过往拉取请求及其评论,检查是否有可适用于当前拉取请求的反馈。
- 查看被修改文件中的代码注释,确保变更符合注释中的指导。
- 对每个发现的问题,启动并行的 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 用于代码链接。