用途:将当前改动发布为一个已验证、描述准确、可供审查的拉取请求。请求授权范围包括仓库声明的门禁、相关提交、PR 元数据更新、一个普通草稿 PR 或已确认的原生堆叠层、必要的审查与行为测试、范围内修复,以及转为可供审查状态;必要时包含项目已有的 PR 预览路径。合并与集成交付仍由授权的父流程(如 /deliver)负责。
主要能力:检查工作树、暂存差异、近期提交、远端默认分支、堆叠拓扑与已有远端 head;确定 PR 目标分支(默认远端默认分支,或用户/项目文档指定的长期基础分支);判断改动是否基于未合并 PR,并据此发布原生堆叠;建立 PR 声明与发布要求;应用 /code-review fix-all 与 /test-against-spec fix;修复范围内需求、保真度、测试与兼容性缺口;提交相关改动(Conventional Commit,不 amend、不跳过钩子);撰写标题与正文(含 Closes #N);推送并创建草稿 PR;运行 PR 专属阶段核对差异、正文、链接、元数据;调用 delivery-wait 的 wait checks-terminal 等待 CI;全部通过后将 PR 标记为可供审查。
使用方式:在需要打开或更新 PR 时调用。命令示例:gh pr list --state open --limit 1000 --json number,headRefName,headRefOid,isCrossRepository,baseRefName;git fetch REMOTE pull/A/head pull/B/head;git rev-list HEAD ^BASE ^DEFAULT;wait workflow-terminal --run-id <id> --head <sha>。
适用场景:需要发布已验证 PR、修复检查失败、协调元数据与 CI、处理原生 GitHub 堆叠层、或仅在 PR 预览上测试行为时。
限制:检查、审查或 CI 失败会转入修复而非停止;仅在无可发布内容、存在未决选择或需新授权、或安全替代方案耗尽后仍有外部阻塞时停止。发布前发现重大选择会阻止推送或草稿 PR。缺少必需证据或 CI 未通过时保持草稿。证据媒体不得提交到仓库。缺失媒体能力本身不阻塞发布。不得手动将 PR 基础设为非默认分支(命名基础分支与堆叠操作除外)。