worktree-merge 用于把已完成的执行组 worktree 合并回 main 分支,核心流程为:加载状态 → 校验依赖 → 合并分组 → 清理 worktree。它只负责合并,执行由 /workflow:unified-execute-parallel 处理。
主要能力:按依赖顺序合并;检测跨组文件冲突;支持单组或全部完成组合并;合并成功后可清理 worktree。
参数:--plan=<session> 指定计划会话(未提供则自动检测);--group=<id> 合并指定组(如 EG-001);--all 按依赖顺序合并所有已完成组;--cleanup 合并成功后删除 worktree;另有 --force 忽略依赖检查、--squash 使用压缩合并。
输入读取 .workflow/.execution/worktree-status.json(组完成状态、worktree_path、branch、merge_status)和 .workflow/.planning/{session}/execution-groups.json(依赖与 cross_group_files),输出更新后的 worktree-status.json 与 merge-log.md。
合并阶段会 git checkout main、git pull origin main,再执行 git merge --no-ff {branch-name} 或压缩合并;出现冲突时需手动解决并 git add、git commit。合并后更新状态、追加日志,并按需执行 git worktree remove .ccw/worktree/{group-id} 删除 worktree,可选删除分支。
适用场景:并行执行组完成后需要按依赖集成到 main、存在跨组冲突需系统处理。限制:组必须已完成且 worktree 存在,未合并的依赖会报错或需级联/强制处理;本工具不负责执行阶段,冲突需人工解决。其余收费与平台细节暂未提供。