用途
merge-prs 用于承接 PR 分析阶段的产出,执行经授权的 PR 修复与合并。它属于 omniroute 的 PR 流水线技能之一,执行前要求先阅读并遵循多个共享规则文件,包括绿色基线、验证门控、合并门控、受保护面和贡献者署名保护等;这些规则在全程具有约束力,不以吞吐量为由豁免必要检查。
主要能力
- 核对与选择:刷新实时 PR 状态、head、base、worktree 归属、冻结状态以及 _tasks/pipeline/prs/1-analyzed/ 下的既有计划,保留其他会话的认领;向所有者提交按就绪度及贡献者/主题组织的报告,内容包括评审评级、范围、风险、必须修复项和建议。
- 合并档案:在所有者选择条目或分组后,提供包含进入、退出或变更内容、 authorship、依赖、验证、风险、回滚、顺序和最终候选身份的合并档案,并取得对该分组的明确授权。一般性的继续开发许可不等于合并许可;若所有者明确点名 PR 并要求合并,可视为满足选择/档案决策,但仍保留全部安全门控。
- 认领与实施:仅通过流水线原子移动到 2-implementing/ 认领被选中的合规计划;在观察到的贡献者 head 上创建隔离 worktree,改动前核验身份,每次推送前复查远端前驱。只实现批准的必要项,提供 RED-to-GREEN 证明及相关测试套件结果。保留原始作者身份和适当的维护者共同署名。
- 验证与准入:按共享验证/合并规则采用精确候选契约。本地快速检查、仅 head 的 pre_greened 标记、前一天的完整 train、空的事件列表或单独的 DRIFT 均不能授予准入;门控失败后不得运行回退命令来制造成功;缺失或矛盾的产物、不完整的构建/打包证据仍视为失败或 HOLD。基线失败需在独立 PR 中精确复现并修复,不构成管理性绕过理由。
- 合并:在所有者授权且所有必需检查通过后,仅经共享合并门控串行合并,并立即复查冻结状态、PR head、base、候选和受保护面;任何变动或重定向都会使合并凭据失效。完整 train 尖端不能授权不同的中间 squash 树。遇到暂挂条目应跳过,不得悄然扩大已批准批次。
- 结果核对:回读实际合并状态/SHA 与署名,刷新基线,保留产物并只更新自有私有计划;单独跟踪合并后的基线验证。准备的/草稿 PR 或未合并补丁不得标记为完成。关闭、推迟或归并处置需逐项单独取得所有者明确批准,替代性需以受影响行为和方向证明,而非仅匹配 issue 编号。
使用方式
该技能以流程规范形式描述操作步骤,执行顺序为:核对与选择、在不丢失署名的情况下修复、验证与准入、结果核对。它依赖 _tasks/pipeline/prs/ 下的计划目录结构和共享规则文件,并涉及私有 _tasks 仓库中的计划更新。结束时需给出已合并、已准备、暂挂和仍失败条目的数量及确切证据,并按共享清理协议仅清理自有、干净且已备份的 worktree,保留共享检出,未经请求不更新记忆。
适用场景
适用于已有分析计划的 PR 批量整理与合并,尤其是需要保留贡献者署名、对 fork 贡献进行受控处理、以及要求所有者对每个分组合并明确授权的协作仓库维护场景。
限制
未提供具体实现语言、依赖环境或安装命令;执行前所需的共享规则文件内容、流水线目录的具体格式以及凭据管理方式在资料中未展开说明。