SuperAPI AI 工具集

open-pr

编程与开发

查看项目

更新于 11-04 04:40

技能介绍

open-pr 是一个面向 Pull Request 创建流程的 AI 技能,核心目标是把 PR 正文写成“给只有一分钟的审阅者的简报”,并在打开 PR 前完成自审、验证与风险度量。

用途 通过该技能打开每个 Pull Request:自动审阅 diff、证明改动有效、度量合并危险,并按固定模板生成 PR 正文。PR 正文在创建、编辑与合并时会经过门禁检查,pr-kit CI 检查也会再次校验;不符合约定的正文无法打开。

主要流程

  1. 变基:拉取 base 并变基到其上;遇到无法证明正确的冲突即停止。
  2. 使用 review-gate 技能自审:其 pre-push 回执已要求第二模型审阅,因此不再额外运行 /code-review。
  3. 运行检查命令:bun ~/.agents/skills/review-gate/scripts/review-receipt.ts run。
  4. 由 review-gate 第 3 步指定的审阅者审阅相对 merge base 的 diff,提供仓库 AGENTS.md(缺失时用 CLAUDE.md)及 .github/pullfrog/ 下文件,以预测 Pullfrog 通过。
  5. 每条发现给出一种处置:Fix(立即修复后再审)、Decline(写明原因)、Defer(开 issue 并链接)。涉及代码事实的 Decline 必须在 Reason 中引用 path:line 或证明命令。
  6. 记录回执:bun ~/.agents/skills/review-gate/scripts/review-receipt.ts review --skill <interrogate|code-review> --act-on N --closed N --notes "<one line>"。回执只存计数,Review 表按同一次审阅逐行填写。若 review-gate 缺失(如云端会话),给一个全新上下文的审阅者相同输入并跳过回执命令。

证明改动 按“最好优先”给出可能失败的证据,验证用户可见行为而非 mock。修 bug 时先在 base 上复现并保留为 before;UI/API 改动走真实用户路径并给出前后对比(截图对或 15–45 秒演示,API 给请求与响应);性能改动给前后数据图表;给出在 base 失败、在分支通过的测试并引用失败信息;命令输出放在代码块中。

度量合并危险 Door:可逆为 two-way;删除非自己创建的内容、不可恢复的数据或工作、迁移 schema、发布/发送/部署给用户、花钱、改生产用户数据或改他人消费的契约,为 one-way。合并始终等待所有者指示(见 land-pr)。 Blast radius:找出 diff 之外可能受影响的调用方、消费方、配置、任务、其他仓库,通过运行代码而非阅读来证明安全事实,用 none/low/medium/high 一个词命名。

撰写正文 按模板写入文件,使用 ASD-STE100 风格:从问题开始,无前言;每句一个主题、不超过 25 词;主动语态、现在时;使用句号与逗号,不用破折号;Problem 至多四句。然后用 bun <本技能目录>/check.ts body.md --title "<title>" 检查并修复所有违规。

打开 PR 以 ready for review 打开,绝不使用 draft:gh pr create --title "<title>" --body-file body.md --base <base>。push 需单独一次调用,因为单独规则会拒绝 git push && gh pr create ...。门禁仅在该 PR 写入命令单独运行时检查,前后对可跟随的 cd、set 选项、写正文文件的 cat heredoc、以及只读过滤器等有严格限制;含 tee、后台 &、子 shell、输出重定向到文件等会使门禁拒绝。云端会话中 gh pr 可能因代理阻止 GraphQL 而 403,可改用 REST:gh api repos/{owner}/{repo}/pulls -f title="<title>" -F body=@body.md -f head=<branch> -f base=<base>。附加截图/视频用 gh pr create|edit --attach <file>,需 gh 2.99+。远程检出优先在该机器的该检出中使用 agent 会话。经 ssh 运行 gh 时,远程命令用单引号并把正文以内联带引号 heredoc 传入,分隔符加双引号 <<"EOF"。门禁拒绝 shell 读后改写的文本、远程 --body-file 路径、来自 shell 的方法/标志/字段名(如 -X "$M"),以及任何未加引号的 $...。使用 --attach 后把追加的图片链接移入 Proof,并保持 Changes made by ... 在最后。最后用 gh api repos/{owner}/{repo}/pulls/<n> 回读确认 base、body 与 draft 状态,再交给 land-pr 技能。

安装套件 没有套件的仓库应通过本技能单独开 PR 安装:可从 fleet store 运行 bun ~/.agents/skills/open-pr/kit.ts install <repo>;已有套件的仓库运行 bun .claude/skills/open-pr/kit.ts install <repo>;两者皆无时用 gh 从带有套件的仓库下载 open-pr 与 land-pr 两个技能文件夹后运行 kit.ts。runner 标签来自 --runs-on <label>,否则取已安装 pr-kit.yml 中的标签,否则取仓库其他工作流最常用的自托管标签;找不到、平票或只有托管标签时拒绝写入,此时需传入 --runs-on。托管标签(如 ubuntu-24.04)由用户自行决定,不由套件决定。第二次运行保留标签并输出“PR kit already current”。 对发布 .claude/skills 的产品,用 --layout developer 安装,技能文件夹放在 .dev/pr-kit 下,安装器不创建 Claude 或 Codex 发现链接,仓库说明需显式指向各 SKILL.md。产品实例应与仓库设置分开;developer 布局仍会向 .claude/settings.json 添加仓库钩子,实例需有自己的产品设置且不能继承该文件。每个仓库 Bash 工具调用都需要 Bun,因为 PR 门禁先于它运行。

版本与门禁 每个套件副本带 VERSION 文件,已安装技能的 .pr-kit 标记记录所装版本。若副本落后于源仓库 kits/pr、目标已有更新版本或同版本不同文件、源仓库 main 的 VERSION 不一致等,安装会在写入前拒绝,且无覆盖选项;需用 sk push 或拉取源仓库更新后重跑。修改套件后运行 bun kit.ts stamp in kits/pr/open-pr 并提交 VERSION。存储的 SHA-256 指纹格式为 sha256: 后跟 32 字节的冒号分隔十六进制;严格解析接受旧的连续十六进制戳用于更新,并比较完整摘要。门禁钩子使用 onFailure: "block",超时或无法启动时拒绝命令而非放行。

模板与检查规则 标题为 conventional commit,如 fix(web): new threads no longer spike CPU,仓库使用 emoji 前缀时允许加。正文依次包含 ## Problem(1–4 句)、## Change(最小可视化:形状匹配 diff、调用树、文件树或伪代码)、## Proof(表格/代码块/链接,含截图对或演示链接)、## Review(表格含 Disposition 列,每行以 Fix、Decline 或 Defer #<issue> 开头,只有在真实审阅后可整节写 No findings.)、## Merge danger(Door: 行与 Blast radius: 行),最后一行恰为 Changes made by <model> via <harness>。五个节按序出现且非空,可在其间插入 ## Deviations 等额外节;代码块用反引号或波浪号围栏,块内标题不算节。

适用场景与限制 适用于执行 PR 创建流程的仓库;依赖 Bun、gh(附件需 2.99+)与 review-gate 技能,云端会话可能需改走 REST。未提供收费、价格或效果数据。