出的比spec-kit早,也算是spec coding先驱了
一种把"多代理(sub-agents)+敏捷流程"标准化到日常开发里的方法论与开源工具集。核心目标是:先用专职"规划代理"把需求与架构讲清楚,再用"开发代理链"按可执行的故事卡逐步落地,尽量避免上下文丢失与来回扯皮。开源仓库与文档里把流程、角色、产物和命令都做成模板化/脚手架了。
BMAD 的两大核心创新
-
Agentic Planning(代理化规划)
- 专门的代理(Analyst 分析师、PM 产品经理、Architect 架构师)会协作生成详细且一致的 PRD 与架构文档。
- 通过高级提示工程 + 人在回路(human-in-the-loop)方式,确保产物比普通 AI 生成的"模糊任务清单"更严谨、更完整。
-
Context-Engineered Development(上下文工程化开发)
- Scrum Master 代理会把规划文档"编译"成超详细的开发故事文件。
- 每个 Story file 都嵌入了上下文、实现细节、架构指导。
- 开发代理只要打开故事文件,就能明确知道:做什么、怎么做、为什么要这么做。
这种"两阶段流程"解决了 AI 辅助开发里最大的问题:规划不一致 & 上下文丢失。
关键工作流
- 规划工作流(Web UI) :如何创建 PRD 与架构文档。
- 核心开发循环(IDE) :SM、Dev、QA 三个角色通过 Story file 协作。
这两个流程图解释了 90% 的 BMAD 方法逻辑。特别要理解:
- 为什么需要先有 PRD + Architecture;
- 为什么 Story file 不只是"任务分发",而是"上下文传递容器"。
快速开始
IDE 安装(一步命令)
sql
npx bmad-method install
或如果你已经装过:
arduino
git pull
npm run install:bmad
这个命令能处理:
- 首次安装:在项目中设置 BMAD
- 升级:自动更新已有安装
- 扩展包:安装 package.json 声明的扩展包
前提条件
- Node.js v20+
Web 端最快体验(2 分钟)
-
下载全栈团队配置文件(full stack team file)
-
在 Gemini Gem / CustomGPT 中新建一个 AI 代理
-
上传文件并配置提示语:
"你的关键操作指令已附加,请严格遵循,不要打破角色设定"
-
开始对话:输入
*help
或直接调用*analyst
生成 Brief -
在 Web 侧 orchestrator(#bmad-orchestrator)随时提问
👉 当 PRD、Architecture(可选 UX/Brief)准备好后,就可以切到 IDE 中去执行开发循环。
其它方式:克隆 & 构建
arduino
git clone https://github.com/bmad-code-org/BMAD-METHOD.git
npm run install:bmad