prepare-pr

用途：在 /review-pr 之后，对 PR 头分支做合并前的准备。输入需提供 PR 编号或 URL；缺失时可使用 PR worktree 中已有的 .local/pr-meta.env。\n\n主要能力：通过封装脚本完成初始化、说明文档与变更日志生成、gate 执行和安全推送。初始化命令 scripts/pr-prepare init <PR>；如需一次跑完可选用 scripts/pr-prepare run <PR>。修复依据来自结构化评审文件 .local/review.json（必需），必须处理全部 BLOCKER 与 IMPORTANT 项。变更需以精确文件列表提交：scripts/committer "fix: <summary>" <file1> <file2> ...。\n\n使用方式与关键约束：遇到 rebase 冲突时，解决文件后以非交互方式继续：git -C .worktrees/pr-<PR> add <resolved-files>，git -C .worktrees/pr-<PR> -c core.editor=true rebase --continue，自动化中不要用裸的 git rebase --continue。Changelog 为强制项：CHANGELOG.md 必须新增条目，追加到对应 ### Changes 或 ### Fixes 小节末尾；有作者元数据时该行需含 (#<PR>) thanks @<pr-author>。提交主题简洁、面向动作，不含 PR 编号与致谢。随后依次运行 scripts/pr-prepare gates <PR> 和 scripts/pr-prepare push <PR>；push 封装包含从 owner/name 解析 fork remote、推送前远端 SHA 校验、lease 失败时一次自动 rebase+gate 重跑+重试、推送后 API 传播重试、幂等处理及推送后 SHA 校验，并生成 .local/prep.env。\n\n限制：绝不推送到 main；仅向 PR head 推，且使用显式 --force-with-lease 针对已知 head SHA；不要运行 git clean -fdx；封装脚本与 cwd 无关，可从仓库根或 PR worktree 运行；本技能内不要执行 gh pr merge，不要删除 worktree。完成后输出已解决项与 gate 结果，并打印 PR is ready for /merge-pr。