SuperAPI AI 工具集

pr-review

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:审查 PR/MR 时以范围合规为主线,验证实现是否满足声明的需求且不引入回归,而非追求代码完美。超出范围的改进留待后续 PR。自动通过 leyline:git-platform 识别平台,GitHub 用 gh,GitLab 用 glab。

主要能力:建立范围基线(依次查 plan.md、spec.md、tasks.md、PR 描述、提交信息);收集 diff;需求覆盖校验;版本校验(如 marketplace.json 对 plugin.json、pyproject.toml、package.json、Cargo.toml 及 CHANGELOG);PR 卫生检查(原子性、AI 生成痕迹、自审信号);结合 pensive:unified-review 做代码审查;增量偏差审计与不变量冲突检测;将 BACKLOG 项创建为 issue;生成分级报告(BLOCKING、IN-SCOPE、SUGGESTION、BACKLOG、IGNORE、INVARIANT)。

使用方式:审查时给出 PR/MR 编号,工具据平台执行对应命令,如 gh pr view <number> --json body --jq '.body'、gh pr diff <number>、glab mr view <number>、glab mr diff <number>。创建 issue 用 gh issue create(GitLab 用 glab issue create)。支持 --local [path] 将报告写入本地 .md(默认 .pr-review/pr-<number>-review.md),支持 --concise 精简贴文,支持 --hold-insights 与 --interactive 理解循环。

适用场景:合并功能分支前、评审同事 PR、请求评审前自审、生成改进 backlog。

限制:不用于准备 PR(应使用 pr-prep)或深度代码审查(应使用 pensive:unified-review)。无非范围 artifact 时会将此记为流程问题但仍以 PR 描述为基线。版本不匹配默认判为 BLOCKING,除非维护者显式豁免。不变量冲突不上报解决方案,交人工三选一。理解循环需显式开启。