Skip to content

In-depth technical analysis and documentation of the BMAD-METHOD multi-agent AI framework, written in Traditional Chinese. Covers Party Mode workflow, agent architecture, and design patterns.

License

Notifications You must be signed in to change notification settings

pichiu/bmad-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BMAD-METHOD Deep Dive

針對 BMAD-METHOD 框架的深度技術分析與研究文件

概述

本專案提供 BMAD-METHOD 框架的深入技術分析,以繁體中文撰寫,旨在幫助開發者和技術人員深入理解 BMAD 框架的內部運作機制、設計模式與實作細節。

什麼是 BMAD-METHOD?

BMAD-METHOD 是一個多代理 AI 協作框架,提供:

  • 多個專業 AI 代理(Architect、Developer、PM 等)
  • 結構化的工作流程(Workflow)系統
  • Party Mode 多代理協作對話
  • 完整的軟體開發生命週期支援

研究內容

Party Mode Workflow 完整分析

位置: research/party-mode-analysis/

Party Mode 是 BMAD 框架中的獨特互動式工作流程,能夠協調多個 AI 代理進行自然對話。

分析內容包含:

文件 分析重點
workflow-analysis.md 主工作流程架構與設計模式
step-01-analysis.md 代理載入與初始化流程
step-02-analysis.md 多代理對話協調引擎
step-03-analysis.md 優雅退出與狀態清理
agent-manifest-analysis.md 代理清單與人格定義
config-analysis.md 核心配置系統

代理深度分析:

代理 角色 分析連結
🧙 BMad Master 平台專家/協調者 bmad-master.md
📊 Mary Business Analyst analyst.md
🏗️ Winston Architect architect.md
💻 Amelia Developer dev.md
📋 John Product Manager pm.md
🚀 Barry Quick Flow Solo Dev quick-flow-solo-dev.md
🏃 Bob Scrum Master sm.md
🧪 Murat Test Architect tea.md
📚 Paige Technical Writer tech-writer.md
🎨 Sally UX Designer ux-designer.md

Brainstorming Workflow 完整分析

位置: research/brainstorming-analysis/

Brainstorming Workflow 是 BMAD 框架中的互動式創意促進工作流程,結合 62 種創意技術與四種技術選擇路徑,提供完整的腦力激盪會議引導。

分析內容包含:

文件 分析重點
workflow-analysis.md 主工作流程架構與初始化
step-01-analysis.md 會議設定與續行偵測
step-01b-analysis.md 工作流程續行處理
step-02a-analysis.md 用戶自選技術路徑
step-02b-analysis.md AI 推薦技術路徑
step-02c-analysis.md 隨機選擇技術路徑
step-02d-analysis.md 漸進式流程路徑
step-03-analysis.md 互動式技術執行與教練引導
step-04-analysis.md 想法整理與行動規劃
brain-methods-analysis.md 創意技術資料庫(62 技術)
template-analysis.md 會議輸出文件模板

核心設計特色:

  • 分支流程架構:四種技術選擇路徑滿足不同用戶偏好
  • 續行機制:支援會議中斷後無縫續行
  • 教練式引導:Step 3 採用真正的對話式創意教練
  • 產出導向:完整的會議文件產出

專案結構

bmad-docs/
├── README.md                      # 本文件
├── research/
│   ├── party-mode-analysis/       # Party Mode 深度分析
│   │   ├── index.md               # 分析索引
│   │   ├── workflow-analysis.md   # 工作流程分析
│   │   ├── step-01-analysis.md    # 步驟 1 分析
│   │   ├── step-02-analysis.md    # 步驟 2 分析
│   │   ├── step-03-analysis.md    # 步驟 3 分析
│   │   ├── config-analysis.md     # 配置分析
│   │   ├── agent-manifest-analysis.md  # 代理清單分析
│   │   └── agents/                # 各代理深度分析
│   │       ├── bmad-master.md
│   │       ├── analyst.md
│   │       ├── architect.md
│   │       ├── dev.md
│   │       ├── pm.md
│   │       ├── quick-flow-solo-dev.md
│   │       ├── sm.md
│   │       ├── tea.md
│   │       ├── tech-writer.md
│   │       └── ux-designer.md
│   └── brainstorming-analysis/    # Brainstorming 深度分析
│       ├── index.md               # 分析索引
│       ├── workflow-analysis.md   # 工作流程分析
│       ├── step-01-analysis.md    # 步驟 1 分析(會議設定)
│       ├── step-01b-analysis.md   # 步驟 1b 分析(續行處理)
│       ├── step-02a-analysis.md   # 步驟 2a 分析(用戶自選)
│       ├── step-02b-analysis.md   # 步驟 2b 分析(AI 推薦)
│       ├── step-02c-analysis.md   # 步驟 2c 分析(隨機選擇)
│       ├── step-02d-analysis.md   # 步驟 2d 分析(漸進流程)
│       ├── step-03-analysis.md    # 步驟 3 分析(技術執行)
│       ├── step-04-analysis.md    # 步驟 4 分析(想法整理)
│       ├── brain-methods-analysis.md  # 創意技術資料庫分析
│       └── template-analysis.md   # 輸出模板分析
└── _bmad/                         # BMAD 框架安裝(用於實際測試)

關鍵發現

共通設計模式

  1. Micro-file Architecture - 每個步驟獨立成檔,遵循單一職責原則
  2. Frontmatter State Tracking - 使用 YAML frontmatter 追蹤工作流程狀態
  3. Configuration Injection - 從 config.yaml 注入用戶偏好與專案設定
  4. On-Demand Resource Loading - 資源按需載入,優化效能

Party Mode 特有模式

  • Intelligent Agent Selection - 根據主題分析自動選擇 2-3 個最相關代理
  • Character Consistency - 嚴格遵循代理人格設定
  • TTS Integration - 語音合成整合

Brainstorming 特有模式

  • Branching Flow - 四種技術選擇路徑分支設計
  • Continuation Detection - 智慧偵測既有會議狀態
  • Coaching Dialogue Pattern - 真正的對話式創意教練引導
  • Append-Only Documentation - 漸進式文件建構

Party Mode 流程

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Step 1     │     │   Step 2     │     │   Step 3     │
│ Agent Loading│──▶  │ Discussion   │──▶  │ Graceful     │
│              │     │ Orchestration│     │ Exit         │
└──────────────┘     └──────────────┘     └──────────────┘

Brainstorming 流程

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Step 1     │     │   Step 2     │     │   Step 3     │     │   Step 4     │
│Session Setup │──▶  │  Technique   │──▶  │  Technique   │──▶  │    Idea      │
│              │     │  Selection   │     │  Execution   │     │Organization  │
└──────────────┘     └──────┬───────┘     └──────────────┘     └──────────────┘
                            │
              ┌─────────────┼─────────────┐
              │             │             │
        ┌─────┴─────┐ ┌─────┴─────┐ ┌─────┴─────┐
        │ 2a: User  │ │ 2b: AI    │ │ 2c:Random │ ...
        │ Selected  │ │ Recommend │ │ Selection │
        └───────────┘ └───────────┘ └───────────┘

參考資源

授權

本研究文件僅供學習與研究用途。BMAD-METHOD 框架的原始授權請參閱其官方倉庫。

About

In-depth technical analysis and documentation of the BMAD-METHOD multi-agent AI framework, written in Traditional Chinese. Covers Party Mode workflow, agent architecture, and design patterns.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •