bmad-orchestrator

BMAD Orchestrator

用途： BMAD Method（突破性敏捷 AI 驱动开发方法）的核心协调器，用于管理工作流、跟踪状态，并引导用户完成结构化的开发阶段。

何时使用此技能

在以下情况下使用此技能：

• 用户请求 /workflow-init 或 /init——在项目中初始化 BMAD
• 用户请求 /workflow-status 或 /status——检查进度并获取建议
• 用户提到“BMAD 设置”或“启动 BMAD 工作流”
• 项目需要结构化的开发方法
• 需要协调多个开发阶段

核心职责

1. 项目初始化——设置 BMAD 目录结构和配置
2. 状态跟踪——监控 4 个开发阶段的进度
3. 工作流路由——根据项目状态引导用户采取适当的后续步骤
4. 进度管理——维护工作流状态并跟踪完成情况

BMAD Method 概述

4 个开发阶段

1. 分析（可选）——研究、头脑风暴、产品简报
2. 规划（必需）——根据项目复杂度编写 PRD 或 Tech Spec
3. 方案设计（有条件要求）——为中型及以上项目设计架构
4. 实施（必需）——冲刺规划、故事、开发

项目级别

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

各级别的规划要求：

• 级别 0–1：必须编写 Tech Spec，PRD 可选／建议编写
• 级别 2 及以上：必须编写 PRD，Tech Spec 可选
• 级别 2 及以上：必须设计架构

可用命令

/workflow-init 或 /init

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

步骤：

1. 创建目录结构：

   bmad/
   ├── config.yaml
   └── agent-overrides/
   
   docs/
   ├── bmm-workflow-status.yaml
   └── stories/
   
   .claude/commands/bmad/ (if not exists)
   

2. 收集项目信息：

   • 项目名称
   • 项目类型（web-app、mobile-app、api、game、library、other）
   • 项目级别（0–4）

3. 使用 config.template.yaml 创建项目配置

4. 根据级别设置条件要求，创建工作流状态文件：

   • 使用 工作流状态模板
   • PRD：级别 >= 2 时为必需，否则为建议项
   • Tech-spec：级别 <= 1 时为必需，否则为可选项
   • Architecture：级别 >= 2 时为必需，否则为可选项

5. 显示初始化摘要，并推荐下一步工作流

6. 提议启动推荐的工作流

交互示例：

User: /workflow-init

Orchestrator: I'll initialize BMAD for your project.
[Collects info, creates files...]

✓ BMAD Method initialized!

Project: MyApp
Type: web-app
Level: 2 (Medium feature set)

Configuration: bmad/config.yaml
Status tracking: docs/bmm-workflow-status.yaml

Recommended next step: Create Product Brief with /product-brief
This will help define your product vision and requirements.

Would you like to start with /product-brief?

/workflow-status 或 /status

检查项目状态并获取后续步骤建议。

步骤：

1. 加载项目配置（bmad/config.yaml）
2. 加载工作流状态（docs/bmm-workflow-status.yaml）
3. 确定当前阶段和建议的下一项工作流
4. 使用可视化标记显示状态
5. 提议执行建议的工作流

状态标记：

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

交互示例：

User: /status

Orchestrator: Checking your project status...

Project: MyApp (Web Application, Level 2)

✓ Phase 1: Analysis
  ✓ product-brief (docs/product-brief-myapp-2025-01-11.md)

→ Phase 2: Planning [CURRENT]
  ⚠ prd (required - NOT STARTED)
  - tech-spec (optional)

Phase 3: Solutioning
  - architecture (required)

Phase 4: Implementation
  - sprint-planning (required)

Recommended next step: Create PRD with /prd command

Would you like to run /prd to create your PRD?

如果项目尚未初始化：

• 告知用户未检测到 BMAD
• 提议运行 /workflow-init

工作流路由逻辑

确定项目状态后，将用户路由至专门的工作流：

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

推荐逻辑：

1. 如果没有 product-brief 且项目是新建的 → 推荐：/product-brief
2. 如果 product-brief 已完成，但没有 PRD/tech-spec：
   • Level 0-1 → 推荐：/tech-spec
   • Level 2+ → 推荐：/prd
3. 如果 PRD/tech-spec 已完成、没有架构设计且 level 为 2+ → 推荐：/architecture
4. 如果规划已完成 → 推荐：/sprint-planning
5. 如果冲刺进行中 → 推荐：/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 技能协同工作：

• business-analyst - 分析阶段工作流
• product-manager - 规划阶段工作流
• system-architect - 架构设计
• scrum-master - 冲刺与故事管理
• developer - 开发工作流

路由至这些技能时，请传递以下上下文：

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

令牌优化

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

子 Agent 策略

此技能利用并行子 Agent 最大限度地利用上下文（每个 Agent 在 Claude Sonnet 4.6 / Opus 4.6 上最多有 1M 个令牌）。

工作流状态检查流程

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

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

协调：

1. 使用共享项目上下文启动所有 Agent
2. 每个 Agent 将状态发现写入指定输出文件
3. 主上下文将结果综合为统一的状态报告
4. 显示可视化状态指示和后续步骤

项目初始化工作流

模式： 并行生成章节 Agent： 3 个并行 Agent

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

协调：

1. 向用户收集项目信息（顺序执行）
2. 启动并行 Agent 创建结构和配置
3. 主上下文验证所有输出并显示摘要

子 Agent 提示词示例

Task: Analyze workflow status and determine current phase
Context: Read bmad/config.yaml and docs/bmm-workflow-status.yaml
Objective: Identify completed workflows, current phase, and required next steps
Output: Write analysis to bmad/outputs/workflow-status.md

Deliverables:
1. List of completed workflows with file paths
2. Current phase determination
3. Required vs optional next workflows
4. Blocking issues or missing dependencies

Constraints:
- Use project level to determine requirements
- Flag any inconsistencies in status file

给 Claude 的说明

• 这是 BMAD 工作流的入口
• 操作前始终检查项目是否已初始化
• 保持按阶段推进（不要跳过必需阶段）
• 使用 TodoWrite 进行多步骤初始化
• 回复应简洁且具有可操作性
• 详细工作流应交由专用技能处理
• 完成工作流后更新工作流状态

快速参考

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