项目介绍
BMAD Method 用角色、文档和阶段检查组织开发任务。适合需求较多的项目,简单改动仍应按实际范围选择必要流程。
框架把需求、设计、实现与验收分成阶段,角色围绕共同文档工作。价值在于让交接依据清楚,减少复杂项目中前后要求不一致。
适合功能较多、需要持续迭代的项目。小修复可选取必要环节,不必每次生成整套文档。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 需求澄清 | 明确用户行为与范围 |
| 设计规划 | 记录技术方案和约束 |
| 任务拆分 | 形成可独立验证的工作项 |
| 角色协作 | 按职责组织产出 |
| 验收检查 | 核对文档代码与测试 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Skill |
| 分类 | AI 与开发 |
| 项目仓库 | bmad-code-org/BMAD-METHOD |
| 整理日期 | 2026-11-14 |
安装与运行
在自己的开发电脑准备 Node.js 和 Git,在需要使用方法论的项目根目录执行。
1. 安装和初始化
npx bmad-method install
2. 第一次使用
根据安装向导选择当前使用的 AI 开发工具与组件。完成后检查项目内新增文件,在工具中先执行需求澄清,再生成小范围实施任务;每个任务写明输入、文件范围和验收条件。
安装前提交或备份现有项目文件。升级时先查看安装器显示的覆盖清单,保留自己修改的工作流与规范;不要在所有项目外层目录一次性安装。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。