用途:在 Conflux 并行处理多个变更、将变更分支集成到目标分支时,处理合并冲突并完成顺序合并。该技能不能向用户提问,所有决策须基于已有上下文自主完成。
主要能力:提供冲突解决固定规则、预同步要求、合并提交约定与安全约束;若存在 openspec/CONSTITUTION.md,须先读取并视为高于提案/规格增量的项目规则。冲突解决时检查冲突标记、理解双方意图,尽量保留双方意图;若一方取代另一方,优先更新或更完整的变更;解决后对每个文件执行 git add 并完成合并提交。
顺序合并协议:对每个分支依次执行。第一步在工作树目录预同步:cd <worktree_path>、git checkout <branch>、git merge --no-ff -m "Pre-sync base into <change_id>" <target_branch>;冲突则解决、git add、git commit -m "Pre-sync base into <change_id>";提交信息有误用 git commit --amend -m "Pre-sync base into <change_id>" 修正。第二步在仓库根目录最终合并:cd <repo_root>、git checkout <target_branch>、git merge --no-ff --no-commit <branch>;冲突则解决并 git add;创建合并提交前,若 openspec/changes/<change_id>/proposal.md 存在且 openspec/changes/archive/ 含同一 <change_id>,用 git rm -rf openspec/changes/<change_id> 删除被合并复活的目录;最后 git commit -m "Merge change: <change_id>"。第三步提交后:若 pre-commit 钩子修改文件并中断提交,重新暂存并以相同信息再次提交。
提交信息约定:预同步合并主题必须为 Pre-sync base into <change_id>;最终合并主题必须为 Merge change: <change_id>,由编排器校验。
安全约束:提交时不得使用 --no-verify,始终运行 pre-commit 钩子;不得破坏与冲突变更无关的现有功能;修改共享代码须确保所有现有调用方仍正常;不得删除或改动不属于冲突变更的现有功能;不得使用 reset --hard 等破坏性命令。
上下文与重试:编排器注入 VCS 冲突解决提示前缀、冲突修订与变更 ID、VCS 错误输出、当前状态、冲突变更日志、冲突文件列表、目标分支与基础修订、工作树位置及先前尝试历史;重试时提供先前结果、stdout/stderr 尾部与继续原因,用于避免重复错误。
适用场景:Conflux 并行执行中的合并冲突解决与顺序合并。限制:不能询问用户或等待输入;不得跳过钩子或使用破坏性命令。