BMad 一站式文档
Unified Guide

BMad Method 文档整合版

当前入口页是主线资料:按“安装 → 模块 → Trae → 产品流程 → 交付”推进。另附两份补充资料(教程版 / 速查版),用于产品规划阶段的深入说明与执行时快速查阅。

补充资料(可选,建议搭配本页主线使用)

本页负责主线流程;教程版用于“第一次做产品规划时按步骤走”,速查版用于“执行中快速查命令、阶段、产物和排错”。

BMAD Method 安装指南 (Trae 版)

含 Trae 专属激活技巧,无需拖拽文件。适用对象:零基础开发者、产品经理、小说家、游戏策划等创作者。

1 第一阶段:核心环境准备 (必做)

BMAD 基于 Node.js 运行,先安装以下基础环境:

  1. 安装 Node.js:访问 Node.js 官网,下载并安装 LTS 版本。
  2. 安装 Git:Windows 使用 Git for Windows;Mac 终端输入 git 可触发安装。
  3. 安装 Trae:访问 Trae 官网 下载并登录。

2 第二阶段:一键安装

  1. 在桌面新建文件夹(例如 MyProject),用 Trae 打开。
  2. Ctrl + ` (Win) 或 Cmd + ` (Mac) 打开终端。
  3. 执行命令:
npx bmad-method install

3 第三阶段:模块选择完全指南

核心提示:无论角色是什么,[BMad Method Agile-AI Driven-Development] 都是必选项。其他模块按任务选择。

BMM (Agile-AI)

必选核心

你的全能施工队,负责把想法变成实际软件/网页。

CIS (Creative Suite)

创意脑洞

适合小说家/编剧/营销,聚焦故事与世界观创作。

BMB (Builder)

进阶定制

适合 HR/法务/管理者,用于创建定制化 AI 角色。

Game Dev Studio

游戏制作

适合游戏策划/独立开发者,支持数值平衡和关卡设计。

4 第四阶段:召唤 AI 团队 (Trae 最佳实践)

BMAD 在 Trae 中通常以 .trae/rules 下的同名规则文件方式使用(不同版本 UI 入口可能不同)。 建议优先按 BMAD 官方规则名(例如 bmad-helpbmad-agent-bmm-pm)进行搜索或选择。

推荐顺序:先 Analyst 明确方向,再由 Product Manager 与 UX Designer 协同产出需求和体验方案,之后 Architect 与 Engineer 接力落地。

推荐规则名(示例) 角色 适用场景
bmad-agent-bmm-analyst 业务分析师 项目第 1 步:想法模糊时用于需求澄清。
bmad-agent-bmm-pm 产品经理 项目第 2 步:定义业务需求与 PRD,和 UX Designer 协作细化。
bmad-agent-bmm-ux-designer UX 设计师 项目第 2 步(并行):与产品经理配合设计用户流程和交互方案。
bmad-agent-bmm-architect 架构师 项目第 3 步:基于 PRD + UX 方案设计技术栈与结构。
bmad-agent-bmm-dev 工程师 项目第 4 步:实现功能并交付。

补充资料(Trae 使用细节)

如果你需要更细的 Trae 操作说明(尤其是 .trae/rules 与 BMAD 命令映射), 看 教程版; 如果只是临时查规则名/阶段/排错,直接开 速查版

案例演示:宠物社交 App "PawConnect"

产品经理实战指南

你是指挥官,拥有 Analyst、PM、Designer 等 AI 团队。本节聚焦产品阶段的方法与交付物,不展开工程实现细节。

本页这里负责主线演示(案例驱动)。如果你想按真实项目在 Trae 中逐步执行 BMAD 产品规划流程, 用 教程版; 执行过程中忘记命令、产物或下一步时,用 速查版

1

创意立项 (Initiation)

从模糊想法到清晰简报

核心成员: Business Analyst

想法示例:“做一个宠物版 Tinder”。这时呼叫 Analyst (Mary) 梳理问题。

AI 聊天窗口示例
YOU 帮我头脑风暴一个宠物社交 App,我想让狗主人能找到附近的玩伴。
ANALYST (MARY) 这是一个很有趣的方向。建议先明确目标用户、核心功能、以及线下见面的安全机制。

准备好生成文档后执行:

/bmad-bmm-create-product-brief

阶段交付物

product-brief.md
PawConnect 产品简报
  • 愿景:连接城市宠物主,形成本地社区。
  • 核心价值:地理匹配 + 安全认证。
  • 目标人群:20-35 岁城市养宠青年。

这份文档是后续 PRD、设计和架构的基石。

2

需求定义 (Requirements)

将简报转为开发文档

核心成员: Product Manager

Product Manager (John) 接手后会补齐你尚未想到的细节,比如隐私保护、非会员限制和安全流程。

John (PM)

我建议在 PRD 加入实名认证流程、紧急联系人和风险事件记录。

同意,再补充聊天界面的一键报警能力。
/bmad-bmm-create-prd
PRD.md 预览

FR-001: 宠物档案

必须上传照片并填写品种、年龄、绝育状态。

FR-002: 地图匹配

基于 LBS 显示 5km 内活跃用户。

3

设计与蓝图 (Design)

体验设计与技术可行性

UX Designer & Architect

用户体验 (UX)

设计师 Sally 负责界面流转与留存体验。

Sally 建议:采用分步引导,先选宠物类型,再填资料,最后注册。
/bmad-bmm-create-ux-design
产出: ux-spec.md

技术蓝图 (Architecture)

架构师 Winston 负责可行性与成本评估。

Winston 警告:实时位置共享建议先用 Firebase/Supabase 降低初期成本。
/bmad-bmm-create-architecture
产出: architecture.md

进阶玩法:派对模式评审

完成文档后,开启多角色会审,让 PM、架构师、设计师自动对方案提出风险与改进建议。

多角色实时对话
YOU:开启派对模式,评审“附近匹配”功能风险。
PM:需处理位置隐私,不应暴露精确坐标。
Arch:返回偏移坐标(如 500 米范围)更安全。
UX:在界面中明确提示“仅显示模糊位置”。

准备移交开发

你将得到完整“专业产品包”,显著降低沟通成本与返工概率。

交付物文件夹

  • product-brief.md - 商业愿景
  • PRD.md - 功能规则
  • ux-spec.md - 交互说明
  • architecture.md - 技术方案