用途:open-pr 用于把当前功能分支的成果发布以供评审,即推送分支并创建或更新一个 Draft PR,附带规范的标题与描述。它本身不实现新代码,也不负责合并 PR。
主要能力:默认优先创建 Draft PR;支持在已有 PR 时更新标题与正文;PR 正文模板包含 Summary(What/Why)、PRD 路径、Changes、Testing(精确命令与结果)、How to verify、Risks/rollout/rollback、Migration/backwards compatibility、Screenshots(如涉及 UI)以及 Checklist。
使用方式:先收集输入,包括 PRD 路径(如 tasks/f-##-<slug>.md)、base 分支(默认从 origin/HEAD 解析仓库默认分支,不明确时询问)、PR 标题种子(默认取自 PRD 标题或功能 ID)。预检需确认处于功能分支而非 base 分支、工作区干净(git status --porcelain 为空)、有可推送提交(比较 base...HEAD)、PRD 含基于清单的进度且已完成项已勾选,并捕获测试/检查命令与结果。随后推送分支:git push -u origin HEAD。查看现有 PR:gh pr view --json url,number,state,isDraft -q .url;存在则 gh pr edit --title "<title>" --body "<body>";不存在则 gh pr create --draft --base "<base>" --title "<title>" --body "<body>";再通过 gh pr view --json url -q .url 获取 PR URL。若 gh 不可用,则输出准备好的标题与正文及手动创建说明(仓库 URL、base 分支、draft 标志)。
适用场景:功能分支完成实现后需要发起评审时;需要按 PRD 关联进度并记录测试与验证步骤时;热修复直接提交到默认分支时 PR 可选,改用 review local 与 commit。
限制:不在此实现新代码,需要改动应回到实现环节;不在此合并 PR,评审在 review 进行,合并与分支清理在 commit(finalise 模式)进行;默认使用 Draft PR;测试命令与结果不得猜测。完成后建议按需运行 review(PR 模式),就绪后运行 commit(finalise 模式)。输出包括 PR URL(或创建失败时的说明)、最终 PR 标题与正文,以及状态块(Files changed、Key decisions、Next step)。