121 lines
5.4 KiB
Markdown
121 lines
5.4 KiB
Markdown
---
|
||
title: "如何升级到 v6"
|
||
description: 从 BMad v4 迁移到 v6
|
||
sidebar:
|
||
order: 3
|
||
---
|
||
|
||
使用 BMad 安装程序从 v4 升级到 v6，其中包括自动检测旧版安装和迁移辅助。
|
||
|
||
## 何时使用本指南
|
||
|
||
- 您已安装 BMad v4（`.bmad-method` 文件夹）
|
||
- 您希望迁移到新的 v6 架构
|
||
- 您有需要保留的现有规划产物
|
||
|
||
:::note[前置条件]
|
||
- Node.js 20+
|
||
- 现有的 BMad v4 安装
|
||
:::
|
||
|
||
## 步骤
|
||
|
||
### 1. 运行安装程序
|
||
|
||
按照[安装程序说明](./install-bmad.md)操作。
|
||
|
||
### 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. 迁移进行中的开发
|
||
|
||
如果您已创建或实现了故事：
|
||
|
||
1. 完成 v6 安装
|
||
2. 将 `epics.md` 或 `epics/epic*.md` 放入 `_bmad-output/planning-artifacts/`
|
||
3. 运行 Scrum Master 的 `sprint-planning` 工作流
|
||
4. 告诉 SM 哪些史诗/故事已经完成
|
||
|
||
## 您将获得
|
||
|
||
**v6 统一结构：**
|
||
|
||
```text
|
||
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 中的一种工作模式，用于规划和设计任务。
|