如何升级到 v6

使用 BMad 安装程序从 v4 升级到 v6，其中包括自动检测旧版安装和迁移辅助。

何时使用本指南

您已安装 BMad v4（.bmad-method 文件夹）
您希望迁移到新的 v6 架构
您有需要保留的现有规划产物

步骤

1. 运行安装程序

按照安装程序说明操作。

2. 处理旧版安装

当检测到 v4 时，您可以：

允许安装程序备份并删除 .bmad-method
退出并手动处理清理

如果您将 bmad method 文件夹命名为其他名称 - 您需要手动删除该文件夹。

3. 清理 IDE 命令

手动删除旧版 v4 IDE 命令 - 例如如果您使用 claude，查找任何以 bmad 开头的嵌套文件夹并删除它们：

.claude/commands/BMad/agents
.claude/commands/BMad/tasks

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 哪些史诗/故事已经完成

您将获得

v6 统一结构：

your-project/
├── _bmad/               # 单一安装文件夹
│   ├── _config/         # 您的自定义配置
│   │   └── agents/      # 智能体自定义文件
│   ├── core/            # 通用核心框架
│   ├── bmm/             # BMad Method 模块
│   ├── bmb/             # BMad Builder
│   └── cis/             # Creative Intelligence Suite
└── _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
核心	`_bmad-core` 实际上是 BMad Method	`_bmad/core/` 是通用框架
方法	`_bmad-method`	`_bmad/bmm/`
配置	直接修改文件	每个模块使用 `config.yaml`
文档	需要设置分片或非分片	完全灵活，自动扫描

术语说明

agent：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
epic：史诗。在敏捷开发中，指大型的工作项，可分解为多个用户故事。
story：故事。在敏捷开发中，指用户故事，描述用户需求的功能单元。
Scrum Master：Scrum 主管。敏捷开发 Scrum 框架中的角色，负责促进团队流程和移除障碍。
sprint-planning：冲刺规划。Scrum 框架中的会议，用于确定下一个冲刺期间要完成的工作。
sharded：分片。将大型文档拆分为多个较小的文件以便于管理和处理。
PRD：产品需求文档（Product Requirements Document）。描述产品功能、需求和特性的文档。
Brief：简报。概述项目目标、范围和关键信息的文档。
UX：用户体验（User Experience）。用户在使用产品或服务过程中的整体感受和交互体验。
Architecture：架构。系统的结构设计，包括组件、模块及其相互关系。
BMGD：BMad Game Development。BMad 游戏开发模块。
DevOps：开发运维（Development Operations）。结合开发和运维的实践，旨在缩短系统开发生命周期。
BMad Method：BMad 方法。BMad 框架的核心方法论模块。
BMad Builder：BMad 构建器。BMad 框架的构建工具。
Creative Intelligence Suite：创意智能套件。BMad 框架中的创意工具集合。
IDE：集成开发环境（Integrated Development Environment）。提供代码编辑、调试等功能的软件开发工具。
progressive discovery：渐进式发现。逐步深入探索和理解需求的过程。
web search：网络搜索。通过互联网检索信息的能力。
plan mode：计划模式。IDE 中的一种工作模式，用于规划和设计任务。