Skip to main content

BMAD

BMAD-METHOD™：通用 AI 代理框架

Foundations in Agentic Agile Driven Development, known as the Breakthrough Method of Agile AI-Driven Development, yet so much more. Transform any domain with specialized AI expertise: software development, entertainment, creative writing, business strategy to personal wellness just to name a few.
以「Agentic Agile Driven Development」為基礎，亦即突破性的敏捷 AI 驅動開發方法，但它的涵蓋遠不止於此。以專業化的 AI 專長改造任何領域：軟體開發、娛樂、創意寫作、商業策略到個人健康等，僅舉幾例。

Join our Discord Community - A growing community for AI enthusiasts! Get help, share ideas, explore AI agents & frameworks, collaborate on tech projects, enjoy hobbies, and help each other succeed. Whether you're stuck on BMad, building your own agents, or just want to chat about the latest in AI - we're here for you! Some mobile and VPN may have issue joining the discord, this is a discord issue - if the invite does not work, try from your own internet or another network, or non-VPN.
加入我們的 Discord 社群 - 一個為 AI 愛好者成長中的社群！獲得幫助、分享想法、探索 AI 代理與框架、在技術專案上協作、享受興趣嗜好並互相助益成功。無論你在 BMAD 上卡關、正在打造自己的代理，或只是想聊聊 AI 的最新動向——我們都在這裡！部分手機與 VPN 可能會有加入 Discord 的問題，這是 Discord 的問題──若邀請連結無法使用，請嘗試使用你自己的網路或其他網路，或停用 VPN。

⭐ If you find this project helpful or useful, please give it a star in the upper right hand corner! It helps others discover BMAD-METHOD™ and you will be notified of updates!
⭐ 如果您覺得此專案有幫助或有用，請在右上角為它點個星！這有助於其他人發現 BMAD-METHOD™，同時您也會收到更新通知！

Overview  概覽

BMAD-METHOD™'s Two Key Innovations:
BMAD-METHOD™ 的兩大創新：

1. Agentic Planning: Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.
1. Agentic Planning（代理式規劃）：專職代理人（分析師、專案經理、架構師）與您協作，建立詳細且一致的產品需求文件（PRD）與架構文件。透過進階的提示工程與人類介入的反覆精修，這些規劃代理人能產出遠超一般 AI 任務生成的完整規格。

2. Context-Engineered Development: The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
2. Context-Engineered Development（情境工程化開發）：然後由 Scrum Master 代理人將這些詳細計畫轉換為超詳盡的開發故事，內含開發代理人所需的一切——完整情境、實作細節與嵌入於故事檔案中的架構指引。

This two-phase approach eliminates both planning inconsistency and context loss - the biggest problems in AI-assisted development. Your Dev agent opens a story file with complete understanding of what to build, how to build it, and why.
這種兩階段方法同時消除了規劃不一致與情境遺失——這是 AI 輔助開發中最大的兩個問題。你的開發代理會帶著對要建構的內容、如何建構以及為何建構的完整理解來開啟一個故事檔案。

📖 See the complete workflow in the User Guide - Planning phase, development cycle, and all agent roles
📖 請參閱使用者指南中的完整工作流程——規劃階段、開發循環，以及所有代理角色

Quick Navigation  快速導覽

Understanding the BMad Workflow
理解 BMad 工作流程

Before diving in, review these critical workflow diagrams that explain how BMad works:
在深入之前，先檢視這些說明 BMad 運作方式的關鍵工作流程圖：

  1. Planning Workflow (Web UI) - How to create PRD and Architecture documents
    規劃工作流程（Web UI）— 如何建立 PRD 與架構文件
  2. Core Development Cycle (IDE) - How SM, Dev, and QA agents collaborate through story files
    核心開發循環（IDE）— SM、開發與 QA 代理如何透過故事檔案協作
⚠️ These diagrams explain 90% of BMad Method Agentic Agile flow confusion - Understanding the PRD+Architecture creation and the SM/Dev/QA workflow and how agents pass notes through story files is essential - and also explains why this is NOT taskmaster or just a simple task runner!
⚠️ 這些圖解說明了 BMad 方法中約 90% 的代理式敏捷流程疑惑 — 理解 PRD+架構的建立以及 SM/開發/QA 的工作流程，還有代理如何透過故事檔案傳遞紀錄，是非常重要的 — 同時也說明為什麼這不是 Taskmaster 或僅僅一個簡單的任務執行器！

What would you like to do?
您想要做什麼？

Important: Keep Your BMad Installation Updated
重要：保持你的 BMad 安裝為最新版本

Stay up-to-date effortlessly! If you already have BMAD-METHOD™ installed in your project, simply run:
輕鬆保持最新狀態！如果你已在專案中安裝 BMAD-METHOD™，只需執行：

npx bmad-method install
# OR
git pull
npm run install:bmad

This will:  這將會：

  • ✅ Automatically detect your existing v4 installation
    ✅ 自動偵測您現有的 v4 安裝
  • ✅ Update only the files that have changed and add new files
    ✅ 只更新已變更的檔案並新增新檔案
  • ✅ Create .bak backup files for any custom modifications you've made
    ✅ 為您所做的任何自訂修改建立 .bak 個備份檔案
  • ✅ Preserve your project-specific configurations
    ✅ 保留您專案的特定設定

This makes it easy to benefit from the latest improvements, bug fixes, and new agents without losing your customizations!
這讓您能輕鬆受益於最新的改進、錯誤修正和新代理，同時不會遺失您的自訂設定！

Quick Start  快速開始

One Command for Everything (IDE Installation)
一條指令搞定一切（IDE 安裝）

Just run one of these commands:
只需執行下列其中一個指令：

npx bmad-method install
# OR if you already have BMad installed:
git pull
npm run install:bmad

This single command handles:
這個單一指令處理：

  • New installations - Sets up BMad in your project
    新增安裝 — 在您的專案中設定 BMad
  • Upgrades - Updates existing installations automatically
    升級 - 自動更新現有安裝
  • Expansion packs - Installs any expansion packs you've added to package.json
    擴充套件包 - 安裝你在 package.json 中加入的任何擴充套件包
That's it! Whether you're installing for the first time, upgrading, or adding expansion packs - these commands do everything.
就是這樣！無論你是第一次安裝、升級，或新增擴充套件包——這些指令都會完成所有工作。

Prerequisites: Node.js v20+ required
前置需求：需要 Node.js v20+

Fastest Start: Web UI Full Stack Team at your disposal (2 minutes)
最快上手：隨時可用的網頁介面全端團隊（2 分鐘）

  1. Get the bundle: Save or clone the full stack team file or choose another team
    取得套件：儲存或複製完整團隊檔案，或選擇其他團隊
  2. Create AI agent: Create a new Gemini Gem or CustomGPT
    建立 AI 代理：建立新的 Gemini Gem 或 CustomGPT
  3. Upload & configure: Upload the file and set instructions: "Your critical operating instructions are attached, do not break character as directed"
    上傳並設定：上傳檔案並設定指示：「您的關鍵操作指示已附上，請依指示保持角色設定，不得破格」
  4. Start Ideating and Planning: Start chatting! Type *help to see available commands or pick an agent like *analyst to start right in on creating a brief.
    開始構想與規劃：開始聊天！輸入 *help 可查看可用指令，或選擇像 *analyst 這樣的代理直接開始撰寫簡報。
  5. CRITICAL: Talk to BMad Orchestrator in the web at ANY TIME (#bmad-orchestrator command) and ask it questions about how this all works!
    重要：在任何時候都可以透過網頁與 BMad Orchestrator 對話（使用 #bmad-orchestrator 指令），並詢問它這整個流程如何運作！
  6. When to move to the IDE: Once you have your PRD, Architecture, optional UX and Briefs - its time to switch over to the IDE to shard your docs, and start implementing the actual code! See the User guide for more details
    何時切換到 IDE：當你已有 PRD、架構圖、可選的 UX 與簡報時——就是該切換到 IDE 來分割你的文件並開始實作實際程式碼的時候！更多細節請參閱使用者指南

Alternative: Clone and Build
替代方案：複製並建置

git clone https://github.com/bmadcode/bmad-method.git
npm run install:bmad # build and install all to a destination folder

🌟 Beyond Software Development - Expansion Packs
🌟 超越軟體開發 — 擴充套件

BMAD™'s natural language framework works in ANY domain. Expansion packs provide specialized AI agents for creative writing, business strategy, health & wellness, education, and more. Also expansion packs can expand the core BMAD-METHOD™ with specific functionality that is not generic for all cases. See the Expansion Packs Guide and learn to create your own!
BMAD™ 的自然語言框架適用於任何領域。擴充套件提供專門的 AI 代理，用於創意寫作、商業策略、健康與養生、教育等領域。擴充套件也能為核心 BMAD-METHOD™ 擴展特定功能，這些功能並非對所有情況都通用。請參閱擴充套件指南並學習如何創建你自己的擴充套件！

Documentation & Resources
文件與資源

Essential Guides  重要指南

  • 📖 User Guide - Complete walkthrough from project inception to completion
    📖 使用者指南 - 從專案啟動到完成的完整步驟說明
  • 🏗️ Core Architecture - Technical deep dive and system design
    🏗️ 核心架構 - 技術深究與系統設計
  • 🚀 Expansion Packs Guide - Extend BMad to any domain beyond software development
    🚀 擴充包指南 — 將 BMad 延伸至軟體開發以外的任何領域

Support  支援

Contributing  貢獻

We're excited about contributions and welcome your ideas, improvements, and expansion packs! 🎉
我們很歡迎各種貢獻，期待你的想法、改進與擴充包！🎉

📋 Read CONTRIBUTING.md - Complete guide to contributing, including guidelines, process, and requirements
📋 閱讀 CONTRIBUTING.md - 完整的貢獻指南，包含規範、流程與需求

Working with Forks  與 Fork 一起工作

When you fork this repository, CI/CD workflows are disabled by default to save resources. This is intentional and helps keep your fork clean.
當你 fork 這個 repository 時，CI/CD 工作流程預設會被停用以節省資源。這是刻意為之，有助於保持你的 fork 清爽。

Need CI/CD in Your Fork?
在你的 Fork 需要 CI/CD 嗎？

See our Fork CI/CD Guide for instructions on enabling workflows in your fork.
請參閱我們的 Fork CI/CD 指南，了解如何在你的 fork 中啟用工作流程。

Contributing Workflow  貢獻工作流程

  1. Fork the repository - Click the Fork button on GitHub
    Fork（派生）此儲存庫 — 在 GitHub 上點擊 Fork 按鈕
  2. Clone your fork - git clone https://github.com/YOUR-USERNAME/BMAD-METHOD.git
    將你的 fork 複製到本機 — git clone https://github.com/YOUR-USERNAME/BMAD-METHOD.git
  3. Create a feature branch - git checkout -b feature/amazing-feature
    建立功能分支 — git checkout -b feature/amazing-feature
  4. Make your changes - Test locally with npm test
    在本機使用 npm test 進行測試並進行變更
  5. Commit your changes - git commit -m 'feat: add amazing feature'
    提交你的變更 — git commit -m 'feat: add amazing feature'
  6. Push to your fork - git push origin feature/amazing-feature
    推送到你的 fork — git push origin feature/amazing-feature
  7. Open a Pull Request - CI/CD will run automatically on the PR
    開啟 Pull Request — CI/CD 將在 PR 上自動執行

Your contributions are tested when you submit a PR - no need to enable CI in your fork!
當您提交 PR 時，您的貢獻會被測試 — 不需要在您的 fork 中啟用 CI！

License  授權條款

MIT License - see LICENSE for details.
MIT 授權 — 詳情請見 LICENSE。

Trademark Notice  商標聲明

BMAD™ and BMAD-METHOD™ are trademarks of BMad Code, LLC. All rights reserved.
BMAD™ 及 BMAD-METHOD™ 為 BMad Code, LLC 之商標。版權所有，並保留一切權利。