用途:更新已建立的 PR,流程包括集成、提交相关改动、普通推送和刷新元数据。请求包含解决常规冲突并运行声明的 PR 门禁,但不授权合并;复用已选定的目标和先前授权,仅在目标 PR、实质性冲突解决选择或其他实质性选择不明确时才询问。
主要能力:检查当前 PR 及其基线分支、分支、相关本地改动、近期提交和已获取的远端基线;在判断缺失 CI 是否需要处理前,先解决落后基线或冲突的分支。若在基线分支上或无打开的 PR,则停止并报告所需的下一步工作流;若 git-workflow 未给出 PR 的远端基线,同样停止。普通分支落后远端基线时将其合并进分支,在附加式冲突中保留双方所需行为,用项目工具重新生成生成文件。对已验证的原生栈,捕获远端 head 并使用受保护的 gh stack sync 或更窄的官方栈操作,绝不使用原始 rebase 或 force-push。
验证与提交:对改动行为应用 /code-review fix-all 和 /test-against-spec fix,包括基线集成;仅复用内容、命令、环境和覆盖范围仍匹配的证据,基线合并或编辑会使受影响的检查失效。通过 /implement 的开发循环修复每个已验证的范围内需求缺口,然后建立声明的 PR 门禁。存在相关改动时按 git-workflow 提交:只暂存这些文件,使用简洁的 Conventional Commit 主题,绝不 amend 或跳过钩子;在每次提交、推送和 PR 写入时运行发布守卫。分支有远端缺失的提交时正常推送普通分支,必要时设置 upstream;仅通过受保护的官方栈工作流推送已验证的栈。
元数据与报告:将 PR 标题和正文更新为与完整当前 diff、范围、关联 issue 和观察到的验证一致;推送总会改变验证所适用的 head,因此推送后即使摘要仍成立也要写入更新后的正文。标题保持为整个改动的 Conventional Commit 主题,它将成为 squash-merge 的提交主题,范围扩大也可能改变其类型。遵循 ../agent-writing/references/pr-descriptions.md,保留项目模板的明确要求,替换过时摘要或中间开发历史。报告更新后的 PR、任何新提交、元数据变更、发布守卫改写的内容和观察到的验证;适用时包含栈位置和被改写的分支。区分已通过的本地检查与待定的当前 head CI,返回确切的当前 head 和向活动发布或交付调用方的下一转换。草稿 PR 保持草稿,仅在该确切 head 的所有必需 CI 和证据均观察为绿色后才标记就绪。报告缺失的 walkthrough 要求及补救措施。
限制:不授权合并;媒体工具缺口本身不阻塞更新;当 PR 媒体不再显示当前行为或改动需要新媒体时,使用 ../create-pr/references/walkthroughs.md 刷新受影响部分,仍显示当前行为的媒体可复用。当前 PR 属于原生 GitHub 栈时,阅读 ../git-workflow/references/github-stacks.md。