rzlog
BMAD Method 研究：安装、使用与命令大全
rzlog Lv1
  2026-03-31 00:00:00   2026-03-31 03:29:10  

BMAD Method 这两个月被不少 AI 编程用户反复提到，但很多人第一次接触时都会有同一个困惑：它到底是一个命令行工具、一个提示词包，还是一套完整的方法论？

这篇文章把它一次讲清楚，包括它是什么、适合什么场景、怎么安装、安装后怎么用，以及一份可以直接收藏的命令速查表。文末的命令名优先按我本地已安装环境核对，适合拿来直接上手。

BMAD Method 是什么

BMAD Method 可以理解为一套面向 AI 协作开发的软件交付方法。

它不是单纯让模型“直接写代码”，而是把一个项目拆成分析、规划、架构、故事拆分、实现、评审、回顾这些阶段，然后通过不同的技能和工作流逐步推进。你既可以把它看成“AI 研发流程操作系统”，也可以把它看成“把聊天式开发变成项目式开发”的框架。

它的核心价值主要有三个：

  1. 把模糊想法逐步沉淀成 PRD、架构文档、Epic、Story 和实现产物。
  2. 用标准化工作流减少多轮 AI 协作时的上下文漂移。
  3. 用 _bmad/ 和 _bmad-output/ 这两类目录保存方法配置与项目产物。

它适合什么场景

如果你只是改一个按钮文案、修一个接口字段、补一个简单脚本，其实没必要把流程拉满，直接让 AI 干活就够了。

BMAD 更适合下面几类事情：

  • 你要从 0 到 1 做一个产品、模块或中型系统。
  • 你希望先把需求、边界和架构想清楚，再让 AI 执行。
  • 你准备长期让 AI 参与开发，而不是只跑一次性对话。
  • 你需要留下可追踪的文档和产物，避免做完就散。

简单说，小任务走 Quick Flow，大任务走 BMAD，治理要求更重的项目再往 Enterprise 路线走。

安装前要准备什么

根据官方安装文档，最基础的前置条件是：

  • Node.js 20+
  • npx
  • 一个准备接入的 AI 开发环境，比如 Claude Code、Cursor 等

如果只是本地试用，最低门槛就是：Node.js 20+ 加一个项目目录。

BMAD Method 怎么安装

1. 交互式安装

这是最适合大多数人的方式：

1
npx bmad-method install

安装过程会引导你选择：

  • 安装目录
  • 要集成的 AI 工具
  • 要安装的模块
  • 是否写入 _bmad/ 和 _bmad-output/

如果你想试预发布版本，可以用：

1
npx bmad-method@next install

如果你想直接安装 GitHub 主分支的最新代码，可以用：

1
npx github:bmad-code-org/BMAD-METHOD install

2. 非交互式安装

如果你想批量初始化项目、写脚本或者做自动化安装，可以直接带参数：

1
npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes

比较常见的参数有：

  • --directory <path>：指定安装目录
  • --modules <modules>：指定模块，例如 bmm,bmb
  • --tools <tools>：指定接入工具，例如 claude-code,cursor
  • --custom-content <paths>：注入自定义模块
  • --yes：跳过确认

安装完成后会生成什么

安装成功后，常见目录大致如下：

1
2
3
4
5
your-project/
├── _bmad/
├── _bmad-output/
├── .claude/
└── .cursor/

重点就两个：

  • _bmad/：方法论、模块配置、技能定义
  • _bmad-output/：规划和实现阶段的输出产物

我本地当前安装配置里，D:\Obsidian\_bmad\bmm\config.yaml 显示版本是 6.2.1，生成时间是 2026-03-24。所以本文后面整理的命令表，也优先以这套本地安装结果为准。

安装后第一步怎么用

很多人装完之后第一反应是问：“然后呢？”

最稳妥的入口不是死记命令，而是先跑：

1
bmad-help

也可以直接带着问题问它：

1
bmad-help 我刚安装完，下一步做什么？

有些环境里会写成：

1
/bmad-help

这里要注意一个细节：

  • bmad-help 是命令主体
  • /bmad-help 往往只是不同宿主环境的唤起形式

也就是说，真正要记的是 bmad-* 这套工作流名字，不是前面的斜杠。

BMAD 的基本使用流程

第一阶段：分析

如果你的想法还比较模糊，先别急着写 PRD，可以先做：

  • 头脑风暴
  • 市场研究
  • 领域研究
  • 技术研究
  • 产品 Brief

这一层的目标是先把问题空间和机会空间讲清楚。

第二阶段：规划

正式进入项目规划后，最常见的是：

  • bmad-bmm-create-prd
  • bmad-bmm-create-ux-design

如果只是一个小工具、小功能或一次性改动，通常没必要强上完整 PRD，可以走 Quick Flow。

第三阶段：解决方案设计

这一层通常是：

  1. 先做架构
  2. 再拆 Epic 和 Story
  3. 再做一次实现准备度检查

对应命令通常是：

  • bmad-bmm-create-architecture
  • bmad-bmm-create-epics-and-stories
  • bmad-bmm-check-implementation-readiness

这一步的意义很大，因为它避免了“还没想清架构就先拆任务”的返工。

第四阶段：实现

真正进入开发时，节奏会变成：

  1. bmad-bmm-sprint-planning
  2. bmad-bmm-create-story
  3. bmad-bmm-dev-story
  4. bmad-bmm-code-review
  5. 必要时 bmad-bmm-qa-automate
  6. 一个阶段结束后 bmad-bmm-retrospective

官方文档也反复强调，复杂工作流尽量分不同聊天执行，避免上下文污染。

命令为什么和官网不完全一样

这是很多人第一次用 BMAD 时最容易懵的一点。

你在官网教程里，常会看到像 bmad-create-prd 这种“通用工作流名”；但在本地安装后，命令清单里往往会出现 bmad-bmm-create-prd 这种“模块前缀版”名字。

可以这样理解：

  • bmad-create-prd 是文档里更抽象、更通用的名字
  • bmad-bmm-create-prd 是当前安装环境真实暴露出来的本地命令

本文下面的命令表，优先使用本地已经核对到的可见命令，所以拿去实操会更稳。

BMAD Method 命令大全

核心入口

  • bmad-help：总导航入口，不知道下一步做什么时先问它。
  • bmad-bmm-generate-project-context：扫描现有项目，生成 AI 长期协作需要遵守的上下文规则。
  • bmad-bmm-document-project：给已有项目补文档，适合接手老项目。
  • bmad-bmm-quick-dev：把澄清、规划、实现和复核压缩在一个快速流程里。
  • bmad-bmm-correct-course：项目中途跑偏时用于纠偏。

分析阶段

  • bmad-brainstorming：围绕一个方向做引导式头脑风暴。
  • bmad-bmm-market-research：市场研究。
  • bmad-bmm-domain-research：行业/领域研究。
  • bmad-bmm-technical-research：技术可行性与方案研究。
  • bmad-bmm-product-brief：先生成产品简报，再决定是否进入完整规划。

规划阶段

  • bmad-bmm-create-prd：创建 PRD。
  • bmad-bmm-validate-prd：检查 PRD 是否完整、清晰、可执行。
  • bmad-bmm-edit-prd：修改现有 PRD。
  • bmad-bmm-create-ux-design：生成 UX 设计方案。

解决方案阶段

  • bmad-bmm-create-architecture：创建技术架构文档。
  • bmad-bmm-create-epics-and-stories：把需求拆成 Epic 和 Story。
  • bmad-bmm-check-implementation-readiness：检查 PRD、UX、架构和故事拆分是否一致。

实现阶段

  • bmad-bmm-sprint-planning：生成冲刺计划。
  • bmad-bmm-sprint-status：查看当前冲刺状态与下一步建议。
  • bmad-bmm-create-story：准备一个可开发的 Story。
  • bmad-bmm-dev-story：执行 Story 开发。
  • bmad-bmm-code-review：代码审查。
  • bmad-bmm-qa-automate：补自动化测试。
  • bmad-bmm-retrospective：阶段回顾。

Core 通用命令

  • bmad-party-mode：让多个 BMAD 角色一起讨论一个问题。
  • bmad-index-docs：给文档目录做轻量索引。
  • bmad-shard-doc：把大文档拆小。
  • bmad-editorial-review-prose：润色文案表达。
  • bmad-editorial-review-structure：优化文档结构。
  • bmad-review-adversarial-general：从“找问题”角度审查内容。
  • bmad-review-edge-case-hunter：专门扫边界条件和遗漏场景。
  • bmad-distillator：把长文档压缩成更适合 AI 消化的高密度版本。

新手上手建议

如果你是第一次接触 BMAD，不要试图一口气背完整个命令表。更实用的方式是记住下面这条路径：

  1. 先安装 bmad-method
  2. 装完先跑 bmad-help
  3. 如果项目大，走 PRD -> 架构 -> Story -> 实现
  4. 如果项目小，优先走 Quick Flow
  5. 每个重工作流尽量新开聊天

对大多数人来说，真正需要记住的只有三个核心入口：

  • bmad-help
  • bmad-bmm-create-prd
  • bmad-bmm-dev-story

总结

BMAD Method 最值得关注的地方，不是它又多了多少命令，而是它把 AI 开发从“想到什么问什么”变成了“按阶段协作、按产物推进”。

如果你已经开始觉得普通聊天式开发在复杂项目里越来越不稳，那 BMAD 确实值得试。它不一定让你第一天就更快，但很可能让你在第三周、第三个模块、第三次返工时，明显感受到差别。

参考链接

 Comments
Comment plugin failed to load
Loading comment plugin
  1. BMAD Method 是什么
  2. 它适合什么场景
  3. 安装前要准备什么
  4. BMAD Method 怎么安装
    1. 1. 交互式安装
    2. 2. 非交互式安装
  5. 安装完成后会生成什么
  6. 安装后第一步怎么用
  7. BMAD 的基本使用流程
    1. 第一阶段：分析
    2. 第二阶段：规划
    3. 第三阶段：解决方案设计
    4. 第四阶段：实现
  8. 命令为什么和官网不完全一样
  9. BMAD Method 命令大全
    1. 核心入口
    2. 分析阶段
    3. 规划阶段
    4. 解决方案阶段
    5. 实现阶段
    6. Core 通用命令
  10. 新手上手建议
  11. 总结
  12. 参考链接
  1. BMAD Method 是什么
  2. 它适合什么场景
  3. 安装前要准备什么
  4. BMAD Method 怎么安装
    1. 1. 交互式安装
    2. 2. 非交互式安装
  5. 安装完成后会生成什么
  6. 安装后第一步怎么用
  7. BMAD 的基本使用流程
    1. 第一阶段：分析
    2. 第二阶段：规划
    3. 第三阶段：解决方案设计
    4. 第四阶段：实现
  8. 命令为什么和官网不完全一样
  9. BMAD Method 命令大全
    1. 核心入口
    2. 分析阶段
    3. 规划阶段
    4. 解决方案阶段
    5. 实现阶段
    6. Core 通用命令
  10. 新手上手建议
  11. 总结
  12. 参考链接