title: "如何升级到 v6" description: 从 BMad v4 迁移到 v6
使用 BMad 安装程序从 v4 升级到 v6，其中包括自动检测旧安装和迁移协助。
何时使用
- 您安装了 BMad v4 (
.bmad-method文件夹) - 您想迁移到新的 v6 架构
- 您有现有的规划工件需要保留
:::note[先决条件]
- Node.js 20+
- 现有的 BMad v4 安装 :::
步骤
1. 运行安装程序
bash
npx bmad-method install安装程序自动检测：
- 旧版 v4 文件夹:
.bmad-method - IDE 命令工件:
.claude/commands/，.cursor/commands/等中的旧版 bmad 文件夹
2. 处理旧版安装
检测到 v4 时，您可以：
- 允许安装程序备份并移除
.bmad-method - 退出并手动处理清理
- 保留两者（同一项目不推荐）
3. 清理 IDE 命令
手动移除旧版 v4 IDE 命令：
.claude/commands/BMad/agents.claude/commands/BMad/tasks
新的 v6 命令将位于 .claude/commands/bmad/<module>/agents|workflows。
:::tip[意外删除了命令?] 如果您删除了错误的命令，请重新运行安装程序并选择 "quick update" 以恢复它们。 :::
4. 迁移规划工件
如果您有规划文档 (Brief/PRD/UX/Architecture):
将它们移动到 _bmad-output/planning-artifacts/ 并使用描述性名称：
- PRD 文档文件名中包含
PRD - 相应地包含
brief、architecture或ux-design - 分片文档可以在命名的子文件夹中
如果您在规划中期: 考虑使用 v6 工作流重新开始。使用您现有的文档作为输入—带有网络搜索和 IDE 计划模式的新渐进式发现工作流会产生更好的结果。
5. 迁移进行中的开发
如果您有已创建或实施的故事：
- 完成 v6 安装
- 将
epics.md或epics/epic*.md放置在_bmad-output/planning-artifacts/中 - 运行 Scrum Master 的
sprint-planning工作流 - 告诉 SM 哪些 Epic/故事已经完成
6. 迁移代理自定义
v4: 直接修改 _bmad-* 文件夹中的代理文件
v6: 所有自定义都在 _bmad/_config/agents/ 中，使用 customize 文件：
yaml
# _bmad/_config/agents/bmm-pm.customize.yaml
persona:
name: 'Captain Jack'
role: 'Swashbuckling Product Owner'
communication_style: |
- Talk like a pirate
- Use nautical metaphors修改自定义文件后，重新运行安装程序并选择 "rebuild all agents" 或 "quick update"。
您得到什么
v6 统一结构:
your-project/
└── _bmad/ # 单一安装文件夹
├── _config/ # 您的自定义
│ └── agents/ # 代理自定义文件
├── core/ # 通用核心框架
├── bmm/ # BMad 方法模块
├── bmb/ # BMad 构建器
└── cis/ # 创意智能套件
├── _bmad-output/ # 输出文件夹 (在 v4 中是 doc 文件夹)模块迁移
| v4 模块 | v6 状态 |
|---|---|
_bmad-2d-phaser-game-dev | 集成到 BMGD 模块 |
_bmad-2d-unity-game-dev | 集成到 BMGD 模块 |
_bmad-godot-game-dev | 集成到 BMGD 模块 |
_bmad-infrastructure-devops | 已弃用 — 新 DevOps 代理即将推出 |
_bmad-creative-writing | 未适配 — 新 v6 模块即将推出 |
关键变化
| 概念 | v4 | v6 |
|---|---|---|
| Core | _bmad-core 实际上是 BMad 方法 | _bmad/core/ 是通用框架 |
| Method | _bmad-method | _bmad/bmm/ |
| Config | 直接修改文件 | 每个模块 config.yaml |
| Documents | 需要分片或未分片设置 | 完全灵活，自动扫描 |
提示
- 首先备份 — 保留您的 v4 安装，直到您验证 v6 工作正常
- 使用 v6 工作流 — 即使是部分规划文档也能从 v6 改进的发现中受益
- 自定义后重建 — 更改 customize 文件后始终运行安装程序