bmad-template/README.md

# BMAD Method 成品模板

这是一个已经安装好的 BMAD Method 成品模板，用于解决团队成员在不同 IDE 或 Agent 环境中无法正常安装、重复安装成本高的问题。

使用者不需要重新执行安装流程。把本模板放到目标项目根目录后，只保留自己使用的 IDE 目录和 BMAD 共享目录即可。

## 适用场景

- 安装 BMAD Method 失败，但需要直接使用已安装好的 skills 和 workflows。
- 希望在新项目中快速放入一套统一的 BMAD 工作流。
- 团队希望用同一套 BMAD 角色、流程和输出目录约定。

## 快速使用

### 新项目

1. 克隆或下载本仓库到目标项目根目录。
2. 按自己的 IDE 或 Agent 环境保留一个 IDE 目录。
3. 删除不使用的其它 IDE 目录，减少项目体积。
4. 在 IDE 或 Agent 中使用 `bmad-help` 查看可用能力，或直接调用具体角色和技能。

### 既有项目

1. 将本模板中的 `_bmad`、`docs`、`_bmad-output` 复制到既有项目根目录。
2. 再复制自己 IDE 对应的一个目录，例如 `.claude` 或 `.trae`。
3. 不需要复制其它 IDE 目录。
4. 打开项目后，让对应 IDE 或 Agent 重新读取项目上下文。

## 目录选择

| 目录 | 适用环境 | 是否必须保留 |
| --- | --- | --- |
| `.agents` | Codex 等没有显示对应目录名的 IDE 或 Agent 环境 | 按需保留一个 |
| `.claude` | Claude Code | 按需保留一个 |
| `.codebuddy` | CodeBuddy | 按需保留一个 |
| `.workbuddy` | WorkBuddy | 按需保留一个 |
| `.trae` | Trae | 按需保留一个 |
| `_bmad` | BMAD 共享配置、模块、脚本和工作流元数据 | 必须保留 |
| `docs` | 项目知识库目录，供 BMAD 生成和读取项目文档 | 建议保留 |
| `_bmad-output` | BMAD 规划、实现、测试等输出产物目录 | 建议保留 |

保留规则：

- 必须保留 `_bmad`。
- 至少保留一个自己使用的 IDE 目录。
- `docs` 和 `_bmad-output` 建议保留；没有内容时也用于约定后续产物位置。
- 不使用的 IDE 目录可以删除，例如只使用 Trae 时，可以删除 `.agents`、`.claude`、`.codebuddy`。

## 常用入口

打开项目后，可以先让 IDE 或 Agent 执行：

```text
bmad-help
```

常见工作流包括：

- `bmad-create-prd`：创建产品需求文档。
- `bmad-create-architecture`：创建技术架构方案。
- `bmad-create-epics-and-stories`：拆分 epic 和 story。
- `bmad-sprint-planning`：生成 sprint 实施计划。
- `bmad-create-story`：创建具体 story。
- `bmad-dev-story`：按 story 执行开发。
- `bmad-code-review`：执行代码评审。
- `bmad-tea` 或 `bmad-testarch-*`：执行测试架构、测试设计、自动化测试等流程。

也可以直接按角色调用：

- Mary：业务分析。
- John：产品管理。
- Sally：UX 设计。
- Winston：系统架构。
- Amelia：开发实现。
- Paige：技术文档。
- Murat：测试架构。

## 输出位置

默认配置位于 `_bmad/config.toml` 和 `_bmad/config.user.toml`。

常用输出位置：

- 规划产物：`_bmad-output/planning-artifacts`
- 实现产物：`_bmad-output/implementation-artifacts`
- 测试产物：`_bmad-output/test-artifacts`
- 项目知识：`docs`

## 配置说明

`_bmad/config.toml` 和 `_bmad/config.user.toml` 是安装生成配置，后续重新安装时可能被覆盖。

如需长期覆盖配置，优先使用：

- 团队共享配置：`_bmad/custom/config.toml`
- 个人本地配置：`_bmad/custom/config.user.toml`
- 单个 skill 的团队覆盖：`_bmad/custom/<skill-name>.toml`
- 单个 skill 的个人覆盖：`_bmad/custom/<skill-name>.user.toml`

个人配置文件通常不应提交到团队仓库。

## 注意事项

- 本仓库是 BMAD Method 安装后的成品模板，不是安装器源码。
- 多个 IDE 目录内容相同，区别在于不同 IDE 或 Agent 识别的目录位置不同。
- 如果使用者只保留自己的 IDE 目录，BMAD 的共享能力仍依赖 `_bmad`。
- 如果移动项目目录后出现配置解析问题，先确认 `_bmad` 是否仍在项目根目录。
- 如果不知道当前环境该保留哪个目录，先保留 `.agents` 和自己的 IDE 目录，确认可用后再清理。