--- created: "2026-04-06" updated: "2026-04-14" type: resource tags: [resource, claude-code, AI-tools, orchestrate, migration, feature-dev, GSD, PRP, devfleet, ECC, windows-compatible] source: "https://github.com/affaan-m/everything-claude-code" --- # ECC 编排替代方案 (orchestrate 迁移) `/ecc:orchestrate` 已标记为 legacy shim。底层委托给 `dmux-workflows`（需 tmux）和 `autonomous-agent-harness`（部分依赖 tmux）。Windows 上基本不可用。本文档记录迁移路径。 > **先看决策表**：见文末「一张表选编排方式」。 相关笔记：[[Autonomous Agent Harness 自主代理框架]]、[[Everything Claude Code 完整指南]] ## orchestrate 做了什么 原来的 `/ecc:orchestrate feature "描述"` 内部流程： 1. Plan（规划） 2. TDD（测试驱动开发） 3. Code Review（代码审查） 4. Security Review（安全审查） 5. Verify（验证） 接受参数：`feature`、`bugfix`、`refactor`、`security`、`custom`。 ## 替代方案 ### 路线 A：单功能/任务 — `/ecc:feature-dev`（推荐） **orchestrate 的最直接替代品。** 7 阶段全在 Claude Code 内部完成： ``` /ecc:feature-dev "add JWT authentication" ``` 内部自动走： 1. **Discovery** — 读取需求，识别约束和验收标准 2. **Codebase Exploration** — 用 `code-explorer` 分析相关代码 3. **Clarifying Questions** — 提出设计/边界问题，等用户回答 4. **Architecture Design** — 用 `code-architect` 设计，等用户批准 5. **Implementation** — TDD 实现，小粒度提交 6. **Quality Review** — 用 `code-reviewer` 审查，修复 critical/high 问题 7. **Summary** — 总结构建内容，列出跟进项 ### 路线 B：手动拆步骤 如果想更精细控制每一步： ``` /ecc:plan "描述" # 规划，等确认 /ecc:tdd # RED → GREEN → REFACTOR /ecc:code-review # 代码审查 /ecc:security-review # 安全审查（涉及 auth/支付时） /ecc:verify # 构建 + 测试 + lint + 覆盖率 ``` 按工作类型选择组合： | 工作类型 | 推荐组合 | |----------|---------| | 新功能 | `/ecc:feature-dev` 一条龙 | | Bug 修复 | `/ecc:tdd` → `/ecc:code-review` | | 重构 | `/ecc:plan` → `/ecc:tdd` → `/ecc:code-review` | | 安全相关 | 任何组合 + `/ecc:security-review` | | 最终验证 | `/ecc:verify` | ### 路线 C：PRP 工作流（PRD → 实施 → 提交 → PR） **适合结构化 PRD/migration-plan 等带 Implementation Phases 的文档。** 一条龙自动走完： ``` /prp-plan # 解析 PRD 找到下一个 pending phase，产出完整实施计划 /prp-implement <上一步生成的 plan 路径> # 按计划严格实施 + 验证循环 /prp-commit # 分析变更，起草 conventional commit /prp-pr # 汇总提交生成 PR ``` 特点： - `/prp-plan` 自动检测输入：PRD 文件 → 选下一个 pending phase；自由描述 → 直接规划 - 黄金原则：把实施时可能要搜的所有模式/惯例**提前抓进 plan**，实施阶段不再回去搜 - Windows 原生可用 ### 路线 D：多模型协同 — `/multi-workflow` **Claude 编排 + Codex 后端 + Gemini 前端 的 6 阶段流水线。** 适合全栈功能。 ``` /multi-workflow "add real-time notifications when market resolves" ``` 6 阶段：Research → Ideation → Plan → Execute → Optimize → Review。每阶段通过 `~/.claude/bin/codeagent-wrapper` 并行调用 Codex/Gemini（`run_in_background: true`），用 `TaskOutput` 等结果。外部模型**无文件写权限**，所有修改由 Claude 落盘。 变体：`/multi-plan`（只规划）、`/multi-backend`、`/multi-frontend`、`/multi-execute`。 ### 路线 E：DAG 式并行多 agent — `claude-devfleet` **用独立 git worktree 跑多个 Claude Code agent，按 DAG 依赖自动调度，Windows 原生可用。** 需本地启 DevFleet 服务并通过 MCP 接入： ```bash claude mcp add devfleet --transport http http://localhost:18801/mcp ``` 核心调用（通过 MCP tool）： ``` plan_project(prompt="Build a REST API with auth and tests") → 返回 project_id + 一系列 missions（含 depends_on 链、auto_dispatch=true） dispatch_mission(mission_id=) → 根 mission 启动，后续 mission 在依赖满足时自动派发 get_mission_status / get_dashboard / get_report → 监控与汇报 ``` 特点： - 每个 mission 在独立 worktree 中运行，完成后自动 merge - 默认最多 3 个并发 agent（`DEVFLEET_MAX_AGENTS` 可配） - 合并冲突时留在 worker 分支手动处理 - 长任务建议用 `get_mission_status` 轮询（30-60 秒间隔），避免用 `wait_for_mission` 阻塞会话 ### 路线 F：会话内并行 — Agent 工具 + worktree 隔离 **当前会话里直接 spawn 多个子代理，`isolation: "worktree"` 参数自动建临时 worktree，Windows 原生可用。** 不需要 tmux、不需要外部服务。 主代理调用示例（Claude 自身能用）： ``` 并行 3 个子 agent： - subagent_type: general-purpose, isolation: worktree, prompt: "迁移 module X" - subagent_type: general-purpose, isolation: worktree, prompt: "迁移 module Y" - subagent_type: csharp-reviewer, prompt: "审查 module X/Y 结果" ``` 适合：互相独立的迁移任务、并行审查、互不冲突的多模块改造。不适合：跨模块强耦合、需要相互看到中间状态的任务。 ### 路线 G：外部 tmux + worktree 脚本 — `scripts/orchestrate-worktrees.js` **ECC 自带的长周期/跨 harness 编排助手。需要 tmux（Linux/macOS/WSL）。** ```bash node scripts/orchestrate-worktrees.js plan.json --execute ``` `plan.json` 结构： ```json { "sessionName": "skill-audit", "baseRef": "HEAD", "seedPaths": ["scripts/helper.js", ".claude/plan/spec.md"], "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}", "workers": [ {"name": "docs-a", "task": "Fix skills 1-4."}, {"name": "docs-b", "task": "Fix skills 5-8."} ] } ``` 自动完成：每 worker 一个分支+worktree、覆盖 `seedPaths` 中的本地脏文件、写 `.orchestration//` 下的 task/handoff/status 文件、启动 tmux 会话挂 panes。 状态快照：`node scripts/orchestration-status.js `。 ### 路线 H：全项目多阶段 — GSD GSD（Get Shit Done）是 ECC 集成的项目级编排系统，Windows 原生可用。 **安装：** ```bash npx get-shit-done-cc@latest ``` **单阶段执行：** ``` /gsd:discuss-phase 1 # 讨论实现决策 /gsd:plan-phase 1 # 研究 + 规划 + 验证 /gsd:execute-phase 1 # 按 wave 并行执行 /gsd:verify-work 1 # 验收测试 /gsd:ship 1 # 创建 PR ``` **全自动执行：** ``` /gsd:autonomous # 执行所有剩余阶段 /gsd:autonomous --from 6 # 从阶段 6 开始 ``` **GSD 完整生命周期：** ``` /gsd:new-project # 初始化（研究 → 需求 → 路线图） /gsd:plan-phase 1 # 规划阶段 1 /gsd:execute-phase 1 # 执行 /gsd:verify-work 1 # 验收 /gsd:next # 自动推进到下一步 ... 重复 ... /gsd:complete-milestone # 归档并打 tag /gsd:new-milestone # 开始下一个版本 ``` --- ## 迁移对照表 | 旧命令 | 新命令 | 说明 | | ---------------------------------- | --------------------------------------------- | ------------------------ | | `/ecc:orchestrate feature "desc"` | `/ecc:feature-dev "desc"` 或 `/prp-plan`+`/prp-implement` | 单功能全流程 | | `/ecc:orchestrate bugfix "desc"` | `/ecc:tdd` + `/ecc:code-review` | 先写失败测试再修 | | `/ecc:orchestrate refactor "desc"` | `/ecc:plan` + `/ecc:tdd` + `/ecc:code-review` | 先规划再重构 | | `/ecc:orchestrate security "desc"` | 任何路线 + `/ecc:security-review` | 加安全审查 | | 多阶段自动执行 | `/gsd:autonomous` | GSD 接管 | | 并行编排（tmux） | `claude-devfleet` MCP 或 Agent+worktree | Windows 原生替代 | | PRD → 实施 | `/prp-plan ` → `/prp-implement` | 自动解析 phases | | 多模型协同 | `/multi-workflow` | Codex+Gemini+Claude | ## CLAUDE.md 更新 项目 CLAUDE.md 中 Step 2 应从： ```markdown | New feature | `/ecc:orchestrate feature` | ``` 改为： ```markdown | New feature | `/ecc:feature-dev ` | | Bug fix | `/ecc:tdd` then `/ecc:code-review` | | Refactor | `/ecc:plan` then `/ecc:tdd` then `/ecc:code-review` | | Full phase | `/gsd:execute-phase N` | | All phases | `/gsd:autonomous` | ``` --- ## Windows 可用性总结 | 方案 | Windows | 原理 | |------|---------|------| | `/ecc:feature-dev` | 可用 | Claude Code 内部，不依赖外部工具 | | `/ecc:plan` + `/ecc:tdd` + ... | 可用 | 同上 | | `/prp-plan` / `/prp-implement` / `/prp-commit` / `/prp-pr` | 可用 | 全部 Claude Code 内部 | | `/multi-workflow` (含 Codex/Gemini) | 可用 | 需装 codeagent-wrapper，不依赖 tmux | | `/gsd:autonomous` | 可用 | 用 Claude Code Task tool 做并行 | | Agent 工具 + `isolation: "worktree"` | 可用 | 原生 git worktree，不依赖 tmux | | `claude-devfleet` (MCP) | 可用 | HTTP MCP 接入，worker 在独立 worktree | | `/ecc:orchestrate` | **不可用** | Legacy，底层依赖 tmux | | `dmux-workflows` | **不可用** | 需要 tmux（除非 WSL） | | `scripts/orchestrate-worktrees.js` | **WSL 可用** | 建 tmux session 挂 panes | | `auto-pilot.sh` 脚本 | 可用 | Git Bash，每阶段独立 `claude -p` | --- ## 一张表选编排方式 | 我要... | 选 | 入口 | |---------|-----|------| | 规划单个功能，确认后再写 | `/plan` | 命令 | | 单功能全流程（含 TDD+审查） | `/ecc:feature-dev` | 命令 | | 已有 PRD/migration-plan 带 phases | `/prp-plan ` → `/prp-implement` | 命令 | | 前后端都动（Codex/Gemini 辅助） | `/multi-workflow` | 命令 | | 会话内并行几个独立任务 | Agent 工具 + `isolation: worktree` | 主代理直接 spawn | | DAG 调度多 worker 自动合并 | `claude-devfleet` | MCP | | 整个项目/多 milestone 生命周期 | `/gsd:new-project` → `/gsd:autonomous` | 命令 | | 无人值守长时间跑 | `autonomous-agent-harness` + crons | MCP scheduled-tasks | | 定时重复同一个任务 | `/loop-start ` | 命令 | | 跨 harness 长周期编排（Linux/WSL） | `scripts/orchestrate-worktrees.js` | 脚本 | --- ## 什么时候需要外部脚本 大部分情况下 Claude Code 自己编排（`/ecc:feature-dev` 或 GSD）就够了。外部脚本（`auto-pilot.sh`）只在以下场景有价值： 1. **上下文窗口不够** — 一个 phase 太大，塞不进单次会话 2. **无人值守** — 睡觉前启动，醒来看结果 3. **消除作者偏见** — Reviewer 必须在不同会话（Santa Method） 4. **可审计** — 每步有独立日志文件 ## Related - [[Autonomous Agent Harness 自主代理框架]] - [[Autonomous Loops 自主循环模式]] - [[dmux 多Agent并行编排]] - [[Everything Claude Code 完整指南]] - [[GSD 方法论与最佳实践]]