SuperAPI AI 工具集

review-pr

编程与开发

查看项目

更新于 11-10 16:24

技能介绍

review-pr 是一个用于综合性拉取请求(PR)审查的技能,隶属于 smartworldarafath/google_antigravity_plugins 插件集。其核心思路是调用多个专用智能体,每个智能体聚焦代码质量的不同方面,从而形成多维度、可操作的审查报告。

用途与审查范围

该技能用于对 PR 或即将提交的代码改动执行综合审查。审查范围通过 git status 与 git diff --name-only 确定改动文件,并解析用户传入的参数以决定执行哪些审查方面;未指定时默认运行全部适用审查。可用审查方面包括:

  • comments:分析代码注释的准确性与可维护性;
  • tests:审查测试覆盖质量与完整性;
  • errors:检查错误处理中的静默失败;
  • types:分析类型设计与不变量(仅当新增类型时);
  • code:依据项目指南进行通用代码审查;
  • simplify:在审查通过后简化代码以提升清晰度与可维护性;
  • all:运行全部适用审查(默认)。

工作流程

  1. 确定审查范围:检查 git 状态识别改动文件,解析参数判断用户请求的审查方面,默认执行全部适用审查。
  2. 识别改动文件:运行 git diff --name-only 查看修改文件,检查 PR 是否已存在(gh pr view),识别文件类型及适用的审查。
  3. 确定适用审查:基于改动内容,始终适用 code-reviewer(通用质量);若测试文件改动则启用 pr-test-analyzer;若新增注释或文档则启用 comment-analyzer;若错误处理改动则启用 silent-failure-hunter;若新增或修改类型则启用 type-design-analyzer;审查通过后由 code-simplifier 做打磨与精简。
  4. 启动审查智能体:可采用串行方式逐个执行,便于理解与跟进,每份报告完整后再进行下一个;也可按用户请求并行启动所有智能体,更快返回汇总结果。
  5. 汇总结果:将发现整理为严重问题(合并前必须修复)、重要问题(应当修复)、建议(可选优化)和优点观察(做得好的地方)。
  6. 提供行动计划:按“先修复严重问题、再处理重要问题、考虑建议、修复后重新运行审查”的顺序组织输出。

智能体说明

  • comment-analyzer:核对注释与代码是否一致,识别注释腐化,检查文档完整性。
  • pr-test-analyzer:审查行为层面的测试覆盖,识别关键缺口,评估测试质量。
  • silent-failure-hunter:查找静默失败,审查 catch 块,检查错误日志记录。
  • type-design-analyzer:分析类型封装,审查不变量表达,评估类型设计质量。
  • code-reviewer:检查 AGENTS.md 合规性,检测缺陷与问题,审查通用代码质量。
  • code-simplifier:简化复杂代码,提升清晰度与可读性,应用项目标准,同时保持功能不变。

使用方式与示例

全量审查(默认): /pr-review-toolkit:review-pr

指定审查方面: /pr-review-toolkit:review-pr tests errors(仅审查测试覆盖与错误处理) /pr-review-toolkit:review-pr comments(仅审查代码注释) /pr-review-toolkit:review-pr simplify(在审查通过后简化代码)

并行审查: /pr-review-toolkit:review-pr all parallel(并行启动全部智能体)

适用场景

  • 提交代码前:先运行 code 与 errors 等针对性审查,修复严重问题后再提交。
  • 创建 PR 前:暂存全部改动后运行 all,处理严重与重要问题,再运行特定审查复核,最后创建 PR。
  • 收到 PR 反馈后:按反馈修改代码,运行针对性审查,确认问题解决后再推送更新。

注意事项与限制

智能体自主运行并返回详细报告,每份报告聚焦其专长领域,结果带具体文件与行号引用,便于后续处理;智能体会依据问题复杂度选用合适的模型。技能说明未提供关于性能、计费、平台兼容性等额外信息,相关内容暂未提供。