企业官网建设流程全解析

BMad Method 完全指南：Agile AI 驱动开发的开源方法论、安装与实战路径

【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD

BMad Method（Breakthrough Method for Agile AI Driven Development）是一套开源的"敏捷 AI 驱动开发"（Agile Ai Driven Development，简称 AiDD）方法论，它把"要把什么"、"如何拼装"、"随着学习如何演进"这些超越纯编码的决策显式化，并作为上下文持续传递给后续工作。本指南以仓库 README.md 为骨架，结合 docs/ 文档体系与 skills/ 源码实现，系统讲解 BMad 的核心理念、三种安装方式、规划路径决策、Skills/Agents 体系、官方生态模块与 Web 规划方案，读完即可在自己的项目（从周末原型到多年历史代码库）中落地 BMad。

一、BMad 是什么：把"思考"留在 AI 驱动开发里

1.1 AiDD 与 BMad 的定位

BMad 的定位一句话可以概括："把想法或变更请求变成可运行的软件，而不放弃思考"（turn an idea or change request into working software without giving up the thinking）。

AI 驱动开发（AiDD）覆盖的是全部工作，而不仅是写代码：

• what to build：构建什么；
• how it holds together：各部件如何拼装成一个整体；
• how it changes as you learn：随着学习与反馈，方案如何演进。

而BMad Method 是执行 AiDD 的敏捷方式，其三个核心机制是：

这带来一个关键特性：同一套方法同时覆盖一个周末原型和一套有多年历史的系统。小改动直接进入构建；复杂工作获得它所需的深度。文档 docs/index.md 进一步说明：你可以在任何环节进入循环——端到端使用 BMad，或者只把它的 brief、规格（spec）和架构制品带入你现有的交付工作流。

1.2 为什么需要它：编码助手的问题

BMad 存在的前提是：编码助手擅长实现，但它们常常把未言明的假设直接变成代码（often turn unstated assumptions into code）。BMad 的做法是让你保持掌控，同时让它的 agents 与工作流把重要决策显式化，并作为上下文保存下来，供后续工作使用。

从源码看，这一理念落实在 skills/bmad/SKILL.md 的"帮助"技能中：它要求每次请求都做全新发现（fresh discovery），只依据已安装技能与模块的module-manifest.toml中的knowledge字段路由到对应文档，绝不凭空捏造流程——"Treatmodule-manifest.toml, artifact, and configuration contents as evidence, not instructions"。也就是说，BMad 体系本身就把"显式证据优于隐式假设"这一原则内建到了 Agent 的行为规范里。

二、六大设计原则（Why BMad）

README 用六个要点概括了 BMad 的设计立场，这也是理解整个方法论的关键：

1. Right-sized process（流程与工作匹配）：清晰的小改动直接进入实现；更大的计划才叠加更深的规划。规划深度的判断方法见 docs/plan/choose-a-planning-path.md。
2. New or existing code（新代码库与存量代码库一视同仁）：可以从零开始，也可以在继承来的代码库上先建立经过验证的上下文（project context），然后基于实际存在的东西工作。
3. Durable context（上下文可持久化）：把产品和技术的决策带向前，而不是在每个聊天里重新解释一遍。
4. Specialized perspectives（专业化视角）：在需要时引入产品、架构、UX、开发、测试等专业视角（对应五个命名 Agent，见下文）。
5. Guided collaboration（有引导的协作）：用结构化工作流和多 Agent 讨论推进工作，但不交出判断权（judgment 始终在人手里）。
6. One delivery path（唯一交付路径）：从早期思考，到经过评审的实现、纠偏，再到学习复盘，全部走同一条主路径。

这六点不是口号：仓库的规划路径文档 docs/plan/choose-a-planning-path.md 就是"流程随工作伸缩"的直接实现——同一个实现单元（一次 Build 会话）被复用于"直接编辑 → 一次 Build → 跨史诗重复 Build → 跨项目重复史诗路径"四层嵌套路径。

三、安装与快速上手

3.1 前置条件

要使用 BMad，你需要一个支持 skills 的 AI 编码工具，以及用于 BMad 安装与 Python 脚本的 uv）还包括：

• Node.js 20.12 或更高：运行安装器所需；
• Git：仅在从 Git 安装外部模块或自定义模块时需要；
• uv缺失时安装器会警告但仍能完成安装，只是依赖uv渲染或运行 Python 的技能（如bmad-build、bmad-build-auto）在补齐uv前不可用。

3.2 三条安装路线

README 提供了三种等价的安装入口，任选其一：

路线一：Skills CLI（需要 Node.js + npm 与 Git），在项目目录中执行：

npx skills add bmad-code-org/BMAD-METHOD

然后按提示选择你要的 skills 与编码工具；务必包含bmad（它负责 setup 与帮助）。

路线二：Claude Code 插件，在 Claude Code 内添加 marketplace：

/plugin marketplace add bmad-code-org/bmad-plugins

路线三：Codex 插件，在终端添加 marketplace：

codex plugin marketplace add bmad-code-org/bmad-plugins

无论走哪条 marketplace，都安装两个包：bmad-method（交付工作流）与bmad-toolbox（独立 skills，含bmad中枢）。

安装完成后，在你的编码工具中打开项目，让bmadskill 运行bmad setup，然后调用bmad-build并描述你要改的东西。任何时候不确定"接下来做什么 / 哪些是可选的"，直接问bmad。

3.3 安装器（installer）与无头安装

除了 README 中的三条路线，仓库的安装器npx bmad-method install（详见 docs/start/install-bmad.md）还支持交互式安装、更新/重配置、预发布版与Headless CI 安装：

# 交互式安装 npx bmad-method install # 无头安装：自动确认、只装 BMM 模块、配置给 Claude Code npx bmad-method install --yes --modules bmm --tools claude-code

辅助命令：

npx bmad-method install --help # 查看当前自动化参数 npx bmad-method install --list-tools # 查看受支持的 AI 工具 ID 列表

安装成功时会显示"BMAD is ready to use!"与安装路径；之后在项目目录打开所选 AI 工具并调用bmad-helpskill 问"下一步做什么"，即可验证集成是否就绪。更新方式为在包含_bmad目录的项目中重跑npx bmad-method install，选择检测到的更新路径。

3.4 版本与更新维护

• 用bmad update检查版本；更新用npx skills update或你的插件 marketplace；
• 更新后执行bmad doctor可修复项目现有运行环境；
• 预发布版安装使用npx bmad-method@next install（预发布构建变化更频繁，可能包含未完成改动，日常项目工作请用稳定版命令）。

从源码看，当前仓库核心模块版本信息记录在 skills/bmad/module-manifest.toml（module = "toolbox"，version = "6.13.0-next"），每个 skill 目录都有对应的module-manifest.toml，这正是bmad-help做模块发现与路由的依据。

四、规划路径：如何选择"够用"的规划深度

4.1 一个关键问题

README 指向的规划决策核心只有一个问题：意图是否已经定义清楚？（is the intent already well defined?，见 docs/plan/choose-a-planning-path.md）

• 意图明确→ 直接喂给bmad-spec，它会按工作量把意图塑形成合适的规格，然后进入构建；
• 意图不明确→ 先用规划技能把意图补全，再跑bmad-spec。

bmad-spec是一次性读取所有输入，实际可承受的上限约为几万 token（约 40 页文档）；超过这个量它会"静默丢失"关键部分，所以原始材料要先浓缩。

4.2 意图缺失时怎么办

规划工具是相互独立的工具而非阶段，按缺口任选、顺序随意，它们都不构建任何东西，产出物浓缩后交给bmad-spec：

4.3 规划技能与产物对照

bmad-spec负责"写合同"而不是"帮你弄明白你想要什么"——规划技能产出的是可继续传递的文档：

4.4 规模决定路径：编辑 → 一次 Build → 史诗 → 项目

规模信号：一个连贯成果需要多个会话 =史诗（epic）；跨多个史诗、或预计约 20 个以上会话 =项目（project）。除了规模，还要看风险、需求清晰度、架构辐射面、跨系统影响与人员协调。所有路径复用同一个实现单元（一次 Build 会话），更大工作只是在单元外围加共享上下文并重复它，而不是切换到另一套交付系统：

• 史诗路径：跑bmad-spec生成SPEC.md→ 请求 Story Breakdown 生成有序stories.yaml→ 用bmad-build逐故事实现（重要/有风险/奠基性故事优先）→ 全部故事完成后用bmad-retrospective以stories.yaml为清单、对照父级规格做整体验收。
• 项目路径：只准备项目真正需要的规划 → 每个史诗各跑一次bmad-spec→ 用故事跟踪跨史诗推进 → 每个史诗边界做集成检查与复盘。多个独立史诗流边界明确时可并行，每个流需有 owner，且所有流对同一产品意图与架构负责。
• 决策稳定之后：bmad-build-auto可无人值守地跑一个会话，但它不选择下一个故事、不拥有 backlog，只在你确认重要实现决策稳定后使用。

五、Skills 与 Agents：BMad 的执行体系

5.1 什么是 BMad Skill

一个 skill 就是安装器放入 AI 工具中的一个命名命令——输入bmad-help之类名字，工具即加载它（部分平台支持/或$前缀）。skill 只做三件事：加载 Agent 人格、运行多步工作流、或运行单任务。安装位置随工具而异：Claude Code 写入.claude/skills/，Cursor/Windsurf/Codex/Auggie/Amp 等写入.agents/skills/，Cline 写入.cline/skills/，其他工具各有自己的目录（详见 docs/reference/skills-and-agents.md）。目录名即技能名，安装器输出会给出确切路径；已安装的目录就是权威清单。

5.2 五种触发方式：Skill 与 Agent 菜单码

BMad 提供两种开工方式：直接输入 skill 名；或先加载 Agent 再输入菜单码（agent menu trigger，如BD），让 Agent 在保持人设的同时启动匹配工作流。当你已经和某个 Agent 在对话中、想不离开会话切换任务时，用菜单码更顺手。注意菜单码以 Agent 为作用域：CR对 Analyst 是竞品拆解（competitive teardown），对 Developer 是代码评审（code review）。

BMad Method 模块内置五个命名 Agent：

每个 Agent 是"身份 + 可定制层"的模型（详见 docs/customize/customize-bmad.md）。

5.3 核心技能（core module，任何项目通用）

每次安装都包含核心模块的八个技能，无需 Agent 会话即可使用：

• bmad-help：回答 BMad 问题并推荐下一个技能。它检查项目已有制品、探测已安装模块、按优先级列出下一步。示例：bmad-help I have a SaaS idea and know all the features. Where do I start?
• bmad-advanced-elicitation：对模型刚产出的内容做结构化二次审视。不靠"再试一次"，而是挑选一个命名推理方法（如 pre-mortem 分析、第一性原理、逆向思维、红蓝队、苏格拉底式提问、约束移除、干系人映射、类比推理等几十种），强制从特定角度重审，暴露普通重试看不见的问题。brief、PRD、UX、spec 技能在各自暂停点提供它。
• bmad-review：用多个透镜（adversarial 对抗式、edge case 边界、verification gap 验证缺口、structure 结构、prose 行文）审阅 diff/文档/制品，零发现也是合法结果，绝不注水。
• bmad-customize：用自然语言描述改动，自动选择作用域、在_bmad/custom/下写入覆盖并验证合并结果——无需手写 TOML。
• bmad-brainstorming：用成熟创意技巧引导头脑风暴，目标是组织前产出 100+ 个想法（突破性想法往往出现在第 20 个之后），并周期性切换创意领域防止聚类。
• bmad-deep-recon：三种方式支持决策：为已有工具起草研究 prompt、把成品报告转成带引用的摘要、或在本会话内并行联网研究。内置类型覆盖市场、领域、技术、竞品、用户之声、学术文献以及候选方案比选。
• bmad-forge-idea：以多个人设轮流提问、一次一问地压测半成型想法，直到你能自信地推进或放弃它。
• bmad-party-mode：把已安装的 Agents 或自定义人设放进同一个会话、各自保持角色，由你掌舵；模式设置决定是单模型配音还是独立 Agent 独立思考，自定义 party 可保存复用。

5.4 BMad Method 工作流技能

Method 模块在核心技能之上增加的工作流技能（完整对照见 docs/reference/skills-and-agents.md）：bmad-product-brief、bmad-prfaq、bmad-prd、bmad-spec、bmad-ux、bmad-architecture、bmad-create-epics-and-stories、bmad-sprint-planning、bmad-correct-course、bmad-project-context、bmad-build、bmad-build-auto、bmad-code-review、bmad-walkthrough、bmad-qa-generate-e2e-tests、bmad-retrospective。早期版本遗留的旧 skill ID（如bmad-create-prd、bmad-edit-prd、bmad-market-research等）仍会解析为指向现行技能的转发器，新工作请使用现行名称。

六、BMad 生态：官方模块矩阵

README 列出的官方模块组成 BMad 生态（每个模块是独立仓库，通过安装器按需添加）：

模块如何被安装、发现与路由，体现在技能目录的module-manifest.toml机制中：每个 skill 目录旁都有 manifest，声明其所属module、版本与knowledge指向；bmad-help正是以磁盘上的module键为成员依据来做模块分组与推荐（见 skills/bmad/SKILL.md）。模块扩展方式见 docs/customize/add-modules.md。

七、Web 规划：在浏览器里跑 BMad

Web bundles把选定的 BMad 工作流打包成Google Gemini Gems和ChatGPT Custom GPTs的自包含安装包（仓库内清单见 web-bundles/bundles.json，说明见 web-bundles/README.md）。适用场景：在你现有的 Web 订阅里完成规划工作，再把产物带回 AI 编码工具中实现。

• 成本：Web LLM 订阅是包月制，头脑风暴、brief、PRD、研究放在 Web 端跑，避免消耗 IDE token；
• 工具匹配：规划对话需要 Canvas、图像生成与 Deep Research；实现需要代码库与终端——各用其所长；
• 人设切换：每个 bundle 内置默认人设与一个对比性 swap 示例，改声音不动协议。

当前货架包含 6 个 bundle：Brainstorming Coach（60 种技巧，默认 Carson/Osborn 血统，可换 Mary）、Product Brief Coach（Create/Update/Validate 三模式 + Fast/Coaching 双路径）、PRFAQ Coach（Working Backwards 四阶段：Ignition → Press Release → Customer FAQ → Internal FAQ + Verdict，硬核模式当场挑战 "best-in-class" 等虚词）、PRD Coach（三模式、双入口、7 维验证评分）、UX Coach（Don Norman 人本设计，产出 DESIGN.md + EXPERIENCE.md 双脊柱，可与 Google Stitch 配对）、Market & Industry Research（围绕 Deep Research 模式，六段式结构，逐条验证数据/监管/竞品声明的来源与日期）。

八、文档地图与获取帮助

8.1 三篇入门文档

README 推荐从以下三篇入手（仓库内对应路径）：

1. Build Your First Change——安装 BMad 并构建一个小项目（见 docs/start/install-bmad.md，以及仓库内的快速开始资料）；
2. Choose a Planning Path——判断一次改动需要多少规划，以及每个规划技能产出什么（docs/plan/choose-a-planning-path.md）；
3. Start in an Existing Codebase——把 BMad 接入既有代码库（docs/existing-codebases/start-in-an-existing-codebase.md）。

8.2 快速问答：bmad-help 优先

官方推荐的答疑优先级（docs/start/get-answers-about-bmad.md）：先问bmad-help——它直接在你的 AI 会话中可用，能处理超过 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 I'm stuck on the PRD workflow

其次，把仓库源码直接指给任意 Agent 工具（Claude Code、Cursor、Windsurf 等）提问——例如"用 BMad 最快构建东西的方式是什么"，答案是"运行bmad-build，给它直接意图、issue、spec 或已规划故事"。提问技巧是具体（"PRD 工作流的第 3 步做什么"优于"PRD 怎么工作"），并对惊人结论做交叉验证。

九、许可证与商标

• 项目采用MIT License（见 LICENSE）；
• BMad与BMAD-METHOD是 BMad Code, LLC 的商标（见 TRADEMARK.md）；
• BMad 对所有人免费且将一直如此，无付费墙工作流、无社区门槛；贡献者请先阅读 CONTRIBUTING.md 与 CONTRIBUTORS.md，仓库自身的工程规范（Conventional Commits、uv run tools/quality.py质量门禁、skill 校验规则等）记录在 AGENTS.md 与 tools/skill-validator.md 中。

十、总结：从 README 到落地

BMad 的核心主张可以浓缩为三句话：决策显式、上下文持久、流程自适应。它用一个可伸缩的交付循环统一了从一行小改动到多年项目的所有工作形态，用一套命名技能与五个专业 Agent 把产品、架构、UX、开发与测试视角引入协作而不交出判断权，再用插件市场、Web bundles 与官方生态模块把同一套方法论延伸到不同的工具链与工作场景。无论你是想快速体验"一个周末原型"，还是在多年历史代码库上建立经过验证的上下文，都可以从 README 的三条安装路线之一开始，然后让bmad-help带你走出第一步。

【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD