第四章. BMAD 工作流与 Vibe Kanban 的深度整合

第三章我学过了，手动操作多个看板创建子任务太累了啊，有没有什么更轻量的方法呢？有的！那就是BMAD方法开发范式

如果还不明白BMAD的，建议去看一下我博客文章里的BMAD系列，这里不在多赘述，重点讲解Vibe KanBan如何结合BMAD

本章学习路径：

4.0. 理解 BMAD 与 Vibe Kanban 的协作关系

在开始整合之前，我们需要先理解这两个工具的本质。

4.0.1. BMAD 是什么？

BMAD（Breakthrough Method for Agile AI-Driven Development）是一套 结构化的 AI 驱动开发方法论，它将软件开发拆解为四个阶段：

每个阶段的核心产物：

4.0.2. Vibe Kanban 是什么？

Vibe Kanban 是一个 AI 代理的编排平台，它提供了：

• 任务管理：看板式的任务管理界面
• 并行执行：通过 Git Worktree 实现多任务并行
• 代码审查：内置 Diff 工具和 Review 流程
• 分支管理：自动创建和合并分支

Vibe Kanban 的核心能力：

让多个 AI Agent 在不同的工作目录中并行工作，互不干扰

4.0.3. 为什么需要整合？

如果只用 Vibe Kanban，你会遇到以下问题：

整合后的优势：

4.1. 在项目中安装 BMAD 方法论

BMAD 不是一个需要安装的软件包，而是一套 目录结构 + 文档模板 + Agent 配置 的组合。

4.1.1. 安装 BMAD 方法论包

在理解 BMAD 之前，我们先把 BMAD 的仓库拉下来看看。它以一个 Github 仓库 的形式存在，安装后会在你的项目里生成一个 _bmad 目录。

1

npx bmad-method@alpha install

安装程序会启动一个交互式配置向导。这个过程会问你一系列问题，我们逐个解释：

问题 1：安装目录

1
2

? Installation directory: C:\Users\YourName\Desktop\BMADTest
? Install to this directory? Yes

这个没什么好说的，选一个你想放项目的地方。

问题 2：选择开发工具

1
2
3
4

? Select tools to configure:
  ◉ Claude Code ⭐
  ◯ Windsurf
  ◯ VS Code

虽然 BMAD 的本质是让 AI 去读取 _bmad 目录下的工作流文件，理论上选哪个 IDE 都能工作。但我们后面提供的 profiles.json 生成脚本是专门针对 Claude Code 配置设计的，所以这里必须选 Claude Code。

必须按空格键选中，然后按回车确认。只是高亮不算选中。

问题 3：配置语言和输出

1
2
3
4

? What shall the agents call you? Prorise
? Preferred chat language/style? Chinese
? Preferred document output language? Chinese
? Where should default output files be saved? _bmad-output

这里有个关键点：对话语言和文档语言可以分开设置。

• 对话语言：AI 用什么语言跟你交流
• 文档语言：PRD、架构文档等工件用什么语言输出

我选了中文，因为 PRD 和架构文档用中文写更自然。但如果你的团队是国际化的，可以选英文。

问题 4：选择模块

1
2
3
4

? Select modules to install:
  ◉ BMM: BMad Method Agile-AI Driven-Development
  ◯ BMB: BMad Builder (Create Custom Agents)
  ◯ CIS: Creative Innovation Suite

这里有三个模块：

第一次使用建议只选 BMM，因为想先体验标准流程。等熟悉了再用 BMB 定制自己的 Agent。

问题 5：是否启用 TTS

1

? Claude Code supports TTS (Text-to-Speech). Would you like to enable it? No

这个功能可以让 AI 用语音跟你对话。我选了 No，因为这部分我们不需要，没必要下载额外依赖。

4.2. 使用脚本生成 Vibe Kanban 的 Agent 配置

BMAD 方法论定义了多个角色（Analyst、PM、Architect、Developer 等），我们需要在 Vibe Kanban 中为每个角色创建专用的 Agent 配置。

手动配置这些角色非常繁琐，所以我提供了一个 Python 脚本包，可以自动读取 BMAD 的 Agent 文件并生成 Vibe Kanban 的 profiles.json。

4.2.1. 下载脚本包

下载地址：https://prorise-blog.oss-cn-guangzhou.aliyuncs.com/博客文件存储/bmad_scripts.rar

下载后解压到项目的 scripts 目录：

1
2
3
4
5
6
7

your-project/
├── _bmad/           # BMAD 安装后生成的目录
├── scripts/         # 解压脚本包到这里
│   ├── generate_vibe_profiles.py
│   ├── model_config.yaml
│   └── profiles.json  # 运行脚本后生成
└── ...

4.2.2. 脚本包内容说明

4.2.3. 运行脚本

确保你已经安装了 Python 和 PyYAML：

1

pip install pyyaml

然后运行脚本：

1
2

cd scripts
python generate_vibe_profiles.py

输出示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

============================================================
BMAD Agents → Vibe Kanban profiles.json 生成器
============================================================
已加载模型配置: C:\Users\Prorise\Desktop\bmadtest\scripts\model_config.yaml
处理 Agent: analyst
处理 Agent: architect
处理 Agent: dev
处理 Agent: pm
处理 Agent: quick-flow-solo-dev
处理 Agent: sm
处理 Agent: tea
处理 Agent: tech-writer
处理 Agent: ux-designer
处理 Agent: bmad-master

✅ 生成完成: C:\Users\Prorise\Desktop\bmadtest\scripts\profiles.json
   - CLAUDE_CODE profiles: 11
   - GEMINI profiles: 11
   - CODEX profiles: 11

📁 请将生成的文件复制到:
   C:\Users\Prorise\AppData\Roaming\bloop\vibe-kanban\data\profiles.json

4.2.4. 复制配置文件

将生成的 profiles.json 复制到 Vibe Kanban 的配置目录：

Windows 路径：

1

%APPDATA%\bloop\vibe-kanban\data\profiles.json

Mac/Linux 路径：

1

~/.config/bloop/vibe-kanban/data/profiles.json

复制完成后，重启 Vibe Kanban 使配置生效。

4.3. 自定义模型配置

脚本包中的 model_config.yaml 文件允许你自定义每个 Agent 使用的模型。

4.3.1. 配置文件结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# Claude Code 中转模型设置
claude_settings:
  use_relay: false  # true = 中转模式, false = 原生模式

# 默认模型配置
defaults:
  claude: sonnet
  gemini: gemini-3-flash-preview
  codex: gpt-5.1-codex-max

# Agent 模型配置
agents:
  analyst:
    claude: sonnet
    gemini: gemini-3-pro-preview
    codex: gpt-5.1-codex-mini

  architect:
    claude: opus
    gemini: gemini-3-pro-preview
    codex: gpt-5.2

  # ... 其他 Agent 配置

4.3.2. 可用模型列表

Claude Code 可用模型：

• opus - 最强大，适合复杂任务
• sonnet - 平衡性能，推荐默认
• haiku - 轻量快速，适合简单任务

Gemini 可用模型：

• gemini-3-pro-preview - 最强大
• gemini-3-flash-preview - 快速，推荐分析任务
• gemini-2.5-pro - 稳定版
• gemini-2.5-flash - 稳定快速版

Codex (OpenAI) 可用模型：

• gpt-5.2-codex - 最新最强
• gpt-5.1-codex-max - 强大稳定
• gpt-5.1-codex-mini - 轻量快速

4.3.3. 按角色推荐的模型配置

配置原则：

• 分析类任务（Analyst、PM）使用轻量模型，快速响应
• 架构设计（Architect）使用最强模型，需要深度推理
• 代码实现（Dev）使用平衡模型，兼顾速度和质量
• 文档写作（Tech Writer）使用轻量模型，简单任务

4.3.4. 修改配置后重新生成

修改 model_config.yaml 后，重新运行脚本即可：

1

python generate_vibe_profiles.py

然后将新生成的 profiles.json 复制到 Vibe Kanban 目录。

4.4. 生成的 Agent 配置说明

脚本会为每个 BMAD Agent 生成三种 Executor 的配置：CLAUDE_CODE、GEMINI、CODEX。

4.4.1. 生成的 Agent 列表

4.4.2. 配置结构示例

每个 Agent 的配置结构如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "ANALYST": {
    "CLAUDE_CODE": {
      "append_prompt": "你必须完全扮演这个 Agent 的角色...",
      "claude_code_router": false,
      "dangerously_skip_permissions": true,
      "disable_api_key": true,
      "additional_params": [],
      "plan": true
    }
  }
}

关键字段说明：

4.5. 在 Vibe Kanban 中使用 BMAD Agent

配置完成后，你可以在 Vibe Kanban 中创建任务时选择对应的 Agent。

4.5.1. 创建任务时选择 Agent

在 Vibe Kanban 中创建任务时：

1. 选择 代理（Executor）：CLAUDE_CODE / GEMINI / CODEX
2. 选择 配置（Profile）：ANALYST / PM / ARCHITECT / DEV 等

4.5.2. BMAD 工作流速查表

4.6. 本章小结

核心要点回顾

1. BMAD 的本质

BMAD 是一套结构化的工作流方法论，将开发拆解为 4 个阶段：Analysis → Planning → Solutioning → Implementation。

2. 安装注意事项

安装 BMAD 时必须选择 Claude Code 配置，因为我们的脚本是针对 Claude Code 设计的。

3. 使用脚本生成配置

• 下载脚本包到 scripts 目录
• 运行 python generate_vibe_profiles.py
• 将生成的 profiles.json 复制到 Vibe Kanban 配置目录

4. 自定义模型配置

通过修改 model_config.yaml 可以为不同角色配置不同的模型，实现成本和性能的平衡。