核心用法
bmad-orchestrator 是 BMAD（Breakthrough Method of Agile AI Driven Development）方法论的中央编排器，负责协调 OpenClaw 与 Claude Code 之间的四阶段开发工作流：
- Phase 1-3（人机交互阶段）：在 OpenClaw 中与用户深度协作，完成头脑风暴、产品简报、PRD撰写、架构设计等需要人类判断的关键决策
- Party Mode（多代理辩论）：在关键决策点触发 Claude Code 的多代理辩论模式，让分析师、架构师、PM、开发等角色交叉验证方案
- Phase 4（自动化执行）：通过 tmux 将实施阶段委托给 Claude Code 自动完成代码生成、测试、Code Review 和提交
状态追踪依赖 _bmad-output/orchestrator-state.yaml 文件，实现跨会话的持久化工作流管理。
显著优点
- 人机分工明确：创意决策保留给人，重复执行交给 AI，避免"AI 包办一切"的盲目性或"全人工"的低效
- 多代理辩论机制：Party Mode 模拟真实团队的认知多样性，能提前暴露盲区、验证假设
- 无缝跨工具编排：打通 OpenClaw（交互层）与 Claude Code（执行层），通过 tmux 实现真正的自动化流水线
- 状态可恢复：YAML 状态文件支持随时中断、随时恢复的长周期项目管理
- 灵活裁剪：提供 Quick Flow 模式，小项目可跳过完整流程快速交付
潜在局限
- 基础设施依赖重：要求预配置 Claude Code、tmux、SSH 访问的开发 VM，以及
_bmad/框架目录，冷启动成本高 - 学习曲线陡峭：BMAD 方法论本身需要理解，加上 tmux 操作细节，新用户上手需要时间
- Phase 4 黑盒风险：自动化实施阶段用户参与度骤降，若前期文档质量不足，可能导致方向偏离却难以及时发现
- 网络/SSH 单点故障：tmux 会话依赖稳定的 SSH 连接，网络波动可能中断自动化流水线
- Party Mode 成本敏感：频繁调用多代理辩论会显著消耗 Token，需权衡验证深度与成本
适合人群
- 软件架构师、技术负责人需要系统化方法管理复杂项目全生命周期
- AI 辅助开发重度用户，希望将 Claude Code 从"聊天工具"升级为"自动化工程队友"
- 团队已具备 BMAD 方法论基础，需要工具层支撑标准化落地
- 有明确 DevOps 能力，能维护 tmux/SSH/VM 基础设施的技术团队
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **前期文档债务** | Phase 1-3 若敷衍完成，Phase 4 自动化会放大错误 | 严格执行 Readiness Check 门控 |
| **环境漂移** | VM 配置与本地开发环境不一致导致构建失败 | 在 Phase 3 架构设计中明确环境基线 |
| **自动化失控** | tmux 发送命令失败后未检测，导致状态机错乱 | 实施前验证 `capture-pane` 可靠性 |
| **权限泄露** | project-context.md 可能包含敏感配置 | 对 `_bmad-output/` 目录启用加密或访问控制 |