bmad-orchestrator – BMAD 工作流编排

何时使用此技能

• 在新项目中初始化 BMAD
• 检查和恢复 BMAD 工作流状态
• 在分析、规划、方案设计、实施各阶段之间路由工作
• 管理阶段间的结构化交接

安装

npx skills add https://github.com/supercent-io/skills-template --skill bmad-orchestrator

Codex 使用说明

bmad-orchestrator 的默认执行路径是 Claude Code。
为了直接在 Codex 中运行相同的流程，我们建议通过更高级别的编排路径（如 omx/ohmg）来操作 BMAD 阶段。

控制模型

BMAD 阶段路由应使用与 JEO 相同的三层抽象来处理：

• settings：平台特定的运行时配置，例如 Claude 钩子、Codex/Gemini 指令和 MCP 设置
• rules：阶段约束，例如“在当前阶段文档获得批准之前不得进入下一阶段”和“不得重新打开未更改的阶段文档进行审查”
• hooks：平台回调，例如 Claude 的 ExitPlanMode、Codex 的 notify 或 Gemini 的 AfterAgent

对于 BMAD 阶段关卡，预期的规则是严格的：

• 在继续前进之前审查当前阶段文档
• 如果自上次最终审查结果以来文档哈希值未更改，则不要重新启动 plannotator
• 只有修订后的文档才能重置关卡并允许另一轮审查周期

BMAD 执行命令

平台支持状态（当前）

仅通过此技能 是否可行：

• Gemini CLI/Claude Code：是
• OpenCode/Codex：是（通过编排）

在您的 AI 会话中使用以下命令：

/workflow-init
/workflow-status

典型流程：

1. 运行 /workflow-init 以引导 BMAD 配置。
2. 按顺序进行各个阶段：分析 -> 规划 -> 方案设计 -> 实施。
3. 随时运行 /workflow-status 以检查当前阶段和进度。

快速参考

plannotator 集成（阶段审查关卡）

每个 BMAD 阶段都会生成一个关键文档（产品需求文档、技术规格、架构）。在进入下一阶段之前，请使用 plannotator 审查该文档，并将其自动保存到 Obsidian。

为什么在 BMAD 中使用 plannotator？

• 质量关卡：在锁定阶段交付物之前，批准或请求更改
• Obsidian 存档：每个已批准的阶段文档都会自动保存，包含 YAML 前置元数据和 [[BMAD 计划]] 反向链接
• 团队可见性：共享 plannotator 链接，以便利益相关者在开始实施前对产品需求文档/架构进行标注

阶段审查模式

完成任何阶段文档后，提交审查：

# 在 /prd → docs/prd-myapp-2026-02-22.md 创建后
bash scripts/phase-gate-review.sh docs/prd-myapp-2026-02-22.md "产品需求文档审查：myapp"

# 在 /architecture → docs/architecture-myapp-2026-02-22.md 创建后
bash scripts/phase-gate-review.sh docs/architecture-myapp-2026-02-22.md "架构审查：myapp"

或者直接在 AI 会话中提交计划：

# 在 Claude Code 中，/prd 完成后：
planno — 在我们进入阶段 3 之前审查产品需求文档

智能体将打开 plannotator UI 进行审查。在 Claude Code 中：调用 EnterPlanMode → 编写计划 → 调用 ExitPlanMode（钩子会自动触发）。在 OpenCode 中，submit_plan 插件工具可直接使用。

阶段关卡流程

/prd 完成 → docs/prd-myapp.md 创建
       ↓
 bash scripts/phase-gate-review.sh docs/prd-myapp.md
       ↓
 哈希保护检查此确切文档是否已被审查
       ↓
 哈希未变？是 → 保留之前的最终结果，不重新打开 UI
       ↓ 否
 plannotator UI 在浏览器中打开
       ↓
  [批准]              [请求更改]
       ↓                        ↓
 Obsidian 保存         智能体修订文档
 bmm-workflow-status    重新提交审查
 自动更新
       ↓
 /architecture（阶段 3）

Obsidian 保存格式

已批准的阶段文档将保存到您的 Obsidian 仓库中，包含：

---
created: 2026-02-22T22:45:30.000Z
source: plannotator
tags: [bmad, phase-2, prd, myapp]
---

[[BMAD 计划]]

# 产品需求文档：myapp
...

快速参考