BMAD-Method 快速查询手册（便于新手查阅）

这是速查手册，不是完整教程。默认你已经安装了 BMAD（推荐 BMM 模块），并在 Trae 中使用。 重点是“我现在该用哪个 workflow / 规则”以及“产物会落到哪里”。

定位说明：本页是补充资料（速查版）。整体主线请以同目录的 `index.html` 为准； 如果你还没有跑过一遍产品规划流程，建议先读 教程版。

适合场景
查命令、查阶段、查产物、查下一步
查阅方式
按目录跳转；优先看“产品规划阶段速查”
Trae 说明
官方 slash command 名称在 Trae 中映射为 `.trae/rules` 规则文件

1. 先看这三条（新手最低成本规则）

  • 先跑 `bmad-help`（Trae 中对应 `bmad-help` 规则），不要先猜流程。
  • 每个 workflow 建议用新会话（fresh chat），减少上下文污染。
  • 规划阶段至少拿到一版 `PRD.md`，再考虑进入架构或开发。
新手常错

把 BMAD 当成“自动写文档工具”，不提供目标、范围、不做项、约束。结果是文档很长但无法执行。

与另外两份文档的关系
  • `index.html`：主线资料，负责整体流程和案例演示。
  • 教程版：负责产品规划阶段的详细步骤与 Trae 实操说明。
  • 本页（速查版）：负责执行中的快速查询与排错。

2. BMAD 概览图（怎么查）

BMAD 是按阶段组织 workflow 的。你查不到“具体命令”时，先定位自己在哪个阶段。

阶段 目的 常见 workflow / 规则 典型产物
Analysis（可选） 澄清问题、研究、产品 brief `bmad-brainstorming`、`bmad-bmm-research`、`bmad-bmm-create-product-brief` `product-brief.md`、研究结果
Planning（核心） 需求、范围、约束、验收定义 `bmad-bmm-create-prd`、`bmad-bmm-create-ux-design` `PRD.md`、`ux-spec.md`
Solutioning 架构与 Epic/Story 拆分 `bmad-bmm-create-architecture`、`bmad-bmm-create-epics-and-stories` `architecture.md`、epic/story 文件
Implementation 按 story 开发、评审、迭代 `bmad-bmm-create-story`、`bmad-bmm-dev-story`、`bmad-bmm-code-review` 代码、测试、评审结果

3. Trae 中怎么用 BMAD（速查）

3.1 基本映射

  • BMAD 官方文档里的 `/bmad-...` slash command，在 Trae 集成里通常对应 `.trae/rules/bmad-....md`。
  • 你可以把“命令名”理解为“规则名/规则文件名”。
官方写法（文档里常见）： /bmad-bmm-create-prd Trae 中理解为： .trae/rules/bmad-bmm-create-prd.md （同名规则入口）

3.2 安装后应看到的关键目录

路径 作用 查阅时怎么用
`_bmad/` BMAD 核心配置、agents、workflows 需要追根溯源时看这里
`_bmad-output/` 生成产物目录 确认 workflow 是否真正产出内容
`.trae/rules/` Trae 规则入口目录 查有哪些 `bmad-*` 可以调用

3.3 快速自检命令

ls -la .trae/rules | head -30 ls -la _bmad ls -la _bmad-output

4. 常用命令 / 规则速查（新手高频）

这里统一用 BMAD 官方命令名表示；在 Trae 中按同名规则查找。

4.1 通用入口（先用）

命令/规则 什么时候用 作用 下一步通常是什么
`bmad-help` 任何时候，尤其是刚安装后/卡住时 根据项目状态建议下一步 workflow 按建议进入 Analysis 或 Planning
`bmad-agent-bmm-pm` 你想与 PM 角色持续对话 加载 PM agent（角色化对话） 再触发 PRD/epics 等任务
`bmad-agent-bmm-architect` 需要架构方案讨论时 加载 Architect agent 后续执行 architecture/readiness

4.2 规划相关（你当前最常用）

命令/规则 阶段 作用 产物（常见）
`bmad-brainstorming` Analysis 引导式头脑风暴，澄清方向 `brainstorming-report.md`（或等价输出）
`bmad-bmm-research` Analysis 市场/技术/领域研究 研究结论
`bmad-bmm-create-product-brief` Analysis 生成产品 brief，为 PRD 提供上文 `product-brief.md`
`bmad-bmm-create-prd` Planning 生成产品需求文档（PRD） `PRD.md`
`bmad-bmm-create-ux-design` Planning 生成 UX 设计说明（UI产品适用） `ux-spec.md`

4.3 Quick Flow（小改动时）

什么时候用 Quick Flow

Bug 修复、小功能改动、范围非常清晰时，用 `bmad-bmm-quick-spec` / `bmad-bmm-quick-dev` 更快，不必走完整 PRD → 架构链路。

5. 产品规划阶段速查（新手重点）

你现在最常查的应该是这一节：我在产品规划阶段，到底先做什么、后做什么。

5.1 新手推荐顺序（最小可执行路径）

1) `bmad-help`确认当前状态与推荐路径（先问路）。
2) `bmad-bmm-create-product-brief`（建议）先固定问题、目标用户和高层范围。
3) `bmad-bmm-create-prd`（必须）定义需求、范围、约束、验收标准。
4) `bmad-bmm-create-ux-design`（按需）有明显 UI/交互流程时再做。
5) 再次 `bmad-help`确认下一步进入架构或补齐缺项。

5.2 规划阶段完成标准（速查版）

  • 有 `PRD.md`（BMM 轨道下的核心产物）。
  • 文档写清楚本期做什么 / 不做什么。
  • 有可验证的目标/指标，不只是“提升体验”。
  • 关键依赖与风险已记录。

5.3 新手常见输入模板（给 PRD workflow）

请使用 BMAD 的 PRD workflow 帮我生成产品规划阶段 PRD。 背景： - 产品方向： - 目标用户： - 核心问题： - 本轮目标（最好可量化）： - 本轮不做项： - 约束（时间/人力/技术/合规）： 请优先确保： 1) 范围边界清晰 2) 验收标准可验证 3) 风险和依赖单列 4) 不要生成过度理想化功能

6. 产物与目录速查

6.1 你常用到的目录

目录 内容 常见动作
`_bmad/` agents / workflows / tasks / 工具配置 高级排查时查看 workflow 原文件
`_bmad-output/` 规划与实施产物 核对 `PRD.md`、`architecture.md` 等是否生成
`.trae/rules/` Trae 规则入口文件 查看可调用规则列表（`bmad-*`）

6.2 新手最常检查的文件（规划阶段）

  • `_bmad-output/` 下的 `PRD.md`（核心）
  • `_bmad-output/` 下的 `product-brief.md`（建议）
  • `_bmad-output/` 下的 `ux-spec.md`（如果做了 UI 规划）
版本管理建议

不要把同一份 PRD 复制成多个文件名并行维护。保持一个主文件，迭代记录写在版本备注或 Git 提交里。

7. 常见 Agent 角色速查

不一定每次都要显式加载 Agent；很多 workflow 会直接加载对应逻辑。但新手需要知道大概分工。

Agent / 命令 角色定位 你通常在什么时候用
`bmad-agent-bmm-pm` 产品经理（PRD、需求澄清、故事拆分） 规划阶段主力；需要持续对话而非单次 workflow 时
`bmad-agent-bmm-architect` 架构师（技术方案、可实施性） 进入 Solutioning 后
`bmad-agent-bmm-sm` Scrum Master（迭代、story流转） 进入实施阶段后
`bmad-agent-bmm-dev` 开发执行（实现 story、代码评审） 实施阶段

8. 新手场景快捷路径（直接查）

场景 A：我刚安装完，不知道先做什么
  1. 检查 `.trae/rules/` 是否有 `bmad-help.md`
  2. 调用 `bmad-help`
  3. 按建议选择 Analysis 或直接 Planning
场景 B：我有产品想法，要开始规划
  1. `bmad-help`
  2. `bmad-bmm-create-product-brief`（建议）
  3. `bmad-bmm-create-prd`（必须）
  4. `bmad-bmm-create-ux-design`（按需）
场景 C：只是一个小改动/小需求
  1. `bmad-help` 询问是否适合 Quick Flow
  2. `bmad-bmm-quick-spec`
  3. `bmad-bmm-quick-dev`
场景 D：我不知道该不该做 UX 设计
  1. 先看是否涉及明显 UI/多步骤交互
  2. 如是：在 PRD 后执行 `bmad-bmm-create-ux-design`
  3. 如否：先跳过，进入下一阶段也可以

9. 故障排查速查

问题：Trae 里看不到 BMAD 规则

先检查项目根目录是否存在 `.trae/rules/`，以及是否生成了 `bmad-*.md` 文件。 如果没有，重新执行 `npx bmad-method install` 并确认选择了 Trae 和 BMM 模块。

问题：有规则文件，但不知道先用哪个

先调用 `bmad-help`。这是 BMAD 官方推荐的通用入口，用来判断下一步而不是靠记忆命令。

问题：生成了 PRD，但内容空泛

不是 workflow 失效，通常是输入上下文不足。补充目标用户、问题、范围边界、不做项、约束后再跑一版。

问题：一个会话里跑太多流程后结果变乱

按 BMAD 建议每个 workflow 使用新会话（fresh chat），尤其是 `product-brief` → `PRD` → `UX` 这种连续流程。

重装/刷新（常用）

npx bmad-method install

10. 术语小词典（新手版）

术语 简明解释
BMM BMad Method 模块（软件开发主模块），大多数新手只需要先装这个。
Workflow 结构化流程（例如 `create-prd`），通常比普通对话更可控。
Agent 角色化专家（PM、Architect、DEV、SM 等），适合持续对话协作。
Quick Flow 小改动快速通道，适合明确范围的轻量需求，不必走完整规划链路。
`_bmad-output` BMAD 生成产物目录，先看这里确认你是否真正产出了文档。
Trae Rules Trae 中的规则文件入口；BMAD 在 Trae 集成时会把 `bmad-*` 入口生成为 `.trae/rules/*.md`。