BMAD-METHOD 入门完全指南Agile AI 驱动开发的 BMad 方法与模块生态【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMad MethodBMAD-METHODBreakthrough Method for Agile Ai Driven Development是一套开源、免费、MIT 许可的 AI 驱动开发方法论它把AI 驱动开发AiDD从写代码扩展到构建什么、各部分如何衔接、随认知加深如何演进的完整过程并以 agile 方式组织——决策始终显式、上下文跨会话延续、流程按工作量自适应伸缩。本文基于仓库主 READMEREADME_VN.md展开结合安装文档、skill 定义与安装器源码说明其核心理念、快速安装、无头 CI 安装、模块生态与bmad-help智能引导读完即可在自己的新项目或既有代码库中落地这套流程。BMad Method 是什么Agile 风格的 AI 驱动开发传统 AI 工具往往替你做思考产出平庸的结果而 BMad 的专用 agent 与有引导的 workflow 扮演专家协作者角色带领你走过一条有结构的过程把你自己最好的思考与 AI 结合起来。README_VN.md 给出了其核心定义Agile Ai Driven Development——AiDD 覆盖全部工作而不只是代码构建什么what to build、各部分如何保持联系how it holds together、以及当你了解更多之后如何变化how it changes as you learn。BMad Method 是以 agile 方式做 AiDD决策始终显式、上下文被持续保留、流程随工作量自适应伸缩。同一套方法既适用于周末原型也适用于有多年历史的存量系统小改动直接进入构建复杂工作获得它需要的深度。这与仓库交付循环图docs/images/bmad-delivery-loop.svg描述的Clarify → Plan → Build and verify → Learn and adjust一致——你可以在任意环节切入模糊想法从 Clarify 开始、大而清晰的想法从 Plan 开始、小改动直接从 Build 开始。从仓库结构看这套方法论的落地形态是一系列skill存放在 skills/ 目录每个 skill 是包含SKILL.md的目录AI 编码工具按需加载并遵循其中指令每个 skill 所属模块由同目录的module-manifest.toml声明。例如核心入口 skills/bmad/SKILL.md 的 manifestskills/bmad/module-manifest.toml声明了module toolbox、当前版本6.13.0-next、更新源github:bmad-code-org/BMAD-METHOD/skills。为什么选择 BMad MethodREADME_VN.md 列出六大理由对应仓库中真实存在的实现智能 AI 辅助——随时调用bmad-helpskill 获知下一步该做什么。仓库中对应 skills/bmad/SKILL.md它分析当前状态与用户问题回答 BMad 相关问题或推荐下一步该使用的 skill同时识别 setup / update / doctor 三种运维命令并走对应流程。随规模与问题域自适应——自动根据项目复杂度调整规划深度right-sized process。文档 docs/plan/choose-a-planning-path.md 专门讨论一个改动需要多少规划。结构化流程——贯穿分析、规划、架构、实现全过程的 agile 最佳实践。专业化 agent——超过 12 个按角色分工的专家。仓库 skills/ 中实际可见的 agent skill 包括bmad-agent-analyst业务分析师、bmad-agent-pm产品经理、bmad-agent-ux-designerUX 设计师、bmad-agent-architect系统架构师、bmad-agent-dev高级软件工程师等。Party Mode——把多个 persona agent 放进同一会话协作讨论对应 skills/bmad-party-mode/ 模块含mode-agent-team、mode-subagent、party-memory等参考文档。完整生命周期——从想法头脑风暴到交付部署的端到端覆盖。此外 BMad 坚持100% 免费开源无付费墙、无锁定内容、无限制访问的社区门槛。该项目采用 MIT 许可证见 LICENSEBMad 与 BMAD-METHOD 为 BMad Code, LLC 的商标见 TRADEMARK.md。快速开始环境要求与一键安装前置条件README_VN.md 与安装文档 docs/start/install-bmad.md 一致要求依赖版本要求用途Node.jsv20安装器要求 20.12运行npx bmad-method install安装器Python3.10BMad 的 Python 脚本skill 渲染与运行uv最新BMad 安装器与 Python 脚本的包管理器bmad-build、bmad-build-auto等 skill 依赖它渲染/运行 PythonGit推荐安装外部模块或自定义模块时使用AI 编码工具任选Claude Code、Cursor 等支持 skills 的工具用于实际调用已安装的 skill需要说明若缺uv安装器会给出警告但仍完成安装只是依赖uv的 skill 在补齐前无法工作见 docs/start/install-bmad.md 的前置条件说明。交互式安装在目标项目目录下执行npx bmad-method install安装器引导你依次完成选择安装位置当前目录或自定义路径→ 选择 AI 工具Claude Code、Cursor 等每种工具有自己的 skill 集成方式安装器会生成小型 prompt 文件放入工具期望的位置→ 选择模块大部分用户只需BMad Method即软件交付模块→ 完成剩余配置。安装成功后会显示BMAD is ready to use!及安装路径。安装完成后在你的 AI IDE如 Claude Code 或 Cursor中打开项目调用bmad-helpskill 验证集成是否就绪。使用预发布next通道想要最新预发布版本时使用npx bmad-methodnext installnextdist-tag 发布的是 main 分支最新构建比默认稳定版变化更快、可能包含未完成改动适合尝鲜常规项目工作请使用稳定版命令。升级预发布安装时重复运行同一命令即可依据 docs/start/install-bmad.md 与 CHANGELOG.md 中 Support next installation channel 的记录。无头 CI 安装自动化环境CI/CD可用非交互参数一次性完成安装npx bmad-method install --directory /path/to/project --modules bmm --tools claude-code --yes参数含义参数作用--directory path指定安装目标目录缺省为当前目录--modules ids指定要安装的模块 ID如bmm多个用逗号分隔--tools id指定 AI 工具 ID如claude-code--yes安装必须显式给出--yes跳过交互确认实用辅助命令npx bmad-method install --help——查看当前自动化参数全集npx bmad-method install --list-tools——查看支持的 AI 工具 IDnpx bmad-method install --list-options bmm——查看模块的配置选项依据 docs/start/install-bmad.md 与 docs/fr/how-to/install-bmad.md 中无头安装示例。典型的最小化无头安装当前目录、BMM 模块、Claude Codenpx bmad-method install --yes --modules bmm --tools claude-code安装产物结构安装完成后项目内会形成参考 docs/vi-vn/how-to/install-bmad.md 的目录说明并以安装器源码 skills/bmad/scripts/setup.py 中的_bmad物化逻辑佐证du-an-cua-ban/ # 你的项目 ├── _bmad/ # BMad 共享运行时团队配置与支撑脚本 │ ├── config.toml # 团队配置由 config.template.toml 模板生成 │ ├── scripts/ # 共享脚本resolve_config.py 等 │ └── module/ # 每个已装模块的脚本运行时 ├── _bmad-output/ # 规划产物与实现产物输出目录 ├── .claude/skills/ # Claude Code skills若选 Claude Code │ ├── bmad-help/ │ └── ... └── .cursor/skills/ # Cursor skills若选 Cursor配置模板 skills/bmad/assets/config.template.toml 展示了核心配置骨架[core] project_name {directory_name} output_folder {project-root}/_bmad-output [modules.bmm] planning_artifacts {project-root}/_bmad-output/planning-artifacts implementation_artifacts {project-root}/_bmad-output/implementation-artifacts project_knowledge {project-root}/docs即核心区定义项目名与产物输出目录bmm模块定义规划产物、实现产物与项目知识docs/的存放位置。安装器会把模板中的{directory_name}、{project-root}占位符按实际项目展开合并已存在的团队配置并将模块脚本物化到_bmad/下实现见 skills/bmad/scripts/setup.py 的setup()与materialize_bmad()流程。智能引导bmad-help 与 setup / update / doctorbmad-help 定位不确定接下来做什么是 BMad 的常见起点。bmad-help会告诉你确切的下一个步骤以及哪些是可选的例如bmad-help 我刚刚完成架构设计下一步该做什么skills/bmad/SKILL.md 定义了它的行为每次请求都重新扫描宿主当前暴露的 skill 根目录读取各目录的module-manifest.toml按module键分组再依据 manifest 中knowledge键指向的知识文档路由回答——磁盘上的 manifest 就是成员名单绝不把未安装的 skill 报成缺失成员也不臆造步骤序列。普通帮助请求是只读的不写文件、不修 manifest、不触发 setup/update/doctor。三条运维命令BMad 将安装后运维划分为三个独立命令详见 skills/bmad/references/setup.md命令语义底层实现bmad setup首次物化/修复_bmad运行时setup.py默认模式bmad update只读检查各模块是否有新版本setup.py --updatebmad doctor修复既有_bmad运行时setup.py --doctor三者均通过 uv 运行安装器脚本例如uv run --no-cache {skill-root}/scripts/setup.py --project-root {project-root} --skill {skill-root} --update从源码 skills/bmad/scripts/setup.py 看update 模式输出 JSON 报告逐模块给出current/newer-available/ahead/could-not-check/version-spread等状态doctor 模式比对_bmad/scripts与 skill 内打包脚本是否字节一致不一致则修复并保留既有配置答案与custom/目录setup 模式则从配置模板生成_bmad/config.toml、合并既有配置、收集各模块config_questions待答问题、物化全部脚本。三个命令都严格拒绝符号链接场景与不安全路径如..越界脚本路径保证运行时安全。模块生态核心方法与官方扩展BMad Method 可通过官方模块扩展至特定领域模块在安装时或之后的任意时间点选择仓库内模块安装说明见 docs/customize/add-modules.md。README_VN.md 的模块表整理如下模块用途BMad Method本仓库规划与交付软件从新原型到多年存量代码库BMad Builderskill、工作流与 agent 的构建器BMad Creative Intelligence Suite面向创新、设计思维与叙事的创意思考伙伴BMad Test Architect面向 BMad Method 的企业级测试扩展模块BMad Loop无人值守地构建、验证并复盘整个 EpicBMad Game Dev Studio在任意框架含 Unity、Unreal、Godot、Phaser中构思、设计与开发游戏从本仓库的 manifest 结构如 skills/bmad-agent-analyst/module-manifest.toml可以看到模块化机制的统一形态module声明模块归属、version声明版本、update_source声明更新来源github:前缀 owner/repo/path、knowledge声明模块知识文档位置。安装器据此发现已安装模块并生成对应 skill参考 docs/reference/skills-and-agents.md。已内置于仓库的核心 agent仓库 skills/ 目录已包含一组默认 agent skill其角色配置可在 skills/bmad/assets/config.template.toml 的[agents.*]段中查看例如bmad-agent-analystMaryBusiness Analyst——将 Porter 战略严谨性与金字塔原理结合用可验证证据支撑每个发现bmad-agent-pmJohnProduct Manager——以 Jobs-to-be-Done 驱动用户价值优先技术可行性是约束而非驱动bmad-agent-ux-designerSallyUX Designer——同理心与边界用例严谨性并重bmad-agent-architectWinstonSystem Architect——偏好无聊的稳定技术每个决策与业务价值挂钩bmad-agent-devAmeliaSenior Software Engineer——测试先行red, green, refactor评审前 100% 通过。每个 agent 定义都包含module、team、name、title、icon与description安装后即为 AI 工具提供可直接协作的角色 persona。文档导航与多语言支持README_VN.md 指向的文档体系在本仓库中以多语言 Markdown 存在可直接阅读入门教程docs/vi-vn/tutorials/getting-started.md越南语与 docs/tutorials/getting-started.md英文——从安装到首个改动升级指南docs/vi-vn/how-to/upgrade-to-v6.md越南语、docs/zh-cn/how-to/upgrade-to-v6.md中文、docs/fr/how-to/upgrade-to-v6.md法语等测试架构Test Architect 企业测试模块的使用说明对应仓库 docs/fr/reference/testing.md 与 docs/zh-cn/reference/testing.md概念解释如为什么解决方案设计重要docs/vi-vn/explanation/why-solutioning-matters.md、项目上下文docs/vi-vn/explanation/project-context.md、既有项目 FAQdocs/vi-vn/explanation/established-projects-faq.md参考手册agents、commands、modules、testing、workflow-map 等见 docs/vi-vn/reference/。仓库文档还覆盖中文docs/zh-cn/、法语docs/fr/、韩语docs/ko-kr/、捷克语docs/cs/等多语言版本且有专门的链接校验脚本docs-site/scripts/validate-doc-links.js与多语言覆盖率校验docs-site/scripts/validate-locale-coverage.mjs保证文档质量。已有安装的更新与修复按 docs/start/install-bmad.md更新或重配已有安装的路径是在包含_bmad目录的项目中重新运行npx bmad-method install安装器检测到既有安装后提供update更新与modify修改模块/工具/配置路径按提示选择完成后重新调用bmad-help验证集成。若安装后运行时出问题可在 AI 工具中请求bmad doctor修复既有运行时检查各模块是否有新版本则用bmad update两者均为只读检查或本地修复不会越权改动已安装的 skill 目录——真正更新 skill 目录由npx skills update负责见 skills/bmad/references/setup.md 的职责边界说明。社区、贡献与许可贡献欢迎一切贡献提交 PR 前请阅读 CONTRIBUTING.md贡献者名单见 CONTRIBUTORS.md。许可证MIT License详见 LICENSE。商标BMad 与 BMAD-METHOD 是 BMad Code, LLC 的商标详见 TRADEMARK.md。结语BMad Method 的价值在于把AI 辅助开发从零散的工具调用升级为有结构的 agile 交付方法以npx bmad-method install一键安装以bmad-help随时导航以 12 角色 agent 与 Party Mode 协作讨论以官方模块扩展领域能力以_bmad运行时与config.toml保持团队配置与上下文延续。对于刚接触的项目可从 docs/vi-vn/tutorials/getting-started.md 或英文版 docs/tutorials/getting-started.md 开始第一个改动对于存量代码库docs/vi-vn/how-to/established-projects.md 与 docs/vi-vn/explanation/project-context.md 说明如何建立可验证的项目上下文后接入。无论周末原型还是多年系统同一套方法都能让决策显式、上下文延续、流程随工作量自适应伸缩。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考