bmad-method 6.0.4 → 6.0.5-next.1

package/docs/zh-cn/how-to/customize-bmad.md

@@ -0,0 +1,182 @@
+---
+title: "如何自定义 BMad"
+description: 自定义智能体、工作流和模块，同时保持更新兼容性
+sidebar:
+  order: 7
+---
+
+使用 `.customize.yaml` 文件来调整智能体行为、角色和菜单，同时在更新过程中保留您的更改。
+
+## 何时使用此功能
+
+- 您想要更改智能体的名称、个性或沟通风格
+- 您需要智能体记住项目特定的上下文
+- 您想要添加自定义菜单项来触发您自己的工作流或提示
+- 您希望智能体在每次启动时执行特定操作
+
+:::note[前置条件]
+- 在项目中安装了 BMad（参见[如何安装 BMad](./install-bmad.md)）
+- 用于编辑 YAML 文件的文本编辑器
+:::
+
+:::caution[保护您的自定义配置]
+始终使用此处描述的 `.customize.yaml` 文件，而不是直接编辑智能体文件。安装程序在更新期间会覆盖智能体文件，但会保留您的 `.customize.yaml` 更改。
+:::
+
+## 步骤
+
+### 1. 定位自定义文件
+
+安装后，在以下位置为每个智能体找到一个 `.customize.yaml` 文件：
+
+```text
+_bmad/_config/agents/
+├── core-bmad-master.customize.yaml
+├── bmm-dev.customize.yaml
+├── bmm-pm.customize.yaml
+└── ...（每个已安装的智能体一个文件）
+```
+
+### 2. 编辑自定义文件
+
+打开您想要修改的智能体的 `.customize.yaml` 文件。每个部分都是可选的——只自定义您需要的内容。
+
+| 部分               | 行为     | 用途                                           |
+| ------------------ | -------- | ---------------------------------------------- |
+| `agent.metadata`   | 替换     | 覆盖智能体的显示名称                           |
+| `persona`          | 替换     | 设置角色、身份、风格和原则                     |
+| `memories`         | 追加     | 添加智能体始终会记住的持久上下文               |
+| `menu`             | 追加     | 为工作流或提示添加自定义菜单项                 |
+| `critical_actions` | 追加     | 定义智能体的启动指令                           |
+| `prompts`          | 追加     | 创建可重复使用的提示供菜单操作使用             |
+
+标记为 **替换** 的部分会完全覆盖智能体的默认设置。标记为 **追加** 的部分会添加到现有配置中。
+
+**智能体名称**
+
+更改智能体的自我介绍方式：
+
+```yaml
+agent:
+  metadata:
+    name: 'Spongebob' # 默认值："Amelia"
+```
+
+**角色**
+
+替换智能体的个性、角色和沟通风格：
+
+```yaml
+persona:
+  role: 'Senior Full-Stack Engineer'
+  identity: 'Lives in a pineapple (under the sea)'
+  communication_style: 'Spongebob annoying'
+  principles:
+    - 'Never Nester, Spongebob Devs hate nesting more than 2 levels deep'
+    - 'Favor composition over inheritance'
+```
+
+`persona` 部分会替换整个默认角色，因此如果您设置它，请包含所有四个字段。
+
+**记忆**
+
+添加智能体将始终记住的持久上下文：
+
+```yaml
+memories:
+  - 'Works at Krusty Krab'
+  - 'Favorite Celebrity: David Hasslehoff'
+  - 'Learned in Epic 1 that it is not cool to just pretend that tests have passed'
+```
+
+**菜单项**
+
+向智能体的显示菜单添加自定义条目。每个条目需要一个 `trigger`、一个目标（`workflow` 路径或 `action` 引用）和一个 `description`：
+
+```yaml
+menu:
+  - trigger: my-workflow
+    workflow: 'my-custom/workflows/my-workflow.yaml'
+    description: My custom workflow
+  - trigger: deploy
+    action: '#deploy-prompt'
+    description: Deploy to production
+```
+
+**关键操作**
+
+定义智能体启动时运行的指令：
+
+```yaml
+critical_actions:
+  - 'Check the CI Pipelines with the XYZ Skill and alert user on wake if anything is urgently needing attention'
+```
+
+**自定义提示**
+
+创建可重复使用的提示，菜单项可以通过 `action="#id"` 引用：
+
+```yaml
+prompts:
+  - id: deploy-prompt
+    content: |
+      Deploy the current branch to production:
+      1. Run all tests
+      2. Build the project
+      3. Execute deployment script
+```
+
+### 3. 应用您的更改
+
+编辑后，重新编译智能体以应用更改：
+
+```bash
+npx bmad-method install
+```
+
+安装程序会检测现有安装并提供以下选项：
+
+| Option                       | What It Does                                                        |
+| ---------------------------- | ------------------------------------------------------------------- |
+| **Quick Update**             | 将所有模块更新到最新版本并重新编译所有智能体                 |
+| **Recompile Agents**         | 仅应用自定义配置，不更新模块文件                             |
+| **Modify BMad Installation** | 用于添加或删除模块的完整安装流程                             |
+
+对于仅自定义配置的更改，**Recompile Agents** 是最快的选项。
+
+## 故障排除
+
+**更改未生效？**
+
+- 运行 `npx bmad-method install` 并选择 **Recompile Agents** 以应用更改
+- 检查您的 YAML 语法是否有效（缩进很重要）
+- 验证您编辑的是该智能体正确的 `.customize.yaml` 文件
+
+**智能体无法加载？**
+
+- 使用在线 YAML 验证器检查 YAML 语法错误
+- 确保在取消注释后没有留下空字段
+- 尝试恢复到原始模板并重新构建
+
+**需要重置智能体？**
+
+- 清空或删除智能体的 `.customize.yaml` 文件
+- 运行 `npx bmad-method install` 并选择 **Recompile Agents** 以恢复默认设置
+
+## 工作流自定义
+
+对现有 BMad Method 工作流和技能的自定义即将推出。
+
+## 模块自定义
+
+关于构建扩展模块和自定义现有模块的指南即将推出。
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定目标。
+- **persona**：角色。指智能体的身份、个性、沟通风格和行为原则的集合。
+- **memory**：记忆。指智能体持久存储的上下文信息，用于在对话中保持连贯性。
+- **critical action**：关键操作。指智能体启动时必须执行的指令或任务。
+- **prompt**：提示。指发送给智能体的输入文本，用于引导其生成特定响应或执行特定操作。

package/docs/zh-cn/how-to/established-projects.md

@@ -0,0 +1,134 @@
+---
+title: "既有项目"
+description: 如何在现有代码库中使用 BMad Method
+sidebar:
+  order: 6
+---
+
+在现有项目和遗留代码库上工作时，有效使用 BMad Method。
+
+本指南涵盖了使用 BMad Method 接入现有项目的核心工作流程。
+
+:::note[前置条件]
+- 已安装 BMad Method（`npx bmad-method install`）
+- 一个你想要处理的现有代码库
+- 访问 AI 驱动的 IDE（Claude Code 或 Cursor）
+:::
+
+## 步骤 1：清理已完成的规划产物
+
+如果你通过 BMad 流程完成了所有 PRD 史诗和用户故事，请清理这些文件。归档它们、删除它们，或者在需要时依赖版本历史。不要将这些文件保留在：
+
+- `docs/`
+- `_bmad-output/planning-artifacts/`
+- `_bmad-output/implementation-artifacts/`
+
+## 步骤 2：创建项目上下文
+
+:::tip[推荐用于既有项目]
+生成 `project-context.md` 以捕获你现有代码库的模式和约定。这确保 AI 智能体在实施变更时遵循你既定的实践。
+:::
+
+运行生成项目上下文工作流程：
+
+```bash
+/bmad-bmm-generate-project-context
+```
+
+这将扫描你的代码库以识别：
+- 技术栈和版本
+- 代码组织模式
+- 命名约定
+- 测试方法
+- 框架特定模式
+
+你可以查看和完善生成的文件，或者如果你更喜欢，可以在 `_bmad-output/project-context.md` 手动创建它。
+
+[了解更多关于项目上下文](../explanation/project-context.md)
+
+## 步骤 3：维护高质量项目文档
+
+你的 `docs/` 文件夹应包含简洁、组织良好的文档，准确代表你的项目：
+
+- 意图和业务理由
+- 业务规则
+- 架构
+- 任何其他相关的项目信息
+
+对于复杂项目，考虑使用 `document-project` 工作流程。它提供运行时变体，将扫描你的整个项目并记录其实际当前状态。
+
+## 步骤 3：获取帮助
+
+### BMad-Help：你的起点
+
+**随时运行 `/bmad-help`，当你不确定下一步该做什么时。** 这个智能指南：
+
+- 检查你的项目以查看已经完成了什么
+- 根据你安装的模块显示选项
+- 理解自然语言查询
+
+```
+/bmad-help 我有一个现有的 Rails 应用，我应该从哪里开始？
+/bmad-help quick-flow 和完整方法有什么区别？
+/bmad-help 显示我有哪些可用的工作流程
+```
+
+BMad-Help 还会在**每个工作流程结束时自动运行**，提供关于下一步该做什么的清晰指导。
+
+### 选择你的方法
+
+根据变更范围，你有两个主要选项：
+
+| 范围                          | 推荐方法                                                                                                          |
+| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| **小型更新或添加** | 使用 `quick-flow-solo-dev` 创建技术规范并实施变更。完整的四阶段 BMad Method 可能有些过度。 |
+| **重大变更或添加** | 从 BMad Method 开始，根据需要应用或多或少的严谨性。                                                    |
+
+### 在创建 PRD 期间
+
+在创建简报或直接进入 PRD 时，确保智能体：
+
+- 查找并分析你现有的项目文档
+- 阅读关于你当前系统的适当上下文
+
+你可以明确地指导智能体，但目标是确保新功能与你的现有系统良好集成。
+
+### UX 考量
+
+UX 工作是可选的。决定不取决于你的项目是否有 UX，而取决于：
+
+- 你是否将处理 UX 变更
+- 是否需要重要的新 UX 设计或模式
+
+如果你的变更只是对你满意的现有屏幕进行简单更新，则不需要完整的 UX 流程。
+
+### 架构考量
+
+在进行架构工作时，确保架构师：
+
+- 使用适当的已记录文件
+- 扫描现有代码库
+
+在此处要密切注意，以防止重新发明轮子或做出与你现有架构不一致的决定。
+
+## 更多信息
+
+- **[快速修复](./quick-fixes.md)** - 错误修复和临时变更
+- **[既有项目 FAQ](../explanation/established-projects-faq.md)** - 关于在既有项目上工作的常见问题
+
+---
+## 术语说明
+
+- **BMad Method**：BMad 方法。一种结构化的软件开发方法论，用于指导从分析到实施的完整流程。
+- **PRD**：产品需求文档（Product Requirements Document）。描述产品功能、需求和目标的文档。
+- **epic**：史诗。大型功能或用户故事的集合，通常需要较长时间完成。
+- **story**：用户故事。描述用户需求的简短陈述，通常遵循"作为...我想要...以便于..."的格式。
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **IDE**：集成开发环境（Integrated Development Environment）。提供代码编辑、调试、构建等功能的软件工具。
+- **UX**：用户体验（User Experience）。用户在使用产品或服务过程中的整体感受和交互体验。
+- **tech-spec**：技术规范（Technical Specification）。描述技术实现细节、架构设计和开发标准的文档。
+- **quick-flow**：快速流程。BMad Method 中的一种简化工作流程，适用于小型变更或快速迭代。
+- **legacy codebase**：遗留代码库。指历史遗留的、可能缺乏文档或使用过时技术的代码集合。
+- **project context**：项目上下文。描述项目技术栈、约定、模式等背景信息的文档。
+- **artifact**：产物。在开发过程中生成的文档、代码或其他输出物。
+- **runtime variant**：运行时变体。在程序运行时可选择或切换的不同实现方式或配置。

package/docs/zh-cn/how-to/get-answers-about-bmad.md

@@ -0,0 +1,144 @@
+---
+title: "如何获取关于 BMad 的答案"
+description: 使用 LLM 快速回答您自己的 BMad 问题
+sidebar:
+  order: 4
+---
+
+## 从这里开始：BMad-Help
+
+**获取关于 BMad 答案的最快方式是 `/bmad-help`。** 这个智能指南可以回答超过 80% 的问题，并且直接在您的 IDE 中可用，方便您工作时使用。
+
+BMad-Help 不仅仅是一个查询工具——它：
+- **检查您的项目**以查看已完成的内容
+- **理解自然语言**——用简单的英语提问
+- **根据您安装的模块变化**——显示相关选项
+- **在工作流后自动运行**——告诉您接下来该做什么
+- **推荐第一个必需任务**——无需猜测从哪里开始
+
+### 如何使用 BMad-Help
+
+只需使用斜杠命令运行它：
+
+```
+/bmad-help
+```
+
+或者结合自然语言查询：
+
+```
+/bmad-help 我有一个 SaaS 想法并且知道所有功能。我应该从哪里开始？
+/bmad-help 我在 UX 设计方面有哪些选择？
+/bmad-help 我在 PRD 工作流上卡住了
+/bmad-help 向我展示到目前为止已完成的内容
+```
+
+BMad-Help 会回应：
+- 针对您情况的建议
+- 第一个必需任务是什么
+- 流程的其余部分是什么样的
+
+---
+
+## 何时使用本指南
+
+在以下情况下使用本节：
+- 您想了解 BMad 的架构或内部机制
+- 您需要 BMad-Help 提供范围之外的答案
+- 您在安装前研究 BMad
+- 您想直接探索源代码
+
+## 步骤
+
+### 1. 选择您的来源
+
+| 来源               | 最适合用于                                  | 示例                     |
+| -------------------- | ----------------------------------------- | ---------------------------- |
+| **`_bmad` 文件夹**   | BMad 如何工作——智能体、工作流、提示词 | "PM 智能体做什么？" |
+| **完整的 GitHub 仓库** | 历史、安装程序、架构          | "v6 中有什么变化？"        |
+| **`llms-full.txt`**  | 来自文档的快速概述                  | "解释 BMad 的四个阶段" |
+
+`_bmad` 文件夹在您安装 BMad 时创建。如果您还没有它，请改为克隆仓库。
+
+### 2. 将您的 AI 指向来源
+
+**如果您的 AI 可以读取文件（Claude Code、Cursor 等）：**
+
+- **已安装 BMad：** 指向 `_bmad` 文件夹并直接提问
+- **想要更深入的上下文：** 克隆[完整仓库](https://github.com/bmad-code-org/BMAD-METHOD)
+
+**如果您使用 ChatGPT 或 Claude.ai：**
+
+将 `llms-full.txt` 获取到您的会话中：
+
+```text
+https://bmad-code-org.github.io/BMAD-METHOD/llms-full.txt
+```
+
+
+### 3. 提出您的问题
+
+:::note[示例]
+**问：** "告诉我用 BMad 构建某物的最快方式"
+
+**答：** 使用快速流程：运行 `quick-spec` 编写技术规范，然后运行 `quick-dev` 实现它——跳过完整的规划阶段。
+:::
+
+## 您将获得什么
+
+关于 BMad 的直接答案——智能体如何工作、工作流做什么、为什么事物以这种方式构建——无需等待其他人回应。
+
+## 提示
+
+- **验证令人惊讶的答案**——LLM 偶尔会出错。检查源文件或在 Discord 上询问。
+- **具体化**——"PRD 工作流的第 3 步做什么？"比"PRD 如何工作？"更好
+
+## 仍然卡住了？
+
+尝试了 LLM 方法但仍需要帮助？您现在有一个更好的问题可以问。
+
+| 频道                   | 用于                                     |
+| ------------------------- | ------------------------------------------- |
+| `#bmad-method-help`       | 快速问题（实时聊天）            |
+| `help-requests` 论坛     | 详细问题（可搜索、持久） |
+| `#suggestions-feedback`   | 想法和功能请求                  |
+| `#report-bugs-and-issues` | 错误报告                                 |
+
+**Discord：** [discord.gg/gk8jAdXWmj](https://discord.gg/gk8jAdXWmj)
+
+**GitHub Issues：** [github.com/bmad-code-org/BMAD-METHOD/issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)（用于明确的错误）
+
+*你！*
+        *卡住*
+              *在队列中——*
+                       *等待*
+                               *等待谁？*
+
+*来源*
+        *就在那里，*
+                *显而易见！*
+
+*指向*
+      *你的机器。*
+               *释放它。*
+
+*它读取。*
+         *它说话。*
+                 *尽管问——*
+
+*为什么要等*
+         *明天*
+                 *当你拥有*
+                         *今天？*
+
+*—Claude*
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **LLM**：大语言模型。基于深度学习的自然语言处理模型，能够理解和生成人类语言。
+- **SaaS**：软件即服务。一种通过互联网提供软件应用的交付模式。
+- **UX**：用户体验。用户在使用产品或服务过程中建立的主观感受和评价。
+- **PRD**：产品需求文档。详细描述产品功能、特性和需求的正式文档。
+- **IDE**：集成开发环境。提供代码编辑、调试、构建等功能的软件开发工具。

package/docs/zh-cn/how-to/install-bmad.md

@@ -0,0 +1,105 @@
+---
+title: "如何安装 BMad"
+description: 在项目中安装 BMad 的分步指南
+sidebar:
+  order: 1
+---
+
+使用 `npx bmad-method install` 命令在项目中设置 BMad，并选择你需要的模块和 AI 工具。
+
+如果你想使用非交互式安装程序并在命令行中提供所有安装选项，请参阅[本指南](./non-interactive-installation.md)。
+
+## 何时使用
+
+- 使用 BMad 启动新项目
+- 将 BMad 添加到现有代码库
+- 更新现有的 BMad 安装
+
+:::note[前置条件]
+- **Node.js** 20+（安装程序必需）
+- **Git**（推荐）
+- **AI 工具**（Claude Code、Cursor 或类似工具）
+:::
+
+## 步骤
+
+### 1. 运行安装程序
+
+```bash
+npx bmad-method install
+```
+
+:::tip[最新版本]
+要从主分支安装最新版本（可能不稳定）：
+```bash
+npx github:bmad-code-org/BMAD-METHOD install
+```
+:::
+
+### 2. 选择安装位置
+
+安装程序会询问在哪里安装 BMad 文件：
+
+- 当前目录（如果你自己创建了目录并从该目录运行，推荐用于新项目）
+- 自定义路径
+
+### 3. 选择你的 AI 工具
+
+选择你使用的 AI 工具：
+
+- Claude Code
+- Cursor
+- 其他
+
+每个工具都有自己的命令集成方式。安装程序会创建微小的提示文件来激活工作流和智能体——它只是将它们放在工具期望找到的位置。
+
+### 4. 选择模块
+
+安装程序会显示可用的模块。选择你需要的模块——大多数用户只需要 **BMad Method**（软件开发模块）。
+
+### 5. 按照提示操作
+
+安装程序会引导你完成剩余步骤——自定义内容、设置等。
+
+## 你将获得
+
+```text
+your-project/
+├── _bmad/
+│   ├── bmm/            # 你选择的模块
+│   │   └── config.yaml # 模块设置（如果你需要更改它们）
+│   ├── core/           # 必需的核心模块
+│   └── ...
+├── _bmad-output/       # 生成的工件
+├── .claude/            # Claude Code 命令（如果使用 Claude Code）
+└── .kiro/              # Kiro 引导文件（如果使用 Kiro）
+```
+
+## 验证安装
+
+运行 `/bmad-help` 来验证一切正常并查看下一步操作。
+
+**BMad-Help 是你的智能向导**，它会：
+- 确认你的安装正常工作
+- 根据你安装的模块显示可用内容
+- 推荐你的第一步
+
+你也可以向它提问：
+```
+/bmad-help 我刚安装完成，应该先做什么？
+/bmad-help 对于 SaaS 项目我有哪些选项？
+```
+
+## 故障排除
+
+**安装程序抛出错误**——将输出复制粘贴到你的 AI 助手中，让它来解决问题。
+
+**安装程序工作正常但后续出现问题**——你的 AI 需要 BMad 上下文才能提供帮助。请参阅[如何获取关于 BMad 的答案](./get-answers-about-bmad.md)了解如何将你的 AI 指向正确的来源。
+
+---
+## 术语说明
+
+- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
+- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定目标。
+- **module**：模块。指软件系统中可独立开发、测试和维护的功能单元。
+- **artifact**：工件。指在软件开发过程中生成的任何输出，如文档、代码、配置文件等。