BMAD-METHOD 官方模块体系解析：bmb / cis / gds / tea 四大模块、安装器分发机制与版本通道

BMAD-METHOD 官方模块体系解析bmb / cis / gds / tea 四大模块、安装器分发机制与版本通道【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMAD-METHOD 的核心功能由内嵌的 core 与 bmmAgile 套件提供而领域化的扩展能力则通过官方模块体系交付在npx bmad-method install时选择 bmb、cis、gds、tea 四个官方模块之一或多个安装器会自动完成下载、配置与 IDE 集成。本文基于官方模块参考文档结合仓库中的安装文档、模块清单与 web bundle 发布清单完整讲清各模块提供的 Agent 与 Workflow 能力、安装器的模块发现机制、版本通道stable/next/pinned控制方式以及自定义模块的安装与更新流程帮助读者在实际项目中做出模块选型并稳定复现团队安装。BMad 的扩展模型核心 BMM 官方模块BMad 采用核心 模块的分层架构core内置核心模块BMad 的基础方法论与路由能力随安装器二进制一起分发不从外部仓库克隆bmmBreakthrough Method of AgileAgile 套件软件开发的敏捷流程套件同样内嵌在安装器包中官方模块bmb / cis / gds / tea为特定领域提供额外 Agent、Workflow 与任务的可选包通过独立仓库发布、由安装器按 semver tag 克隆安装。这种设计的直接体现是仓库中每个 skill 都携带一个 module-manifest.toml其中module键声明该 skill 所属的模块knowledge键指明该模块的路由知识文档位置module toolbox version 6.13.0-next update_source github:bmad-code-org/BMAD-METHOD/skills knowledge references/help.md in the bmad skill从源码结构看安装后的 BMad 帮助 skill见 bmad 帮助协议会在每次请求时重新扫描已安装 skill 的module-manifest.toml按module键把磁盘上的 skill 分组为当前模块视图再跟随knowledge指向的文档进行路由。也就是说磁盘上的 manifest 是模块成员关系的唯一事实来源——未安装的模块不会被报告为缺失成员这正是模块可选安装机制能成立的前提。安装一条命令选择官方模块安装与选择模块只需一条命令交互向导会依次询问安装目录、要安装的模块复选框形式列出 core、bmm、bmb、cis、gds、tea、是否接受各外部模块的最新稳定 tag、要集成的 AI 工具/IDE以及各模块的配置项项目名、语言、输出目录等npx bmad-method install前置条件为 Node.js 20.12安装器要求、Git克隆外部模块需要以及一个受支持的 AI 工具可用npx bmad-method install --list-tools查看全部工具 ID。详细选项参见安装文档。官方模块详解BMad Builder代码bmbBMad Builder 是元模块用来扩展 BMad 框架本身的模块提供带引导的向导帮助你创建特定领域的自定义 Agent、Workflow 与模块。npm 包名bmad-builder独立仓库发布提供能力Agent Builder— 创建拥有自定义专业领域与工具访问权限的 AI AgentWorkflow Builder— 设计包含步骤与决策点的结构化流程Module Builder— 将 Agent 与 Workflow 打包成可分享、可发布的模块交互式配置支持 YAML 配置与 npm 发布。Builder 的产物自定义模块与官方模块走同一条安装通道先发布到 Git 仓库或在本地目录开发其他团队成员用--custom-source repo-url安装见下文自定义模块安装一节。Creative Intelligence Suite代码cis面向开发前阶段upfront的结构化创意、头脑风暴与创新的 AI 工具集。套件提供多个 Agent基于成熟框架引导头脑风暴、设计思维与问题解决npm 包名bmad-creative-intelligence-suite独立仓库发布提供能力Innovation Strategist、Design Thinking Coach、Brainstorming Coach三个 AgentProblem Solver 与 Creative Problem Solver分别对应系统化思维与横向lateral思维Storyteller 与 Presentation Master用于叙事构建与演示准备头脑风暴框架包括 SCAMPER、逆向头脑风暴Reverse Brainstorming与问题重构problem reframing。SCAMPER 是一个结构化创意技术助记符Substitute替代、Combine组合、Adapt改造、Modify修改、Put to another use另作他用、Eliminate删除、Reverse反转用于系统性地探索一个产品或想法可能的变形以产生创新。值得注意的是cis 的头脑风暴能力在仓库中还有一份Web 分发版web-bundles/brainstorming-coach见 web-bundles/bundles.json把 60 种头脑风暴技术含 SCAMPER打包为可安装到 Gemini Gem / ChatGPT Custom GPT 的 web bundle供订阅用户在不消耗 IDE token 的情况下做规划。Game Dev Studio代码gds面向游戏开发的结构化 Workflow适配 Unity、Unreal、Godot 与自研引擎支持从原型到大规模生产的规划深度实现阶段收敛到标准的 Build 实现循环。npm 包名bmad-game-dev-studio独立仓库发布提供能力游戏设计文档GDD生成 Workflow—— GDD 即 Game Design Document详细描述游戏机制、世界观、角色、关卡与待开发的全部方面游戏感知的上下文与规划直接喂给标准 Build 实现循环叙事设计支持角色、对话与世界观构建覆盖 21 种游戏类型并给出引擎特定的架构建议。Test ArchitectTEA代码tea企业级测试战略、自动化建议与发布门禁决策由一个专家 AgentMuratMaster Test Architect and Quality Advisor加九个结构化 Workflow 组成。TEA 比内置的 QA Workflow 走得更深基于风险的优先级划分与需求追踪traceability。npm 包名bmad-method-test-architecture-enterprise独立仓库发布提供能力Murat Agent首席测试架构师与质量顾问测试设计、ATDD验收测试驱动开发、自动化、测试评审与需求追踪的 WorkflowNFR 评估、CI 配置与测试框架脚手架P0–P3 优先级划分附带 Playwright Utils 与可选的 MCP 集成。NFRNon-Functional Requirement指描述系统质量约束性能、安全、可靠性、易用性而非功能特性本身的需求。仓库中存在可直接对照的证据内置的 bmad-qa-generate-e2e-tests skill 是 core 侧的 E2E 测试生成能力而安装文档明确指出 TEA 的bmad-testarch-automateskill 生成的测试覆盖更重——包含 fixtures、更多测试层级与知识库模式。从源码结构看两者定位互补内置 Workflow 面向日常交付的快速验证TEA 面向需要测试策略与发布门禁的企业场景。安装结果_bmad/目录布局与 manifest无论安装哪些模块安装完成后项目内都会出现统一的_bmad/结构自定义模块与官方模块并列存放your-project/ ├── _bmad/ │ ├── core/ # 内置核心模块 │ ├── bmm/ # 官方模块如已选择 │ ├── my-module/ # 你的自定义模块 │ │ ├── my-skill/ │ │ │ └── SKILL.md │ │ └── module-help.csv │ └── _config/ │ └── manifest.yaml # 记录所有模块、版本与来源 └── ..._bmad/_config/manifest.yaml记录每个模块的确切版本例如modules: - name: bmb version: v1.7.0 # tagnext 通道则记录 main channel: stable # stable | next | pinned sha: 86033fc9aeae2ca6d52c7cdb675c1f4bf17fc1c1 source: external repoUrl: https://github.com/bmad-code-org/bmad-builder其中sha字段对所有基于 Git 的模块外部、社区、URL 型自定义模块都会写入内置模块core、bmm与本地路径型自定义模块没有该字段——它们的代码随安装器二进制或本地文件系统走不存在可克隆的 ref。自定义模块还会记录repoUrlGit 来源或localPath本地来源供后续更新时重新定位源。版本通道stable / next / pinned对每个外部模块安装器按三条通道之一解析要安装的版本通道安装内容适用人群stable默认已发布的最高 semver tag排除v2.0.0-alpha.1之类的预发布版本大多数用户next安装时刻 main 分支的 HEAD贡献者、早期采用者pinned你指定的特定 tag企业安装、CI 可复现性通道按模块独立设定可以混搭例如让 bmb 跑next而 cis 留在stable。命令行控制方式# 企业锁定安装——按字节可复现 npx bmad-method install --yes \ --modules bmm,bmb,cis \ --pin bmbv1.7.0 --pin cisv0.2.0 \ --tools claude-code # 前沿体验——外部模块全部切到 main HEAD npx bmad-method install --yes --modules bmm,bmb --all-next --tools claude-code选项重叠时的优先级为--pin胜--next--next胜--channel/--all-*后者胜注册表默认值stable。例如--all-next --pin cisv0.2.0会把 bmb、gds、tea 都切到 next同时把 cis 钉在 v0.2.0。另外注意一个边界core 与 bmm 没有自己的通道它们随安装器二进制版本走——npx bmad-method install得到稳定版 core/bmmnpx bmad-methodnext install得到预发布 core/bmm对它们使用--pin bmm...会无效并被安装器警告。完整的非交互选项表--set、--list-options、--action等见安装文档。还有一个运维细节值得记录解析稳定 tag 需要对 GitHub API 的匿名调用每个外部模块一次匿名限额为每 IP 每小时 60 次NAT 后的办公网或 CI runner 池可能耗尽该限额在环境中设置GITHUB_TOKEN任意具有公共仓库读权限的 PAT可将限额提升到每账号每小时 5000 次。自定义模块安装discovery 与 direct 两种发现模式社区模块与自定义模块通过同一个安装器安装来源可以是任意 Git 仓库或本地目录。交互式安装时在官方模块选择之后安装器会询问是否安装自定义或社区模块Git URL 或本地路径回答 yes 并输入来源后安装器列出发现的模块供勾选已安装的模块会预勾选为更新项。URL 型来源会显示警告UNVERIFIED MODULE — 该模块未经 BMad 团队审核只安装你信任的来源。安装器按来源内容选择两种发现模式模式触发条件行为Discovery来源含.claude-plugin/marketplace.json从 manifest 列出全部插件由你挑选安装哪些Direct未找到marketplace.json扫描目录中的 skill含SKILL.md的子目录作为单个模块解析需要说明的是.claude-plugin/marketplace.json只是一条共享的安装器约定不要求使用 Claude 或其 API也不改变你实际使用的 AI 工具。支持的输入类型包括任意主机的 HTTPS/HTTP URL、带子目录的 URL.../tree/main/my-module、SSH URLgithost:org/repo.git、带ref的 URL...v1.2.0、绝对本地路径与~路径。非交互安装使用--custom-source来源不可解析时会被报告并跳过其余来源继续安装多个来源可用逗号分隔。完整来源示例表、非交互配方见添加模块文档。本地开发自定义模块的典型流程用 BMad Builder 的bmad-module-builder脚手架出模块结构用 Builder 工具添加 skills、agents 与 workflows先用本地路径安装快速迭代本地来源按路径引用而非拷贝缓存重新安装即取最新改动发布到 Git 仓库他人用--custom-source your-repo-url安装如需支持 discovery 模式在仓库根加入.claude-plugin/marketplace.json。一个行为细节若安装后删除了本地源目录_bmad/中已安装的模块文件会保留只是更新时该模块被跳过直到源路径恢复。模块更新quick-update 与 update 两条路径自定义模块参与常规更新流程区别在于动作类型Quick Update--action quick-update从 manifest 记录的来源刷新已安装模块。源不可用的模块带警告跳过、文件保持原位Git 源不可达时不刷新、使用缓存的克隆。Full Update--action update重走模块选择流程可增删自定义模块。注意--yes且无--action时传了--custom-source会默认走 full update 而非 quick update。更新策略与通道联动quick-update 只对 stable 通道应用补丁与次版本升级拒绝主版本升级pinned与next通道不被 quick-update 触碰因此钉住的安装不会自行漂移——如果钉住安装确实发生了变化检查_bmad/_config/manifest.yaml中的channel: pinned及固定的version与sha。安装后的定制面customize.toml 三层合并模块不只是装上即用——每个可定制 skill 在安装目录内自带customize.toml作为定制 schema可定制字段的定义文件。定制走覆盖文件而非编辑已装文件更新永远不会触碰你的覆盖。解析器按三层读取、高层胜出优先级 1胜: _bmad/custom/skill.user.toml 个人gitignore 优先级 2: _bmad/custom/skill.toml 团队提交进仓库 优先级 3基线: skill 自带的 customize.toml 出厂默认合并规则只取决于值形状标量直接覆盖表table深合并带code或id键的表数组按键合并其他数组追加。覆盖无法删除基线项且只写稀疏覆盖省略的字段继承下层全量拷贝customize.toml会把今天的默认值锁死导致后续更新的默认值变更被静默遮蔽。可用bmad-customizeskill 走引导式定制路径。仓库中每个 skill 目录都可以看到这一机制的实体例如 bmad-agent-pm 的 customize.toml。详见定制文档。社区模块与 Marketplace参考文档明确说明社区模块与模块 Marketplace 处于即将推出à venir状态进展关注 BMad 的 GitHub 组织即可。这解释了仓库侧的现状web-bundles/目录下已有六条 bundle 发布记录见 web-bundles/bundles.json但面向 IDE 的模块 marketplace 尚未落地。作为过渡仓库提供的另一条分发通道是web bundles把 BMad skill 重新打包为 Gemini Gem 或 ChatGPT Custom GPT用于规划阶段头脑风暴、产品简报、PRFAQ、PRD、UX、市场调研产物粘回仓库后在 IDE 中继续实现。六条 bundle 均带默认 persona 与一个对照 swap persona发布记录含schemaVersion: 1.0与releasedAt: 2026-05-25标签。web bundle 与 IDE 模块定位互补——前者面向对话式规划后者面向仓库内的实现与流程。使用方式见使用 web bundles 文档。小结BMAD-METHOD 的模块体系可以归纳为四条要点模块即领域能力包bmb造模块的元模块、cis创意与头脑风暴 Agent、gds游戏开发 Workflow、tea企业级测试架构各自独立仓库发布安装时按代码bmb/cis/gds/tea勾选磁盘 manifest 是模块事实来源module-manifest.toml的module键决定 skill 的模块归属_bmad/_config/manifest.yaml记录版本、通道与来源 sha两者共同支撑帮助路由与可复现更新版本通道按模块独立stable/next/pinned 三通道可混搭--pin提供企业级锁定quick-update 不触碰 pinned 与 next自定义模块与官方模块同源同通道Git URL 或本地路径经--custom-source安装discovery 与 direct 两种模式自动选择更新复用同一 manifest 机制。对实际项目而言建议的选型路径是先用默认 core bmm 起步按领域痛点增装——需要造内部 Agent 选 bmb前期创意密集选 cis或在 Web 端用对应 bundle游戏项目选 gds企业质量门禁需求选 tea团队环境统一用--pin锁定版本并配合GITHUB_TOKEN规避 API 限流。术语表SCAMPER结构化创意技术助记符Substitute, Combine, Adapt, Modify, Put to another use, Eliminate, Reverse用于系统探索产品或想法的可行变形以产生创新NFRNon-Functional Requirement描述系统质量约束性能、安全、可靠性、易用性而非功能特性的需求GDDGame Design Document游戏设计文档详细描述游戏机制、世界观、角色、关卡及所有待开发方面ATDDAcceptance Test-Driven Development验收测试驱动开发先以验收测试定义行为再实现。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考