name: bmad-orchestrator description: 协调BMAD工作流程，为结构化的AI驱动开发提供支持。在项目中初始化BMAD时使用，检查工作流程状态，或在四个阶段（分析、规划、解决方案、实施）之间进行路由。管理项目配置，跟踪项目级别0-4的进度，并与专业工作流程协调。在/workflow-init、/workflow-status触发时或用户需要BMAD设置时触发。 allowed-tools: 读、写、编辑、Bash、Glob、Grep、TodoWrite

BMAD Orchestrator

目的： BMAD方法（突破性方法为敏捷AI驱动开发）的核心协调器，管理工作流程，跟踪状态，并根据项目状态引导用户通过结构化的开发阶段。

何时使用此技能

当：

用户请求/workflow-init或/init - 在项目中初始化BMAD
用户请求/workflow-status或/status - 检查进度并获得建议
用户提到"BMAD设置"或"开始BMAD工作流程"
项目需要结构化的开发方法
需要在多个开发阶段之间进行协调

核心职责

项目初始化 - 设置BMAD目录结构和配置
状态跟踪 - 监控四个开发阶段的进度
工作流程路由 - 根据项目状态指导用户进行适当的下一步操作
进度管理 - 维护工作流程状态和完成跟踪

BMAD方法概述

4个开发阶段

分析（可选）- 研究、头脑风暴、产品简介
规划（必需）- 基于项目复杂度的PRD或技术规范
解决方案（条件）- 中等+项目架构设计
实施（必需）- 冲刺计划、故事、开发

项目级别

级别0： 单个原子更改（1个故事）- 快速修复、小调整
级别1： 小功能（1-10个故事）- 单个功能添加
级别2： 中等功能集（5-15个故事）- 多个相关功能
级别3： 复杂集成（12-40个故事）- 系统集成
级别4： 企业扩展（40+个故事）- 大型项目

按级别规划要求：

级别0-1：需要技术规范，PRD可选/推荐
级别2+：需要PRD，技术规范可选
级别2+：需要架构

可用命令

/workflow-init或/init

在当前项目中初始化BMAD结构。

步骤：

创建目录结构：

bmad/
├── config.yaml
└── agent-overrides/

docs/
├── bmm-workflow-status.yaml
└── stories/

.claude/commands/bmad/ (如果不存在)

收集项目信息：
- 项目名称
- 项目类型（web-app、mobile-app、api、game、library、其他）
- 项目级别（0-4）
使用config.template.yaml创建项目配置
根据级别创建工作流状态文件，条件要求：
- 使用工作流状态模板
- 设置PRD：如果级别>=2，则必需，否则推荐
- 设置技术规范：如果级别<=1，则必需，否则可选
- 设置架构：如果级别>=2，则必需，否则可选
显示初始化摘要并推荐下一个工作流程
提供开始推荐工作流程的选项

示例交互：

用户：/workflow-init

协调器：我将为您的项目初始化BMAD。
[收集信息，创建文件...]

✓ BMAD方法初始化完成！

项目：MyApp
类型：web-app
级别：2（中等功能集）

配置：bmad/config.yaml
状态跟踪：docs/bmm-workflow-status.yaml

推荐下一步：使用/product-brief创建产品简介
这将帮助定义您的产品愿景和需求。

您是否想开始使用/product-brief？

/workflow-status或/status

检查项目状态并获得下一步建议。

步骤：

加载项目配置（bmad/config.yaml）
加载工作流状态（docs/bmm-workflow-status.yaml）
确定当前阶段和推荐的工作流程
显示具有视觉指示器的状态
提供执行推荐工作流程的选项

状态指示器：

✓ = 已完成（显示文件路径）
⚠ = 必需但未开始
→ = 当前阶段
- = 可选/不需要

示例交互：

用户：/status

协调器：正在检查您的项目状态...

项目：MyApp（Web应用程序，级别2）

✓ 第1阶段：分析
  ✓ product-brief (docs/product-brief-myapp-2025-01-11.md)

→ 第2阶段：规划 [当前]
  ⚠ prd（必需 - 未开始）
  - tech-spec（可选）

第3阶段：解决方案
  - architecture（必需）

第4阶段：实施
  - sprint-planning（必需）

推荐下一步：使用/prd命令创建PRD

您是否想运行/prd创建您的PRD？

如果项目未初始化：

通知用户未检测到BMAD
提供运行/workflow-init的选项

工作流程路由逻辑

确定项目状态后，将用户路由到专业工作流程：

分析工作流程： /product-brief、/brainstorm、/research
规划工作流程： /prd、/tech-spec
UX工作流程： /create-ux-design
架构工作流程： /architecture
冲刺工作流程： /sprint-planning、/create-story
开发工作流程： /dev-story、/code-review

推荐逻辑：

如果没有产品简介且项目新→推荐：/product-brief
如果产品简介完成，没有PRD/技术规范：
- 级别0-1 → 推荐：/tech-spec
- 级别2+ → 推荐：/prd
如果PRD/技术规范完成，没有架构，级别2+ → 推荐：/architecture
如果规划完成 → 推荐：/sprint-planning
如果冲刺活跃 → 推荐：/create-story或/dev-story

查看REFERENCE.md了解详细的路由逻辑。

配置文件

项目配置（bmad/config.yaml）

project_name: "MyApp"
project_type: "web-app"  # web-app, mobile-app, api, game, library, other
project_level: 2         # 0-4
output_folder: "docs"
communication_language: "English"

工作流状态（docs/bmm-workflow-status.yaml）

跟踪每个工作流的完成状态，状态值：

“optional” - 可以跳过
“recommended” - 强烈建议
“required” - 必须完成
“{file-path}” - 已完成（显示输出文件）
“skipped” - 明确跳过

查看templates/config.template.yaml了解完整模板。

辅助脚本

通过Bash工具执行：

init-project.sh - 自动化项目初始化

bash scripts/init-project.sh --name "MyApp" --type web-app --level 2

check-status.sh - 显示当前工作流状态
```
bash scripts/check-status.sh
```

validate-config.sh - 验证YAML配置

bash scripts/validate-config.sh bmad/config.yaml

查看脚本文档了解详细信息。

错误处理

配置缺失：

建议/workflow-init
解释BMAD未初始化

无效YAML：

显示错误位置
提供修复或重新初始化的选项

模板缺失：

使用内联回退
日志警告
继续操作

状态文件不一致：

根据项目级别验证
提供重新生成的选项

与其他技能的集成

此协调器与专业的BMAD技能协调：

bmad-analyst - 分析阶段工作流程
bmad-planner - 规划阶段工作流程
bmad-architect - 架构设计
bmad-sprint-master - 冲刺和故事管理
bmad-developer - 开发工作流程

路由到这些技能时，传递上下文：

当前项目配置
工作流状态
项目级别
输出文件夹位置

令牌优化

使用脚本自动化重复任务
参考REFERENCE.md了解详细逻辑
仅在需要时加载文件
保持状态显示简洁
将详细工作委托给专业技能

子代理策略

此技能利用并行子代理最大化上下文利用（每个代理有200K令牌）。

工作流状态检查工作流

模式： 扇出研究 代理： 3-4个并行代理

代理	任务	输出
代理1	检查项目配置并验证结构	bmad/outputs/config-status.md
代理2	分析工作流状态文件和阶段完成情况	bmad/outputs/workflow-status.md
代理3	扫描docs目录以完成工件	bmad/outputs/artifacts-status.md
代理4	根据项目级别生成建议	bmad/outputs/recommendations.md

协调：

使用共享项目上下文启动所有代理
每个代理将状态发现写入指定输出
主上下文将结果综合成统一状态报告
显示视觉状态指示器和下一步操作

项目初始化工作流

模式： 平行部分生成 代理： 3个并行代理

代理	任务	输出
代理1	创建目录结构并验证路径	bmad/outputs/directory-setup.md
代理2	从模板生成项目配置	bmad/config.yaml
代理3	根据级别生成工作流状态文件	docs/bmm-workflow-status.yaml

协调：

从用户处收集项目信息（顺序）
启动并行代理以创建结构和配置
主上下文验证所有输出并显示摘要

示例子代理提示

任务：分析工作流状态并确定当前阶段
上下文：读取bmad/config.yaml和docs/bmm-workflow-status.yaml
目标：识别完成的工作流、当前阶段和下一步所需工作
输出：将分析写入bmad/outputs/workflow-status.md

交付物：
1. 已完成工作流的列表及文件路径
2. 当前阶段确定
3. 必需与可选下一步工作流
4. 阻塞问题或缺失依赖

约束：
- 使用项目级别确定要求
- 标记状态文件中的任何不一致性

Claude的注释

这是BMAD工作流的入口点
在操作之前始终检查项目是否已初始化
维护基于阶段的进展（不要跳过必需的阶段）
使用TodoWrite进行多步骤初始化
保持响应集中且可操作
将详细工作移交给专业技能以进行详细工作流
在完成工作流后更新工作流状态

快速参考

详细的路由逻辑：REFERENCE.md
工作流阶段：resources/workflow-phases.md
配置模板：templates/config.template.yaml
初始化脚本：scripts/init-project.sh
状态脚本：scripts/check-status.sh