用途
merge-batch 是用于处理“所有者选定的 PR 批次”的合并工作流技能,适用于对一份粘贴的 PR 列表进行共享准备、集中诊断和逐项精确准入,并保留贡献者署名。资料未说明其具体安装方式与运行命令之外的更多细节。
主要能力
-
准入与权限核查:解析每个选中 PR 的 open/draft(开放/草稿)状态、当前 head/base、目标分支、贡献者与写权限;读取 diff 与当前冻结状态,检查 worktree 占用;被其他会话占用的项保持挂起。分析或准备列表不等于获得合并或关闭权限。
-
技能合约检查:在准入前对实际安装的 skills 根目录运行
scripts/quality/check-skill-contract.mjs。指令缺失或漂移则 HOLD;仅模板检查不能验证实际使用的安装。 -
星级评估表:给出 1–5 星表及理由、重叠与挂起项。星级只用于排优先级,不免除必需检查或受保护面审批;低星项操作或派遣返工前需询问所有者。对被包含项需证明当前行为并单独取得逐项关闭决定,使用其工作时保留原 PR。
-
诊断板构建:固定已批准的实时 base,记录有序 PR head;在
.claude/worktrees/下使用自有分支与 worktree,配合与候选 lockfile 匹配的 hooks 与依赖;核实依赖身份而非假设共享检出副本为最新;不得覆盖共享硬链接。将选中 refs 上榜并验证每个都是合并后 head 的祖先;解决重叠时不丢弃同级行为与贡献者归属;不改动无关 worktree 与共享检出,禁止使用git stash。并行准备需要授权委派与互不重叠的写权限。 -
诊断与修复:用实际收集器运行适用的静态配置与聚焦测试,保留 stdout/stderr、退出码、信号、版本与身份信息;这些只是 PARTIAL 证据,不构成合并接受。全流程证据可由批准的服务器队列提供。归因前应在可比运行时与安装下对比同一固定 base 上的失败需求;资源/环境中断单独记录。受控重复可诊断不稳定性,后出现的 PASS 不抹除先前必需的 FAIL;保留断言、阈值与基线。候选接受前完成冲突、i18n、文档与代码协调。
-
逐项准入:每个选中 PR/组按共享合并门禁(merge gates)重新解析当前 base、head、已测候选与策略;要求所有适用必需通道,包括 Gate / CI、Gate / Quality 及聚合外需求。草稿跳过、MERGEABLE、绿色诊断板、旧 head 与继承失败均不构成接受;身份变化即回到验证。使用批准的服务器强制队列或经审查的身份保留协议落地;
gh pr merge --match-head-commit只守护 head,不原子守护 base,也不替代缺失必需检查;工具无法保留已测候选或排除竞态时 HOLD。 -
读取回验与交接:验证合并状态、实际 SHA/tree 与贡献者署名;在准入下一次落地前刷新并验证结果 base。分别报告已准备、已集成与当前已验证状态;部分落地批次不是完整 PASS。在自有私有任务制品中保留有序台账(PR、base/head/候选/落地身份、检查、回执、贡献者归属与挂起)。仅关闭另行授权项并使用共享署名规则;安全拆除本批次 worktree 前保留证据,不删除其他会话工作,不把共享检出留在其他分支。
使用方式
该技能以 PR 列表为输入,按上述五个阶段推进:准入与权限核查 → 构建诊断板 → 诊断与修复 → 逐项实际落地 → 读取回验与交接。资料提供了部分脚本路径(scripts/quality/check-skill-contract.mjs)和 git 命令(gh pr merge --match-head-commit),未提供完整安装命令与调用示例。
适用场景
适合维护者处理成批的待合并 PR,需要在共享准备与逐项精确准入之间平衡,同时保留贡献者署名与受保护面审批。
限制
合并、关闭、信任审批与发布/部署权限是各自独立的例外决定,不能从批量请求或星级评级推断。批量共享发现与冲突诊断,不代表同一诊断板的 PASS 证据对不同中间 squash 候选有效。模板检查不能替代实际安装验证。资料未说明价格、平台或效果数据。