title: "新手入门" description: 安装 BMad 并构建您的第一个项目
使用由专门代理提供支持的 AI 驱动的工作流，指导您完成规划、架构和实施，从而更快地构建软件。
您将学到什么
- 为新项目安装并初始化 BMad 方法
- 为您的项目规模选择合适的规划轨道
- 从需求到工作代码的各个阶段
- 有效地使用代理和工作流
:::note[先决条件]
- Node.js 20+ — 安装程序必需
- Git — 推荐用于版本控制
- AI 驱动的 IDE — Claude Code, Cursor, Windsurf, 或类似工具
- 一个项目想法 — 即使是一个简单的想法也可以用于学习 :::
:::tip[快速路径] 安装 → npx bmad-method install规划 → PM 创建 PRD，Architect 创建架构 构建 → SM 管理冲刺，DEV 实施故事 新对话 为每个工作流开始新对话以避免上下文问题。 :::
理解 BMad
BMad 通过带有专门 AI 代理的引导式工作流帮助您构建软件。该过程遵循四个阶段：
| 阶段 | 名称 | 发生什么 |
|---|---|---|
| 1 | 分析 | 头脑风暴，研究，产品简报 (可选) |
| 2 | 规划 | 创建需求 (PRD 或技术规范) |
| 3 | 解决方案设计 | 设计架构 (仅限 BMad Method/Enterprise) |
| 4 | 实施 | 逐个 Epic，逐个故事地构建 |
[[[[[打开工作流图]]]]] 以探索阶段、工作流和上下文管理。
根据您的项目复杂性，BMad 提供三个规划轨道：
| 轨道 | 适用于 | 创建的文档 |
|---|---|---|
| 快速流程 | 错误修复，简单功能，明确范围 (1-15 个故事) | 仅技术规范 |
| BMad 方法 | 产品，平台，复杂功能 (10-50+ 个故事) | PRD + 架构 + UX |
| 企业版 | 合规性，多租户系统 (30+ 个故事) | PRD + 架构 + 安全 + DevOps |
:::note 故事计数仅供指导，并非定义。根据规划需求选择您的轨道，而不是故事数学。 :::
安装
在您的项目目录中打开终端并运行：
npx bmad-method install提示选择模块时，选择 BMad Method。
安装程序创建两个文件夹：
_bmad/— 代理、工作流、任务和配置_bmad-output/— 目前为空，但这是保存您的工件的地方
在项目文件夹中打开您的 AI IDE。运行 help 工作流 (/bmad-help) 以查看下一步做什么 — 它会检测您已完成的内容并推荐下一步。
:::note[如何加载代理和运行工作流] 每个工作流都有一个您在 IDE 中运行的 斜杠命令 (例如，/bmad-bmm-create-prd)。运行工作流命令会自动加载适当的代理 — 您无需单独加载代理。您也可以直接加载代理进行一般对话 (例如，PM 代理使用 /bmad-agent-bmm-pm)。 :::
:::caution[新对话] 始终为每个工作流开始一个新的对话。这可以防止上下文限制引起问题。 :::
步骤 1: 创建您的计划
完成阶段 1-3。为每个工作流使用新对话。
阶段 1: 分析 (可选)
此阶段的所有工作流都是可选的：
- brainstorming (
/bmad-brainstorming) — 引导式构思 - research (
/bmad-bmm-research) — 市场和技术研究 - create-product-brief (
/bmad-bmm-create-product-brief) — 推荐的基础文档
阶段 2: 规划 (必需)
对于 BMad 方法和企业版轨道:
- 在新对话中加载 PM agent (
/bmad-agent-bmm-pm) - 运行
prd工作流 (/bmad-bmm-create-prd) - 输出:
PRD.md
对于快速流程轨道:
- 使用
quick-spec工作流 (/bmad-bmm-quick-spec) 代替 PRD，然后跳到实施
:::note[UX 设计 (可选)] 如果您的项目有用户界面，请在创建 PRD 后加载 UX-Designer agent (/bmad-agent-bmm-ux-designer) 并运行 UX 设计工作流 (/bmad-bmm-create-ux-design)。 :::
阶段 3: 解决方案设计 (BMad Method/Enterprise)
创建架构
- 在新对话中加载 Architect agent (
/bmad-agent-bmm-architect) - 运行
create-architecture(/bmad-bmm-create-architecture) - 输出: 包含技术决策的架构文档
创建 Epics 和故事
:::tip[V6 改进] Epics 和故事现在在架构之后创建。这产生更好的故事质量，因为架构决策（数据库、API 模式、技术栈）直接影响应该如何分解工作。 :::
- 在新对话中加载 PM agent (
/bmad-agent-bmm-pm) - 运行
create-epics-and-stories(/bmad-bmm-create-epics-and-stories) - 该工作流使用 PRD 和架构来创建技术上知情的故事
实施准备检查 (强烈推荐)
- 在新对话中加载 Architect agent (
/bmad-agent-bmm-architect) - 运行
check-implementation-readiness(/bmad-bmm-check-implementation-readiness) - 验证所有规划文档的内聚性
步骤 2: 构建您的项目
一旦规划完成，进入实施。每个工作流应在新对话中运行。
初始化冲刺规划
加载 SM agent (/bmad-agent-bmm-sm) 并运行 sprint-planning (/bmad-bmm-sprint-planning)。这将创建 sprint-status.yaml 来跟踪所有 Epics 和故事。
构建周期
对于每个故事，使用新对话重复此周期：
| 步骤 | 代理 | 工作流 | 命令 | 目的 |
|---|---|---|---|---|
| 1 | SM | create-story | /bmad-bmm-create-story | 从 Epic 创建故事文件 |
| 2 | DEV | dev-story | /bmad-bmm-dev-story | 实施故事 |
| 3 | DEV | code-review | /bmad-bmm-code-review | 质量验证 (推荐) |
完成一个 Epic 中的所有故事后，加载 SM agent (/bmad-agent-bmm-sm) 并运行 retrospective (/bmad-bmm-retrospective)。
您已完成的内容
您已学习了使用 BMad 构建的基础：
- 安装 BMad 并为您的 IDE 配置它
- 使用您选择的规划轨道初始化项目
- 创建规划文档 (PRD, Architecture, Epics & Stories)
- 了解实施的构建周期
您的项目现在拥有：
your-project/
├── _bmad/ # BMad 配置
├── _bmad-output/
│ ├── PRD.md # 您的需求文档
│ ├── architecture.md # 技术决策
│ ├── epics/ # Epic 和故事文件
│ └── sprint-status.yaml # 冲刺跟踪
└── ...快速参考
| 工作流 | 命令 | 代理 | 目的 |
|---|---|---|---|
help | /bmad-help | Any | 获取关于下一步做什么的指导 |
prd | /bmad-bmm-create-prd | PM | 创建产品需求文档 |
create-architecture | /bmad-bmm-create-architecture | Architect | 创建架构文档 |
create-epics-and-stories | /bmad-bmm-create-epics-and-stories | PM | 将 PRD 分解为 Epics |
check-implementation-readiness | /bmad-bmm-check-implementation-readiness | Architect | 验证规划内聚性 |
sprint-planning | /bmad-bmm-sprint-planning | SM | 初始化冲刺跟踪 |
create-story | /bmad-bmm-create-story | SM | 创建故事文件 |
dev-story | /bmad-bmm-dev-story | DEV | 实施故事 |
code-review | /bmad-bmm-code-review | DEV | 审查已实施的代码 |
常见问题
我总是需要架构吗？ 仅限 BMad 方法和企业版轨道。快速流程从技术规范跳过直接到实施。
我可以稍后更改我的计划吗？ 可以。SM 代理有一个 correct-course 工作流 (/bmad-bmm-correct-course) 用于处理范围变更。
如果我想先进行头脑风暴怎么办？ 加载 Analyst 代理 (/bmad-agent-bmm-analyst) 并在开始您的 PRD 之前运行 brainstorming (/bmad-brainstorming)。
我需要遵循严格的顺序吗？ 不严格。一旦您了解了流程，您可以使用上面的快速参考直接运行工作流。
获取帮助
- 在工作流期间 — 代理通过问题和解释通过指导您
- 社区 — Discord (#bmad-method-help, #report-bugs-and-issues)
- 卡住了？ — 运行
help(/bmad-help) 查看下一步做什么
关键要点
:::tip[记住这些]
- 始终使用新对话 — 为每个工作流开始一个新的对话
- 轨道很重要 — 快速流程使用 tech-spec；方法/企业版需要 PRD 和架构
- 卡住时使用
help(/bmad-help) — 它会检测您的进度并建议后续步骤 :::
准备好开始了吗？安装 BMad 并让代理指导您完成您的第一个项目。