SuperAPI AI 工具集

pr-review

测试与质量

查看项目

更新于 10-15 20:05

技能介绍

用途:在合并前对单个 PR 给出独立、对照真实代码的判断,而不只看门控红绿;也可用于怀疑某 PR 与其他 PR 重复/冲突/矛盾时定责,或构建可复用的逐个 PR 自动审查动作。不适用纯本地 diff 审查(用 /code-review)和 issue 设计评审。

主要能力:

  1. 读 PR 全貌:标题、body、作者、分支、可合并性、改动统计、标签;并补读三个面的人类意见——会话评论(gh pr view <n> --comments)、inline 代码行评论(gh api repos/{owner}/{repo}/pulls/<n>/comments)、review 总评(gh api repos/{owner}/{repo}/pulls/<n>/reviews,需显式记下 state)。无 gh 时用 mcp__github__* 工具等价替代。
  2. 复审去重:以 HEAD sha 为机器键、每 PR 唯一 canonical comment 为载体。fresh 则跳过,stale 做增量复审(git diff <旧sha>..<HEAD>),机械重生成 PR 视同 fresh,仅静默刷新 sha。
  3. 逐条核验声明 vs 已落地代码/测试,定位 path:line 或标 NOT FOUND;并做横切检查:反向引用、跨包 parity、端到端交付、性能回退、测试覆盖、清理收尾。
  4. 运行 pre-merge 验证门控并判读根因(本 PR 缺陷 / flaky / base 陈旧 / 可自修噪音)。
  5. 检测与兄弟 PR 的冲突/重复/矛盾。
  6. 输出五类受控判定:MERGE、COMMENT、SUPERSEDE、BLOCK、CLOSE。MERGE 必须以身 Step 3 通过为前提。

使用方式:/agentloop:pr-review <pr-number-or-url> [--post]。默认 read-only,仅产出给用户看,不发评论、不动标签、永不 merge;--post 才把 verdict comment 发到 PR。verification 报告须通过 pre-merge.ts --comment <n> 单独投递,不手写合并。批量与受闸自动合并用 pr-sweep。

限制:本技能只判不合,真正不可跳过的硬合并门控在执行侧;需要人介入的判定必须附带「需人确认块」。具体仓库配置项(repo_slug、gate_mode、verification_entry、pre_merge_entry、UI Face Paths、Companion Skills 等)来自 .claude/repo-profile.md,资料未提供各仓库具体值。