SuperAPI AI 工具集

merge-orchestrator

智能体与模型

查看项目

更新于 10-16 00:02

技能介绍

merge-orchestrator 是 Exarchos 的合并执行器技能,用途是把子代理 worktree 分支就地合并到目标分支(通常是集成分支),并在合并前记录目标分支 HEAD 作为恢复点 SHA,以便失败时回滚。它执行的是本地 git merge,不调用 GitHub/GitLab/Azure DevOps 等远程 VCS,也不需要 PR id;合并远程 PR 属于另一技能 merge_pr。

主要能力与流程:先做 worktree 可用性预检(目标分支不得已在同级 worktree 中检出),再叠加 ancestry、当前分支保护、主 worktree 断言、工作树漂移等预检;持久化恢复点;执行本地合并(merge/squash/rebase 三种策略,strategy 必填,无默认值);任一步失败即运行 INV-14 恢复阶梯:git merge --abort → git reset --keep <recoveryPointSha>,不使用 --hard,并给出分类失败原因;发出 merge.preflight、merge.requested、merge.executed、merge.recovered 等专用事件(旧 merge.rollback 已停用但可读)。终态 completed / rolled-back / aborted 在 resume 时短路,幂等键可按 taskId 合并重复派发;dryRun 只跑预检并提前返回。

用法:对共享集成分支必须经 serialize_merge 单写者入口(每集成 ref 至多一个在途合并),直接调用原始 merge_orchestrate 仅用于非集成分支或已持有租约的场景,否则对带活跃外部租约的集成 ref 会以 MERGE_LEASE_HELD 关闭失败且无 git 副作用。可通过 CLI exarchos merge-orchestrate --source-branch ... --target-branch ... --task-id ... --strategy squash 调用,也可通过 MCP merge_orchestrate action;退出码 0 成功、1 输入无效、2 合并失败、3 未捕获异常。诊断可用 EXARCHOS_PREFLIGHT_DEBUG=1。数据未提供收费、价格与更多部署细节。