模型 / 数据集
bmad-code-org/BMAD-METHOD avatar
bmad-code-org/BMAD-METHOD

BMad Method 解析:把 Clarify、Plan、Build 和 Learn 串成一条不交出判断的交付链

BMAD-METHOD 是一个免费开源的敏捷 AI 驱动开发框架,其智能体像专家协作者一样引导流程,能根据项目规模从缺陷修复到企业级系统自动调整规划深度。

53,054 个 Star5,992 个 ForkJavaScript许可证因项目而异
GitHub

秒懂

它是什么?
一套面向 AI 驱动开发的敏捷方法实现,用简报、规格与架构把决策显式化并向后传递,安装只需一条 npx 命令。本文按 README 核对交付循环、六个官方模块、网页规划包与商标条款。
适合谁用?
适合已经用上编码代理、但苦于每次对话都要重讲一遍背景的团队,尤其是要做跨多次会话的中型需求,持久上下文这一条能省下最多时间。不适合把流程当银弹的人,README 反复强调判断留在人手里,指望它自动产出正确决策会失望;也不适合连 Node.js 20.12 与 uv 都不愿意装的纯 IDE 用户。
能商用吗?
请先确认。这个仓库使用的许可证不在我们自动归类的范围内,商用前请阅读仓库里的 LICENSE 文件。
还在维护吗?
在维护。仓库最近一次提交在 1 天前。
用什么语言写的?
主要是 JavaScript(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

AiDD 这个缩写想覆盖的范围

仓库对 BMad Method 的完整表述是敏捷的 AI 驱动开发方式,缩写 AiDD 指的不只是写代码这一段,而是整个工作:要构建什么、它怎么组织在一起,以及随着你学到新东西它怎么变化。这个定义有意把规划、架构和事后复盘都圈了进来,与「给编码助手加个提示词模板」拉开了距离。README 还写明它是免费开源的,没有付费墙工作流,也没有设门槛的社区。

项目用 JavaScript 标注,主分支是 main,最近一次推送在 2026 年 8 月 10 日,同一天发布了 v6.11.0,前两个版本是 7 月 3 日的 v6.10.0 和 6 月 22 日的 v6.9.0。版本节奏大致每月一个次版本,处于活跃迭代期,升级到 V6 的迁移指引单独成页。仓库星标在五万以上,开放议题一百二十多个,这个比例说明用户基数大、反馈也多,但 README 没有给出生产采用率、性能数字或安全认证方面的任何信息。

四个入口与那条回到 Plan 的回边

交付循环被拆成几个入口,按你手上东西的清晰度决定从哪进。想法还很模糊时从 Clarify 进,先把需求问清楚;想法已经大而清晰时从 Plan 进,做规划;只是个小改动就直接进 Build and verify,跳过前面的仪式。执行之后是 Learn and adjust,这条边回指 Plan,也就是说复盘的结果会改写下一轮计划,而不是散落在聊天记录里。

README 的态度是「从任何地方开始」,可以端到端用 BMad 跑完整套,也可以只取它的简报、规格和架构文档,带回你现有的交付流程里用。对已有成熟流程的团队来说,这后半句才是真正有用的部分:不换流程,只借产物,改造成本接近于零,也能先验证这套模板是否真的比自己写的文档好用。规模自适应是它的核心主张,同一个方法既能覆盖周末原型,也能覆盖有多年历史的存量系统。

一条 npx 命令背后是三样前置依赖

安装命令确实只有一行,npx bmad-method install。但前置条件有三项:Node.js 20.12 或更高、Python 3.10 或更高,以及 Python 的包管理器 uv。三项里任何一项缺失,安装都会卡住,所以第一次装之前先把环境对齐,尤其是平时只写前端、机器上没有 Python 的人。

装完之后的使用方式写在 README 里:在 AI 编码工具中打开项目,用 bmad-build 加上你想做的改动来调用它,过程中持续做那些真正需要人拍板的决定;拿不准下一步或者想知道哪些环节可以跳过,就跑 bmad-help 要提示。README 没有解释这两条命令内部发生了什么,安装前置条件的完整清单、更新方式、预发布版本以及安装器的实时自动化帮助,都被推到了链接的安装指南里。命令短不代表配置简单,这是读这个项目时最容易低估的一点。

未说出口的假设会变成代码

README 给出的立项理由值得单独拎出来:编码助手在实现环节很有效,但它们经常把没有被说出口的假设直接写成代码。这句话点的是代理式开发的典型失效模式,模型不会说「我这里不确定」,它会选一个看起来最合理的分支继续往下写,等你发现时假设已经固化在三个文件里。

BMad 的应对是让人保留控制权,同时让代理和工作流把重要决策显式化,并作为上下文留传给后续工作。README 列了六项预期行为:按工作量自动调整流程规模;既能从零开始,也能在接手的既有代码库上建立经过核实的上下文再动手;产品与技术决策可以向后传递,不必每次对话重讲;需要时引入产品、架构、UX、开发、测试等专业视角;用结构化工作流与多代理讨论做引导,但不交出判断;以及一条从早期思考贯穿到评审实现、纠正和复盘的交付路径。这些都是设计意图的描述,不是基准测试结果,也没有给出任何对比数据。

五个官方模块各补一块

核心仓库之外,README 列了五个官方模块,每个有独立仓库。BMad Builder 用来构建技能、工作流和代理,属于元工具层,想给自己的业务定制流程时从这里进。BMad Creative Intelligence Suite 提供面向创新、设计思维与叙事的创意伙伴。BMad Test Architect 定位为企业级测试插件,把测试这块单独做成面向企业的能力。

BMad Loop 的描述最激进:无人值守地构建、验证并复盘一整个史诗级任务,这已经接近自主执行的边界,用之前要清楚它会连续改动代码,最好配一个可以随时回滚的分支策略。BMad Game Dev Studio 面向游戏开发,README 点名支持 Unity、Unreal、Godot 和 Phaser。这些模块的安装方式、彼此之间的兼容性以及版本对应关系,README 一概没写,需要各自去仓库核对,别默认装了核心就能直接往上叠加。

把工作流打包成 Gemini Gems 与自定义 GPT

官网 bmadcode.com 上有一项叫 Web bundles 的产品,把选定的 BMad 工作流打包成 Google Gemini Gems 和 ChatGPT 自定义 GPT。用法是先在已有的网页订阅里做规划,再把产出的文档带回 AI 编码工具里实现。

这条路径的意义在于把规划阶段的算力从 IDE 里挪走,适合那些编码工具不带长上下文、或者团队成员只有网页版助手的情况,也适合希望在订阅额度内完成前期推演的人。代价是产物流转靠手工搬运,规划与实现之间的上下文要靠这些文档自己撑住,所以简报和规格的可读性成了整套方法能不能跑通的关键。README 另外链接了工作流图、既有项目接入指南和升级到 V6 的迁移指引,公共路线图也给了链接但没有摘要内容。

MIT 条款旁边那段商标声明

许可证是 MIT,条款本身没有意外:允许使用、复制、修改、合并、发布、分发、再许可和销售副本,条件是版权与许可声明要出现在所有副本或实质性部分中,软件按原样提供、不带任何担保。

需要留意的是附带在许可文本里的商标声明:BMad、BMad Method 和 BMad Core 是 BMad Code, LLC 的商标,使用本软件并不授予把这些商标用于其他目的的许可。实务含义是,你可以自由改代码和内部使用,但拿这些名字去做衍生产品、课程或商业宣传前要先确认边界。社区方面,README 说 BMad 对所有人免费且永远免费,渠道包括 Discord、YouTube、GitHub 的 issue 与讨论区,资金来自 Buy Me a Coffee 与企业赞助,贡献前要求先读一遍 CONTRIBUTORS.md。

编辑结论

适合已经用上编码代理、但苦于每次对话都要重讲一遍背景的团队,尤其是要做跨多次会话的中型需求,持久上下文这一条能省下最多时间。不适合把流程当银弹的人,README 反复强调判断留在人手里,指望它自动产出正确决策会失望;也不适合连 Node.js 20.12 与 uv 都不愿意装的纯 IDE 用户。落地顺序建议是先拿一个小改动走通 bmad-build,确认生成的简报和规格确实能被引擎之外的人读懂,再考虑把 Test Architect 或 Loop 这类模块接进来。

官方来源

  1. Official README
  2. Project repository
  3. Release notes
社区笔记

社区笔记