101 lines
3.9 KiB
Markdown
101 lines
3.9 KiB
Markdown
---
|
|
title: "Cách nâng cấp lên v6"
|
|
description: Di chuyển từ BMad v4 sang v6
|
|
sidebar:
|
|
order: 3
|
|
---
|
|
|
|
Sử dụng trình cài đặt BMad để nâng cấp từ v4 lên v6, bao gồm khả năng tự động phát hiện bản cài đặt cũ và hỗ trợ di chuyển.
|
|
|
|
## Khi nào nên dùng
|
|
|
|
- Bạn đang dùng BMad v4 (thư mục `.bmad-method`)
|
|
- Bạn muốn chuyển sang kiến trúc v6 mới
|
|
- Bạn có các planning artifact hiện có cần giữ lại
|
|
|
|
:::note[Điều kiện tiên quyết]
|
|
- Node.js 20+
|
|
- Bản cài đặt BMad v4 hiện có
|
|
:::
|
|
|
|
## Các bước thực hiện
|
|
|
|
### 1. Chạy trình cài đặt
|
|
|
|
Làm theo [Hướng dẫn cài đặt](./install-bmad.md).
|
|
|
|
### 2. Xử lý bản cài đặt cũ
|
|
|
|
Khi v4 được phát hiện, bạn có thể:
|
|
|
|
- Cho phép trình cài đặt sao lưu và xóa `.bmad-method`
|
|
- Thoát và tự xử lý dọn dẹp thủ công
|
|
|
|
Nếu trước đây bạn đặt tên thư mục BMad khác - bạn sẽ phải tự xóa thư mục đó.
|
|
|
|
### 3. Dọn dẹp skill IDE cũ
|
|
|
|
Tự xóa các command/skill IDE cũ của v4 - ví dụ nếu bạn dùng Claude Code, hãy tìm các thư mục lồng nhau bắt đầu bằng `bmad` và xóa chúng:
|
|
|
|
- `.claude/commands/`
|
|
|
|
Các skill v6 mới sẽ được cài tại:
|
|
|
|
- `.claude/skills/`
|
|
|
|
### 4. Di chuyển planning artifacts
|
|
|
|
**Nếu bạn có tài liệu lập kế hoạch (Brief/PRD/UX/Architecture):**
|
|
|
|
Di chuyển chúng vào `_bmad-output/planning-artifacts/` với tên mô tả rõ ràng:
|
|
|
|
- Tên tệp PRD nên chứa `PRD`
|
|
- Tên tệp tương ứng nên chứa `brief`, `architecture`, hoặc `ux-design`
|
|
- Tài liệu đã chia nhỏ có thể đặt trong các thư mục con đặt tên phù hợp
|
|
|
|
**Nếu bạn đang lập kế hoạch dở dang:** Hãy cân nhắc bắt đầu lại với workflow v6. Bạn vẫn có thể dùng các tài liệu hiện có làm input - các workflow discovery tiên tiến trong v6, kết hợp web search và chế độ plan trong IDE, cho kết quả tốt hơn.
|
|
|
|
### 5. Di chuyển công việc phát triển đang dở dang
|
|
|
|
Nếu bạn đã có các story được tạo hoặc đã triển khai:
|
|
|
|
1. Hoàn thành cài đặt v6
|
|
2. Đặt `epics.md` hoặc `epics/epic*.md` vào `_bmad-output/planning-artifacts/`
|
|
3. Chạy workflow `bmad-sprint-planning` của Scrum Master
|
|
4. Nói rõ với SM những epic/story nào đã hoàn thành
|
|
|
|
## Bạn nhận được gì
|
|
|
|
**Cấu trúc thống nhất của v6:**
|
|
|
|
```text
|
|
du-an-cua-ban/
|
|
├── _bmad/ # Thư mục cài đặt duy nhất
|
|
│ ├── _config/ # Các tùy chỉnh của bạn
|
|
│ │ └── agents/ # Tệp tùy chỉnh agent
|
|
│ ├── core/ # Framework core dùng chung
|
|
│ ├── bmm/ # Module BMad Method
|
|
│ ├── bmb/ # BMad Builder
|
|
│ └── cis/ # Creative Intelligence Suite
|
|
└── _bmad-output/ # Thư mục output (là thư mục docs trong v4)
|
|
```
|
|
|
|
## Di chuyển module
|
|
|
|
| Module v4 | Trạng thái trong v6 |
|
|
| --- | --- |
|
|
| `.bmad-2d-phaser-game-dev` | Đã được tích hợp vào module BMGD |
|
|
| `.bmad-2d-unity-game-dev` | Đã được tích hợp vào module BMGD |
|
|
| `.bmad-godot-game-dev` | Đã được tích hợp vào module BMGD |
|
|
| `.bmad-infrastructure-devops` | Đã bị ngừng hỗ trợ - agent DevOps mới sắp ra mắt |
|
|
| `.bmad-creative-writing` | Chưa được điều chỉnh - module v6 mới sắp ra mắt |
|
|
|
|
## Các thay đổi chính
|
|
|
|
| Khái niệm | v4 | v6 |
|
|
| --- | --- | --- |
|
|
| **Core** | `_bmad-core` thực chất là BMad Method | `_bmad/core/` là framework dùng chung |
|
|
| **Method** | `_bmad-method` | `_bmad/bmm/` |
|
|
| **Config** | Sửa trực tiếp các tệp | `config.yaml` theo từng module |
|
|
| **Documents** | Cần thiết lập trước cho bản chia nhỏ hoặc nguyên khối | Linh hoạt hoàn toàn, tự động quét |
|