用途:在合并前准备 GitHub PR 分支,完成评审修复、门禁通过并更新 head 分支。
主要能力:识别 PR 元信息(作者、head 分支、head 仓库 URL);将 PR 分支 tip 拉取到本地 ref 并 rebase 到最新 origin/main;修复 .local/review.md 中的 BLOCKER 与 IMPORTANT 项(NIT 可选);按评审提示更新 CHANGELOG.md 与文档;提交修复;运行门禁(pnpm install、pnpm build、pnpm ui:build、pnpm check、pnpm test);将更新后的 HEAD 推回 PR head 分支;验证 PR 不再落后于 main;写入 .local/prep.md 汇总。
使用方式:需提供 PR 编号或 URL,缺失时自动检测,含糊时询问。所有操作在隔离 worktree(.worktrees/pr-<PR>)内进行。先创建并打印 TODO 清单,然后继续执行命令,不能只打印清单就停止。若委派他人,需其实际运行命令并捕获输出。
限制与安全:绝不推送到 main 或 origin/main,只推送到 PR head 分支;禁止裸 git push,必须显式指定 remote 和 branch;禁止运行 gateway stop 命令、杀进程、触碰端口 18792;禁止 git clean -fdx;禁止 git add -A 或 git add ..,只暂存具体变更文件;禁止 gh pr merge;成功后不删除 worktree,/mergepr 可能复用。若出现 fatal: not a git repository,说明目录错误,可用 ~/dev/openclaw,否则询问用户。rebase 冲突需逐个解决并 git add 后 git rebase --continue;若冲突解决 3 次以上应停止报告。门禁失败最多修复重跑 3 轮,仍失败则停止报告。完成条件全部满足后输出:PR is ready for /mergepr。