merge-pr

用途：在完成确定性校验后合并已准备好的 PR，确保最终以 MERGED 结束而非 CLOSED。\n\n主要能力：脚本优先的确定性 squash 合并；严格门禁校验必需检查（无必需检查时视为通过 []，必需检查失败或等待中则失败）；合并时要求 --match-head-commit 固定 head SHA；处理审阅者合并作者邮箱选择与回退候选；仅在作者邮箱校验失败时重试一次；为 PR 作者和审阅者添加 co-author trailer，并在合并后验证提交信息中的两个 trailer；评论重试 3 次后提取评论 URL；确认 MERGED 后清理。\n\n使用方式：输入 PR 编号或 URL，缺失时使用 PR worktree 中的 .local/prep.env。先运行 scripts/pr-merge verify <PR> 校验合并就绪（向后兼容形式 scripts/pr-merge <PR>），再运行 scripts/pr-merge run <PR> 执行一次性确定性合并。包装命令与 cwd 无关，可在仓库根目录或 PR worktree 内运行。最后用带标签的行或项目符号报告：合并提交 SHA、合并作者邮箱、合并完成评论 URL、PR URL。\n\n限制与安全：禁止使用 gh pr merge --auto，禁止直接运行 git push，合并必须带 --match-head-commit。需先校验 .local/review.md、.local/review.json、.local/prep.md、.local/prep.env 等产物存在且非空。仅在确认合并成功后清理；若包装脚本不可用，只能回退到 scripts/pr merge-run <PR>。除调试外，不要粘贴原始包装诊断输出。