用途:作为协调者(coordinator)在 workmux worktree 之间编排多阶段实现。协调者持有主计划、阶段分发、合并顺序、祖先检查、最终集成验证与最终总结,但不为功能工作直接编辑源文件。资料明确要求不要使用 Claude Code 内置 worktree 功能,改用 workmux 编排。
主要能力:按 DAG 管理阶段(pending、working、done-unverified、merging、merged、failed、blocked);按 light/standard/design/strict 预设编译 planning、plan_review、executor、verification 字段,并允许阶段级覆盖;校验阶段 id 唯一、依赖存在、无环、有验收标准,路径归属足够明确;串行合并并做祖先校验;支持最终集成评审策略 none/auto/full。
使用方式:支持参数 --plan、--integration-branch、--preset、--validation、--reviewer、--reviewers、--integration-review。在 history/<日期>-phased-<slug>/ 下生成 plan.md、prompts/、captures/、summary.md。阶段通过 /implement 执行,合并使用 /merge --keep;示例命令如 workmux add <phase-id> -b --base "$INTEGRATION_BRANCH" -P "$PLAN_DIR/prompts/<phase-id>.md"、workmux wait <handles> --status working --timeout 120、workmux capture、workmux remove <phase-id>。
限制:协调者不写源码;workmux done 不等于成功,须校验结果哨兵 status 为 success;最多一个 /merge --keep 同时运行;依赖全部合并后才生成后续阶段;失败或被阻塞的 worktree 需保留待查;合并冲突视为该阶段合并失败而非销毁 worktree;不要为 YAML 编写 shell 解析器。缺失事实:未提供具体安装步骤、收费或许可信息。