SuperAPI AI 工具集

audit-pr

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:audit-pr 是合并前的最终门禁,回答“这个 PR 真的可以发布吗”。它在 review-change 已发出 REVIEW-PASS 回执、所有阶段提交完成之后运行,对整个 PR 做只读审计,给出单一结论。它不重复审查 diff,而是消费当前 SHA 绑定的 review-change 回执作为审查证据;回执缺失或过期会作为阻塞项路由回 /review-change。

主要能力:读取并核对 PR 的 SPEC、规划产物、路线图、文档映射、PR 正文、issue 链接与 CI,检查交付门禁、能力闭合与降范围来源、架构不变式保持、终端清洁度(工作树干净、分支已推送、非草稿)以及上游血缘(计划回执与父 SPEC 回执摘要重算)。最终以固定格式打印 VERDICT: MERGE-READY 或 BLOCKED,附排序后的、有证据的阻塞项,并在结论头部打印 PR 完整 URL。MERGE-READY 时通过脚本发布 SHA 绑定的评论,BLOCKED 时不评论。

使用方式:默认目标为当前分支的 PR,也可传入 PR 编号。发现阶段会读取项目契约与验证门禁;随后取回 headRefOid 与评论,查找最新标记。可用 gh pr view <N> --json headRefOid,comments 获取回执,用 bun scripts/review-receipt.mjs verify --pr <N> 判断回执是否仍为 current 或 stale,用 bun scripts/audit-pr-gate.mjs hygiene --pr <N> --apply 读取终端清洁状态。审计必须按顺序加载五个强制资源:合并门禁、闭合与范围门禁、审计流程、输出前判定、路由与护栏。

适用场景:PR 已“完成”但尚未合并,需要一份可辩护的合并就绪结论;或需要确认 SPEC 所承诺的内容是否齐备、可追溯且 CI 全绿。

限制:本技能从不合并,即便项目文档含 merge: auto、用户此前批准过合并或工具保留了先前权限,也不能改变其只读边界。唯一自动合并权限来自主动调用的 advance --continue --fullauto 运行的 AUDIT 阶段;独立/手动调用始终把 MERGE-READY 的 URL 交给人类。它不会重新审查或重建审查通过记录,回执缺失/过期一律是阻塞项。缺失证据或缺失必需资源即为阻塞项,绝不推断通过。分类判断依据其明确的 PR 交付审计用途,归入测试与质量。