SuperAPI AI 工具集

pr

编程与开发

查看项目

更新于 11-06 18:22

技能介绍

PR 技能用于为当前分支编写一份有据可依、面向评审者的 Pull Request 描述,并在用户明确确认后创建或更新 PR。它的核心目标是写出“评审者需要、而 diff 本身无法表达”的内容,并通过机械化检查保证描述中的说法都有依据。该技能明确不合并、不批准 PR,也不编辑分支代码。

【定位基准】首先固定基准引用(例如 origin/main),并完整阅读 git diff <base>...HEAD。若通过 gh pr view <branch> --json state 发现该 PR 状态为 OPEN,则需先按“更新”流程处理。

【获取权威依据】需要找到意图来源:关联的 issue(gh issue view <n>)或已封存的 .first-four-hours/blueprints/*/blueprint.md。在描述中链接或引用其意图、决策与验收标准,而不得将其重新编写为第二个事实来源。若两者都不存在,应明确说明,并从用户处获取意图。

【记录验证】在将要推送的提交上的干净工作树中,对每一条计划声明的验证命令执行 record,每个参数对应一个 argv 元素: python <skill-root>/scripts/cli.py --repo-root <repo> --input runs=<runs.jsonl>
--input arg=<argv0> --input arg=<argv1> --format json record 该命令返回真实的 exit_code 以及可引用的命令字符串。

【起草】阅读 Description guide 后,在仓库之外、与 <runs.jsonl> 相邻的位置撰写草稿。

【检查】运行: python <skill-root>/scripts/cli.py --repo-root <repo> --input draft=<draft.md>
--input runs=<runs.jsonl> --input base=<base> --format json check 针对草稿中的每条诊断进行修复,或补充记录缺失的运行,重复执行直到通过。脚本只检查依据、已记录的运行和 Mermaid 图形结构,不检查文字质量;内容和每个图表的判断由使用者负责。

【确认与开启】向用户展示标题和完整的已检查草稿,询问是否开启 PR,以及当分支上游缺失或落后时是否先推送分支。只有明确的“是”才构成授权;沉默或此前的批准都不算。获得“是”后,必要时先推送,然后执行: python <skill-root>/scripts/cli.py --repo-root <repo> --input draft=<draft.md>
--input runs=<runs.jsonl> --input base=<base> --input title=<title>
--input confirm=<body_sha256 from check> --format json publish 其中 confirm 绑定用户所看到的精确文本;任何编辑之后都需重新检查、展示并再次询问。最后报告 PR URL。流程以一个可选的后续步骤结束:给出一个自包含的围栏提示,指明其所需的任何仓库、issue、PR 或产物;或说明无需后续步骤。只有“是”才会启动该步骤,并可通过它指定的任意技能执行,但用户需以 /<skill> 命令运行 charter、diagnose 或 ticket 步骤。该技能绝不合并 PR。