SuperAPI AI 工具集

review-a-pr-and-report

通用与其它

查看项目

更新于 10-16 01:29

技能介绍

用途:对指定 PR 的已提交 diff 进行审查,运行仓库自身的门禁测试,并对照规格(Spec/ADR)与工单(ticket)判断代码是否偏离计划,最终以固定格式报告并给出是否应合并的 yes 或 no。

主要能力:读取提交差异(使用三点 diff 对比 merge base 与 head SHA)、整体阅读变更文件、检查提交信息与仓库约定、发现未跟踪文件、运行仓库门禁测试、逐条核对工单验收标准、系统排查各类漂移(范围、规格、回填规格、计划、测试、文档、术语、放置、基线、残留)。

使用方式:调用方需先准备仓库与 PR 编号、head SHA、base ref、位于 head SHA 的干净检出、已有评论以及轮次信息。若由人类直接调用,需先用 gh pr view、gh pr checks 等命令获取信息。测试命令优先从 AGENTS_REPO.md、AGENTS.md、CI 工作流或构建文件中查找,不得自行编造。

限制:该技能从不写入,不提交、不修复、不推送、不评论、不合并。仅 Markdown 变更的 PR 可豁免门禁测试,但步骤 3 和 4 仍完整执行。依赖容器的测试可豁免,交由 CI 负责;若容器测试启动后断言失败则仍属真实失败并阻断。无法验证的内容需明确列出并阻断。报告固定分节,结论只能是 yes 或 no。