BMad 方法入门指南为 AI 编程工具装上思考 构建技能体系并快速找到你的起点【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMadBreakthrough Method for Agile AI Driven Development为 Claude Code、Cursor 等 AI 编程工具添加一组名为skills技能的命名命令一部分帮助你思考澄清想法、验证想法、写清需求另一部分帮助你构建把改动交给bmad-build直接产出代码并完成审查。本文以仓库中的 docs/index.md 为骨架结合安装文档、规划路径文档与 skills/bmad/SKILL.md 等源码实现完整讲解 BMad 的技能组成、统一交付循环、按场景选择起点的方法以及安装、规划、存量代码库与团队定制等实战路径读完即可在项目中完成从模糊想法到第一次构建的全流程。BMad 是什么给 AI 编程工具添加一组命名技能BMad 的核心形态不是独立的 IDE 插件而是一组命名命令skills通过安装器写入你正在使用的 AI 编程工具如 Claude Code、Cursor中。调用时只需输入技能名例如bmad-help工具便会加载对应的工作流。根据 docs/reference/skills-and-agents.md 的定义一个 skill 只有三种用途加载一个代理角色agent persona、运行一个多步骤工作流multi-step workflow、或执行单个任务single task。这些技能分为两个互补的群组这是理解 BMad 的第一把钥匙群组用途代表技能思考类thinking探索想法、研究它、反驳它、把最终结论写下来bmad-brainstorming、bmad-forge-idea、bmad-deep-recon、bmad-prd、bmad-spec等构建类building把要做的改动变成代码并完成审查bmad-build写代码并审查、bmad-code-review、bmad-qa-generate-e2e-tests等两组技能可以完全独立使用很多人只跑思考类技能从不要求 BMad 写一行代码而一个小修复也可以完全跳过规划直接进入构建。这一设计决定了后续所有选择起点的逻辑——流程的规模永远由工作本身的大小决定而不是由方法论的固定套路决定。统一交付循环Clarify → Plan → Build and Verify → Learn and Adjust原文档用一张交付循环图说明了 BMad 的灵魂所有路径都在跑同一条循环区别只在于进入点和绕圈的次数。一个模糊的概念vague notion从Clarify阶段进入——先澄清它是什么一个明确的大想法big clear idea从Plan阶段进入——直接进入规划一个小改动small change从Build and verify阶段进入——直接实现并验证每次交付之后Learn and adjust会带着经验循环回 Plan。关键结论是更大的工作只是更早进入循环、绕更多圈并不会变成另一套交付方式。这保证了方法论的一致性——周末原型和多年历史的大型系统走的是同一套单位一次 Build 会话只是外层包裹的共享上下文不同。找到你的起点按场景选择入口原文档的核心价值在于一张决策地图根据你当下的处境直接命中对应的入口。下面把每个场景展开讲解。场景一不确定这个改动需要多少流程看 docs/plan/choose-a-planning-path.md。判断依据只有一个问题意图是否已经定义清楚。如果意图清晰把它交给bmad-spec它会按工作规模塑形并直接进入构建如果意图不清该章节的其他页面就是用来获得清晰意图的。属于组织级工作PRD 需多人审批、多个工程师并行时先读 docs/plan/plan-inside-an-organization.md。场景二想先看到它跑起来走Build Your First Change路径空项目中完整跑一次构建。原文档指出这条路径会在一个空项目里完整演示一次构建是新手最快的上手方式。本仓库快照中的start/目录提供了与之配套的 docs/start/install-bmad.md 安装指南可先完成安装。场景三你知道要改什么而且改动很小直接运行bmad-build并描述这个改动。这是跳过规划直接构建的典型场景。bmad-build会把一个工作项变成可运行的代码并且自带审查与验证。原文档强调如果改动在一次实现会话内就能完成你其实在 Build 章节的管辖范围内而不是规划章节——先判断会话规模再决定是否需要 BMad 介入一个显而易见、低风险的编辑甚至不需要 BMad。场景四你在一个已有代码库中工作考虑先运行bmad-project-context然后照常构建。详见 docs/existing-codebases/start-in-an-existing-codebase.md 与 docs/existing-codebases/set-and-maintain-project-context.md。存量代码库的原则是应用的大部分知识已经编码在源码里现代 Agent 很擅长从代码中提取知识重复喂入文本描述反而制造矛盾、歧义和上下文窗口膨胀。规划太少只损失一次 BuildBuild 会先看代码无法确定意图时停下来询问规划太多则产出没人读的文档。拿不准时让bmad-help检查项目并回答我有一个现有 Rails 应用该从哪里开始这类问题。场景五构建一个更大的功能或完整产品如果能把完整意图交给bmad-spec就从它开始如果需要先走构思/规划阶段则在选择规划路径中选择一条路径。bmad-spec能把任何输入压缩成一份简短的契约文档spec并按需拆分故事stories。注意其输入约束它一次性读取你给的全部内容实际上限约为几万 token大致一份 40 页文档。塞入数倍于该规模的原始文档时它会悄悄丢失关键部分——先压缩再投喂是铁律。场景六想法还很模糊或不确定它好不好先产生选项或压力测试想法见 docs/plan/explore-and-validate-an-idea.md然后用 Deep Recon 收集证据见 docs/plan/research-a-decision.md。bmad-brainstorming用成熟创意技法引导一场头脑风暴目标是把想法推向 100 个以上再开始收敛并定期切换创意领域防止聚类bmad-forge-idea用一个接一个的提问压力测试半成品想法直到你能自信地行动或自信地放弃——对话是发现想法漏洞最便宜的地方bmad-deep-recon以三种方式研究主题支撑决策为现有工具起草研究提示词、把完成的报告转成其他技能可消费的带引文摘要、或用并行网络搜索就地研究。内置类型覆盖市场、领域、技术、竞争、用户之声与学术文献研究。场景七想让 BMad 遵循团队自己的规则与实践见 docs/customize/customize-bmad.md 和 docs/customize/adopt-bmad-across-a-team.md。定制机制建立在覆盖文件override之上在_bmad/custom/下写入稀疏的 TOML 覆盖文件即可改变某个代理或工作流的行为升级不会触碰你的文件也无需编辑安装目录中的文件。具体机制三层覆盖优先级、按值形态合并的规则将在后文展开。场景八不确定从哪里开始运行bmad-help。如果还不够见 docs/start/get-answers-about-bmad.md。bmad-help处理超过 80% 的提问它检查你的项目、看到你已完成的内容然后按优先级列出下一步每条都带技能命令。调用示例bmad-help I have a SaaS idea and know all the features. Where do I start? bmad-help What are my options for UX design? bmad-help Im stuck on the PRD workflow先安装 BMad三条安装路线与前置条件从 README.md 可以确认三条官方安装路线任选其一即可需要支持 skills 的 AI 编程工具以及用于 BMad 安装与 Python 脚本的uv路线 1Skills CLI需 Node.js npm 与 Git在项目内运行npx skills add bmad-code-org/BMAD-METHOD随后选择你要的技能和编程工具务必包含bmad用于安装与帮助。路线 2Claude Code 插件——在 Claude Code 内添加市场/plugin marketplace add bmad-code-org/bmad-plugins路线 3Codex 插件——在终端添加市场codex plugin marketplace add bmad-code-org/bmad-plugins两条市场路线都需要安装bmad-method交付工作流与bmad-toolbox独立技能含bmad中心。安装完成后在项目里打开你的编程工具让bmad技能执行bmad setup然后用bmad-build描述你要的改动任何时刻都可问bmad下一步该做什么或哪些可选。更新使用bmad update检查版本安装更新用npx skills update或插件市场更新后运行bmad doctor修复项目现有运行时。使用官方安装器npx bmad-method installdocs/start/install-bmad.md 给出了更精细的安装器用法。前置条件如下前置条件说明Node.js 20.12 或更高运行安装器所必需受支持的 AI 编程工具使用已安装技能所必需可用npx bmad-method install --list-tools查看当前列表uv通过uv渲染或运行 Python 的技能需要包括bmad-build与bmad-build-auto缺失时安装器会警告但仍完成安装Git仅当安装外部模块或来自 Git 的自定义模块时需要标准安装流程在终端进入目标项目安装器默认使用当前目录运行npx bmad-method install跟随提示选择模块、配置与受支持的 AI 编程工具安装结束看到BMAD is ready to use!与安装路径并留意仍需处理的警告从项目目录打开你选择的 AI 编程工具调用bmad-help技能验证集成是否就绪。更新或重配置时在包含_bmad目录的项目中重新运行同一命令安装器会检测现有安装并提供更新或修改路径从旧版本升级时它会警告遗留命令目录中过时的bmad-*条目应删除以免出现重复命令。预发布版本使用npx bmad-methodnext install更新时重跑同一命令无头 CI 安装典型用法npx bmad-method install --yes --modules bmm --tools claude-code自动化脚本中使用npx bmad-method install --help查看当前自动化标志用--list-tools查找有效工具 ID若自动化使用next或显式版本号检查帮助与运行安装器时需使用同一 tag 或版本。安装完成后技能被写入你选择的每个 AI 工具的技能目录项目的_bmad目录存放共享配置与支撑脚本。技能在各工具中的落盘位置参见 docs/reference/skills-and-agents.md工具技能目录Claude Code.claude/skills/Cursor、Windsurf、Codex、Auggie、Amp 及多数其他工具.agents/skills/Cline.cline/skills/IBM Bob.bob/skills/Antigravity.agent/skills/AdaL.adal/skills/目录名即技能名bmad-agent-dev/注册为bmad-agent-dev。已安装的技能目录就是权威清单——打开你的技能目录即可看到每个已装技能及其描述。理解技能与代理体系两种启动方式Skill 与 Agent 菜单触发码机制如何调用发生什么Skill在 AI 工具中直接输入技能名如bmad-help直接加载一个代理、运行一个工作流或执行一个任务Agent 菜单触发码先加载代理再输入短代码如BD代理在保持角色设定的同时启动对应工作流知道要哪个工作流就用 skill已经在一个代理会话中想不离开对话切换任务就用触发码。五个具名代理BMad Method 模块安装五个具名代理用其技能 ID 加载后输入菜单码即可启动工作流。菜单码按代理作用域区分CR对 Analyst 是竞品拆解competitive teardown对 Developer 则是代码审查code review。代理技能 ID菜单码菜单内容AnalystMarybmad-agent-analystBP、MR、DR、TR、TS、CR、UV、CB、WB、PC头脑风暴市场、领域与技术研究技术选型竞品拆解用户之声研究产品简报PRFAQ 挑战项目上下文Product ManagerJohnbmad-agent-pmPRD、CE、IR、CC创建、更新或验证 PRD史诗与故事实现就绪检查纠偏ArchitectWinstonbmad-agent-architectCA、IR架构主干实现就绪检查DeveloperAmeliabmad-agent-devBD、QA、CR、SP、ER构建QA 测试生成代码审查冲刺规划史诗回顾UX DesignerSallybmad-agent-ux-designerCUUX 设计注技术写手Paige目前暂停服务项目上下文改用 Analyst 的PC码或直接调用bmad-project-context。每个代理 一个身份 一层可定制配置。八个核心技能每次安装都包含核心模块的八个技能任何项目、任何模块、任何阶段都可用无需代理会话bmad-help——回答 BMad 问题并推荐下一个技能输入为可选的自然语言问题输出为按优先级排序的下一步列表bmad-advanced-elicitation——对模型刚产出的内容做结构化的二次审视选择具名推理方法如 pre-mortem 分析、第一性原理、反转、红蓝对抗、苏格拉底式提问、约束移除、利益相关者映射、类比推理等数十种让模型以该视角重新检查自身输出brief、PRD、UX、spec 技能都有自己的暂停点可调用它bmad-review——通过一个或多个透镜审查 diff、文档或工件把所有发现整理成统一形态零发现也是合法结果。透镜包括对抗性Adversarial、边界情况Edge case、验证缺口Verification gap适用于代码、结构Structure、措辞Prosebmad-customize——用自然语言描述变更自动选择正确作用域在_bmad/custom/下写入覆盖文件并验证合并结果bmad-brainstorming——主持头脑风暴产出自包含的brainstorm.html纪念文件与可选的brainstorm-intent.mdbmad-deep-recon——研究主题支撑决策产出带引文的research.md与可选的 HTML 简报bmad-forge-idea——压力测试半成品想法每次产出forge-report.html想法硬化时附forged-idea.mdbmad-party-mode——把已安装代理或自定义人设放进同一场对话、保持角色并由你掌控可保存自定义 party 复用。bmad-help的底层实现skills/bmad/SKILL.md值得关注它对每次请求做全新发现fresh discovery只读取每个技能目录旁的module-manifest.toml并仅依据 manifest 中knowledge字段指明的文档进行路由普通帮助请求是只读的不会触发 setup/update/doctor也不会读写_bmad下的缓存文件。而 setup、update、doctor 是三个互不相同的命令用户明确要求时才按 skills/bmad/references/setup.md 走对应流程绝不互相路由。深入规划路径从意图出发让规模跟随意图什么是定义良好的意图一份定义良好的意图应该说明工作完成时应成立什么、什么不得改变、什么超出范围——完整到别人不用猜就能构建且不超过这个长度。它来自哪里并不重要一句话、一个 issue、一个锻造过的想法、一份研究报告、一份 PRD 都可以。规划技能与各自产出物docs/plan/choose-a-planning-path.md 给出了完整的能力清单。所有技能都是独立的工具而非阶段可按任意顺序挑选每个技能都会产出一份可交接的文档技能用途产出物bmad-brainstorming用主持式会话产生想法brainstorm.html纪念文件 可选的brainstorm-intent.mdbmad-forge-idea压力测试想法直到它硬化、被证实或廉价地死掉每次运行产出forge-report.html想法硬化时附forged-idea.mdbmad-deep-recon研究主题以支撑决策带引文的research.md 可选的 HTML 简报bmad-product-brief概念清晰时捕获产品愿景brief.mdaddendum.mdbmad-prfaq从新闻稿倒推Working Backwards以客户为先压测产品概念prfaq-project.mdbmad-prd创建、更新或验证 PRD创建/更新prd.md、addendum.md、.memlog.md验证HTML .md报告bmad-ux记录产品的外观与行为DESIGN.md、EXPERIENCE.md、.memlog.mdbmad-spec把任何意图压缩成简短契约按请求拆分为故事SPEC.mdspecs/spec-slug/下的配套文件可选stories.yamlbmad-architecture做出让独立构建的部件保持一致的技术决策默认产出ARCHITECTURE-SPINE.mdbmad-create-epics-and-stories把需求拆分为史诗与故事带故事的诗级文件bmad-sprint-planning实现前检查就绪度然后跟踪故事状态PASS/CONCERNS/FAIL sprint-status.yaml注意bmad-prd有三个意图create、update、validate调用时要说明否则它会询问bmad-product-brief与bmad-prd可互相喂给但不互相依赖。这些技能的完整实现在仓库skills/目录下可逐一查看例如bmad-spec、bmad-prd、bmad-ux、bmad-brainstorming各自的SKILL.md与module-manifest.toml定义了技能说明、可定制字段与模块归属。规模跟随意图Epic 与 Project一个需要多次 Build 会话但仍有一个连贯结果的产出物是epic史诗跨越多个史诗、或大概需要20 次以上会话的工作是project项目。规模只是信号之一高风险、需求不清、架构覆盖面广、跨系统影响、多人多团队协作时应使用更多规划。所有路径复用同一个实现单位一次 Build 会话更大工作只是在该单位外围增加共享上下文并重复它。Epic 路径运行bmad-spec输入史诗意图 → 请求 Story Breakdown 生成有序的stories.yaml→ 审查顺序并决定哪些故事需要检查点 → 用bmad-build逐个实现故事重要、有风险、奠基性的故事先做→ 验证故事组合 → 用bmad-retrospective对照父 spec 评判合并结果。Project 路径只准备项目真正需要的规划 → 每个史诗各跑一次bmad-spec→ 用 docs/plan/break-work-into-stories-and-track-it.md 跟踪故事 → 每个史诗边界运行集成检查与回顾。这些文档协调实现但不替代 Build每个史诗仍是一个个单会话单位的序列独立史诗流在边界明确时可以并行每条流需要一名负责人且所有流对同一产品意图与架构负责。决策稳定之后bmad-build-auto运行一个无需等待人工输入的会话但它不挑选下一个故事、不拥有待办列表——只在重要实现决策稳定后使用。存量代码库Build 跟随代码实际存在的东西在已有仓库中开始 BMad 工作的要点项目上下文按需准备bmad-project-context会把一小段经过验证的代理指令写入仓库的AGENTS.md。当这些指令缺失、过期或质量存疑时运行它当仓库已有持续维护的AGENTS.md、CLAUDE.md或编辑器规则、或代理已有其他发现工具可依赖时跳过它。跳过不会让 Build 失败代价是每次会话都重复同样的错误直到有人把它写下来围绕已存在的东西规划需要 PRD 时让代理在写需求前先找到并阅读现有项目文档架构工作需要架构师使用已记录的架构文件并扫描现有代码库否则实现阶段可能遇到与现架构冲突的选择Build 遵循它发现的东西你无需事先盘点约定bmad-build会调查仓库、记下哪些要复用、哪些不要改然后照此执行。想让本次改动打破某个既有模式就在请求里说明并写入 spec 的理由让后续会话遵循新规则不喜欢某个模式但没有改造计划就保持沉默——它会匹配现有代码。团队定制让每个开发者的 BMad 遵循同一套规则docs/customize/customize-bmad.md 详细解释了定制机制核心如下两个定制表面每技能覆盖文件_bmad/custom/skill.toml控制单个代理或工作流激活时的行为与中心配置_bmad/custom/config.toml安装答案与代理名册三层合并_bmad/custom/skill.user.toml个人、gitignored_bmad/custom/skill.toml团队、提交 技能自带的customize.toml出厂默认按值形态合并标量覆盖生效表深合并带code或id键的表数组按键合并匹配的原地替换新增的追加其他数组追加。覆盖无法删除出厂项只读字段agent.name与agent.title运行时不被读取改名需复制技能目录发布为自定义技能不建议复制整份customize.toml每个省略的字段都会从下层继承整份复制会锁定今日默认值导致下次更新被静默遮蔽。docs/customize/adopt-bmad-across-a-team.md 则提供了现成的团队配方给开发代理注入固定的工具使用规则如总是先用 Context7 查库文档、故事不在史诗列表时用 Linear 检索、给单个工作流强制合规字段、改写代理公开描述、新增虚构代理加入名册等全部以_bmad/custom/下的覆盖文件实现并随仓库提交。求助与深入阅读按最快 → 最深入排序bmad-help——直接在你的 AI 会话中使用检查项目、告诉你下一步源码与文档——对于 BMad 内部机制、历史或架构问题直接让 AI 读取本仓库docs/目录、skills/目录下的SKILL.md与module-manifest.toml、tools/目录下的校验脚本即可得到答案。提问建议具体化PRD 工作流的第 3 步做什么优于PRD 怎么工作并对惊人结论做源码核验社区渠道——官方文档站、Discord 的help-requests论坛提问与#suggestions-feedback想法与功能请求、GitHub Issues。最后强调原文档给出的实用兜底拿不准就从bmad-help开始——它会在每个工作流结束时运行告诉你接下来是什么。规划技能的完整清单、安装器参数、代理菜单码等细节均可沿文中链接继续深入对应章节与源码文件查阅。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考