用途
workflow-orchestrator 用于执行复杂功能实现的五阶段工作流，强调测试驱动开发（TDD）和分阶段质量门禁。它适合新功能、复杂实现、耗时超过 2 小时、涉及多文件更改或需要 TDD 流程的任务。不适用于 bug 修复（应使用 bugfix-quick）、快速重构（直接编辑）、配置更改（直接编辑）或简单问题（直接回答）。
主要能力
- 五阶段流程：依次为理解与设计、编写失败测试（RED）、实现通过测试（GREEN）、重构与审查、最终交付。每阶段有主导智能体、交付物和门禁规则。
- 两次审批门：仅在阶段 1（设计）和阶段 3（实现）需要用户审批；其余阶段在无阻塞时自动继续。
- TDD 强制：阶段 2 必须写出先失败的测试，若测试通过则停止；阶段 3 写最少代码使测试通过；阶段 4 重构后测试仍须通过，否则回退重构。
- 快速通道模式：用户提供完整规格时跳过阶段 1，自动执行阶段 2 至 5，不设审批门，仅在出错时停止。触发方式包括
fasttrack: <specs>、workflow:fasttrack <file>或 "just build it"。 - 协作规划（仅深度任务）：阶段 1 可启用三视角（Builder、Breaker、User）独立分析、交叉评审、模拟用例并由 PM 收敛方案。
- 智能体团队模式（实验性）：需启用
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1且任务为深度复杂度并涉及 2 个以上领域（各领域评分≥50）时激活；否则回退到顺序执行或子智能体模式。 - 状态管理：支持
workflow:handoff保存状态到.claude/logs/workflows/[workflow-id]/，workflow:resume <workflow-id>恢复，workflow:status查看状态。 - Token 预算控制：每阶段设定最大 token 预算（阶段1 2000、阶段2 1500、阶段3 2500、阶段4 1000、阶段5 500），总量目标 ≤30K；在 75%、85%、90% 消耗时分别警告、建议交接、强制交接。
使用方式
- 执行前置检查：运行 agent-detector 选择主导智能体（强制），运行 project-context-loader 加载约定（强制），在响应开头显示智能体横幅，验证任务复杂度，并在阶段 1 前提出澄清问题。
- 启动工作流，例如
workflow:start Add user authentication with JWT。 - 在阶段 1 和阶段 3 审批门处使用
approve/yes继续，reject: <reason>先头脑风暴再重做，modify: <changes>调整交付物，stop/cancel结束并保存状态。 - 按需加载各阶段指南文件（
docs/phases/PHASE_*.MD），一次只加载一个；项目上下文在工作流开始时加载一次。 - 在阶段转换时遵循门禁规则，禁止从阶段 1 直接跳到阶段 3、无阶段 2 直接进入阶段 3、或在测试失败时完成阶段 5；任何跳过需用户明确要求并记录原因。
适用场景
- 新功能开发，尤其是多文件、需 TDD 的复杂实现。
- 已有完整规格说明、希望快速自动执行的场景（快速通道）。
- 深度复杂且跨多个领域的任务（可启用智能体团队模式）。
限制
- 不用于简单 bug 修复、快速重构、配置更改或简单问答。
- 快速通道要求规格包含六个部分（概述、需求、技术设计、API/接口、数据模型、验收标准），缺失时需用户补充。
- 自动停止条件包括：阶段 2 测试意外通过、阶段 3 三次尝试后测试失败、阶段 4 出现严重安全问题、阶段 5 覆盖率低于 80%、或任意阶段达到 token 限制。
- 智能体团队模式为实验性，仅在特定环境变量启用且满足复杂度条件时激活。
- 阶段 5 的通知（如 Slack）和文档更新在未配置或无变更时可自动跳过。
- 关于具体运行环境、安装命令、收费或价格信息，资料未提供。