BMad 模块扩展实战指南官方模块选择、自定义源安装与本地模块开发全流程【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMadBreakthrough Method for Agile AI-Driven Development通过**模块Module**实现能力扩展官方模块在npx bmad-method install时挑选为某个领域带来超出内置核心与 BMM敏捷套件的 Agent、工作流与任务自定义与社区模块则来自任意 Git 仓库或本地目录并通过同一套安装器接入。本文以 BMad 官方文档的模块扩展流程为主线结合本仓库内的模块清单、安装辅助脚本与技能文档源码完整讲解官方模块选择、自定义源安装交互式与非交互式、安装器发现机制、本地开发迭代、更新维护以及如何创建可供他人安装的自定义模块。BMad 的模块体系核心、BMM 与可扩展模块BMad 的安装产物由三部分构成内置的core核心模块、官方的 **BMMAgile suite敏捷套件**模块以及按需扩展的领域模块。官方模块在安装时被选择安装器负责下载、配置并安装到你的 IDE 技能目录每个模块自身的文档会描述其提供的工作流。在仓库中可以看到模块化组织的直接证据每个已安装技能目录旁都带有一个module-manifest.toml清单文件。以仓库内的核心技能为例skills/bmad/module-manifest.toml 声明了module toolbox version 6.13.0-next update_source github:bmad-code-org/BMAD-METHOD/skills knowledge references/help.md in the bmad skill这个清单包含四个关键字段module该技能归属的模块名、version模块版本、update_source更新来源格式为github:org/repo/subdir、knowledge该模块知识文档的位置。仓库中的 skills/bmad/SKILL.md 进一步说明安装后技能会按module键分组module键是磁盘上声明的成员身份knowledge值则指明该模块的知识文档在哪里——这也解释了为什么安装器需要追踪模块来源无论是官方模块还是自定义模块更新时都要依据来源定位。官方模块一览运行npx bmad-method install并选择你需要的模块即可安装官方模块。当前官方模块集合如下安装器会随版本更新调整可选列表BMad Builder用于创建自定义 Agent、工作流和领域专属模块。代码bmbnpm 包bmad-builder提供能力Agent Builder——创建具有自定义专长和工具的 AgentWorkflow Builder——设计带步骤与决策点的工作流Module Builder——把 Agent 和工作流打包成可供他人安装的模块交互式安装向导支持 YAML 配置与 npm 发布支持Creative Intelligence Suite创意智能套件提供头脑风暴、设计思维与早期问题解决相关的 Agent 和框架。代码cisnpm 包bmad-creative-intelligence-suite提供能力Innovation Strategist创新战略家、Design Thinking Coach设计思维教练、Brainstorming Coach头脑风暴教练AgentProblem Solver 与 Creative Problem Solver用于系统性思维和横向思维Storyteller 与 Presentation Master用于叙事和提案陈述SCAMPER、Reverse Brainstorming逆向头脑风暴、problem reframing问题重构等构思框架Game Dev Studio游戏开发工作室覆盖 Unity、Unreal、Godot 与自定义引擎的游戏开发工作流从原型到规划化生产实现阶段使用标准的 Build 实现循环。代码gdsnpm 包bmad-game-dev-studio提供能力游戏设计文档GDD生成工作流面向游戏的规划与上下文输入标准 Build 实现循环支持角色、对话与世界构建的叙事设计覆盖 21 种游戏类型并提供引擎相关的架构指导Test ArchitectTEA通过一个 Agent 和九个工作流提供测试策略、自动化指导和发布门禁决策。其bmad-testarch-automate技能生成的测试覆盖比内置的bmad-qa-generate-e2e-tests更重包含 fixtures、更多测试层级与知识库模式。官方文档中Test Completed Work一节专门对比了两者帮助你二选一内置轻量技能的完整说明见仓库内的 skills/bmad-qa-generate-e2e-tests/SKILL.md。代码teanpm 包bmad-method-test-architecture-enterprise提供能力Murat Agent首席测试架构师与质量顾问测试设计、ATDD、自动化、测试评审与可追溯性工作流NFR 评估、CI 配置与框架脚手架P0-P3 优先级排序可选集成 Playwright Utils 与 MCP选择建议优先挑选官方模块如果官方集合未覆盖你的需求再从自定义源安装。从自定义源安装模块自定义模块是安装器从 Git 仓库或本地目录读取、而非从官方列表读取的任意模块。社区模块的安装方式完全相同社区模块的 URL 可在官方维护的插件市场仓库中查找。前置条件:::note 需要Node.js v20.12以及npx随 npm 附带若使用 Git URL 作为来源还需要Git。自定义模块既可以在全新安装过程中选择也可以添加到已有安装中。 :::与之呼应docs/start/install-bmad.md 中的安装前置条件也明确指出Node.js 20.12 或更高版本是运行安装器的要求Git 仅在安装来自 Git 的外部模块或自定义模块时才需要。交互式安装运行npx bmad-method install。在官方模块选择之后安装器会询问:::note[安装器提示] Do you want to install custom or community modules (Git URL or local path)? 是否要安装自定义或社区模块Git URL 或本地路径 :::回答 yes 并输入一个来源对于URL 来源安装器会发出安全警告UNVERIFIED MODULE: This module has not been reviewed by the BMad team. Only install modules from sources you trust.未验证模块该模块未经 BMad 团队审核只安装来自你信任来源的模块。对于本地路径安装器会提示对本地源的修改将在重新安装时生效。随后安装器会列出其发现的模块供你挑选安装已经安装过的模块会被预勾选为更新状态。在安装继续之前你还可以再添加一个来源。支持的输入类型如下输入类型示例HTTPS URL任意主机https://github.com/org/repoHTTP URL任意主机http://host/org/repo带子目录的 HTTPS URLhttps://github.com/org/repo/tree/main/my-moduleSSH URLgitgithub.com:org/repo.git带ref的 URLhttps://github.com/org/repov1.2.0本地路径/Users/me/projects/my-module带波浪号的本地路径~/projects/my-module非交互式安装使用--custom-source标志即可从命令行安装。来源中发现的每个模块都会被安装npx bmad-method install \ --directory . \ --custom-source /path/to/my-module \ --tools claude-code \ --yes--custom-source未搭配--modules时只安装核心模块和自定义模块。若还要包含官方模块请加上--modulesnpx bmad-method install \ --directory . \ --modules bmm \ --custom-source https://gitlab.com/myorg/my-module \ --tools claude-code \ --yes多个来源可以用逗号分隔。无法解析的来源会被报告并跳过其余来源照常安装--custom-source /path/one,https://github.com/org/repo,/path/two提示--tools参数用于指定目标 AI 编码工具如claude-code--directory指定安装目标目录--yes跳过交互确认适合 CI 流水线。查看 docs/start/install-bmad.md 中的无头headlessCI 安装示例可了解完整自动化参数。安装器如何发现模块安装器根据来源内容选择两种模式之一模式触发条件行为Discovery来源包含.claude-plugin/marketplace.json从清单中列出所有插件由你挑选要安装哪些Direct未找到marketplace.json扫描目录中的技能含SKILL.md的子目录将其解析为单个模块Discovery 模式是已发布模块的典型形态Direct 模式在本地开发时指向一个技能目录非常方便。:::note[关于.claude-plugin/].claude-plugin/marketplace.json是安装器共享的约定。它不需要Claude 或 Claude API也不会改变你使用的 AI 工具。 :::从源码视角看技能的判定与仓库中的模块组织方式完全一致在 skills/bmad/SKILL.md 中模块成员身份由磁盘上的module-manifest.toml的module键决定技能目录即模块的物理载体。因此 Direct 模式扫描含SKILL.md的子目录与仓库中每个技能目录的形态如 skills/bmad-brainstorming/SKILL.md 与其 skills/bmad-brainstorming/module-manifest.toml一一对应。本地开发与本地安装如果你正在用 BMad Builder 构建模块可以直接从工作目录安装npx bmad-method install \ --directory ~/my-project \ --custom-source ~/my-module-repo/skills \ --tools claude-code \ --yes本地源按路径引用不会被复制到缓存。当你修改模块源码后重新安装安装器会直接拾取最新变更——这正是本地迭代的核心优势。:::caution[源码目录被删除时] 如果在安装后删除了本地源目录_bmad/中已安装的模块文件会被保留。在源路径恢复之前该模块会在更新时被跳过。 :::安装完成后的目录结构安装完成后自定义模块会与官方模块一起出现在_bmad/中your-project/ ├── _bmad/ │ ├── core/ # 内置核心模块 │ ├── bmm/ # 官方模块如被选中 │ ├── my-module/ # 你的自定义模块 │ │ ├── my-skill/ │ │ │ └── SKILL.md │ │ └── module-help.csv │ └── _config/ │ └── manifest.yaml # 记录所有模块、版本与来源 └── ...manifest.yaml记录每个自定义模块的来源Git 来源为repoUrl本地来源为localPath以便更新时重新定位来源。这与仓库中module-manifest.toml的update_source字段设计一脉相承来源信息被持久化更新流程据此找回模块。更新与维护模块自定义模块参与常规更新流程快速更新--action quick-update从记录的来源刷新已安装模块。来源不再可用的模块会被跳过并给出警告其文件保留原位无法访问的 Git 来源不会刷新改用缓存克隆并给出警告。完整更新--action update重新执行模块选择以便添加或移除自定义模块。使用--yes且未指定--action时传入--custom-source默认执行完整更新而非快速更新。补充一点仓库源码层面的佐证仓库内bmad技能还提供只读的更新状态检查。skills/bmad/references/setup.md 说明bmad update会重扫已安装技能并读取各来源的module-manifest.toml报告每个模块的状态可能的状态包括current已最新、newer-available有更新、ahead领先、differing-unordered、could-not-check、version-spread、source-disagreement等。该检查本身只读、不安装也不移动文件当发现有更新时更新已安装技能文件夹的职责交由npx skills update即安装器体系处理——与上文quick-update/update的安装器动作形成闭环。创建可分发模块使用 BMad Builder 创建可供他人安装的模块运行bmad-module-builder搭建模块结构使用 BMad Builder 工具添加技能、Agent 与工作流发布到 Git 仓库或直接分享文件夹其他人通过--custom-source your-repo-url安装为了让模块支持 Discovery 模式请在仓库根目录包含.claude-plugin/marketplace.json具体格式参见 BMad Builder 文档。:::tip[先本地测试] 开发期间先用本地路径安装你的模块以快速迭代发布到 Git 仓库前再验证一遍。 :::安装后的定制与验证模块安装到_bmad/后你可以在_bmad/custom/下为每个技能编写 TOML 覆盖文件来定制其行为这正是模块扩展体系的延伸。仓库中的 skills/bmad/scripts/resolve_customization.py 展示了覆盖文件的解析逻辑从当前工作目录向上查找最近的_bmad/目录作为项目根再按技能自带customize.toml基础层 →_bmad/custom/skill.toml团队层 →_bmad/custom/skill.user.toml个人层的优先级合并实现见 skills/bmad/scripts/config_utils.py标量直接覆盖、表递归深合并、以code/id为键的数组合并、其余数组追加。bmad-customize技能skills/bmad-customize/SKILL.md会自动发现可定制项、生成覆盖文件并调用上述解析脚本验证合并结果。完整的分层定制规则见 docs/customize/customize-bmad.md。总结BMad 的模块体系遵循清晰的扩展路径官方模块覆盖构建器、创意、游戏与测试架构等高频领域自定义模块通过统一的--custom-source机制从任意 Git 仓库或本地目录接入支持 Discoverymarketplace.json与 Direct技能目录两种发现模式本地路径按引用生效、可快速迭代manifest.yaml与module-manifest.toml持久化模块来源支撑quick-update与完整更新。无论你是选择官方模块、安装社区模块还是用 BMad Builder 构建并发布自己的模块都可以在npx bmad-method install这一条命令下完成从安装到更新的全生命周期管理。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 BMad 模块扩展实战指南：官方模块选择、自定义源安装与本地模块开发全流程
BMad 模块扩展实战指南官方模块选择、自定义源安装与本地模块开发全流程【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHODBMadBreakthrough Method for Agile AI-Driven Development通过**模块Module**实现能力扩展官方模块在npx bmad-method install时挑选为某个领域带来超出内置核心与 BMM敏捷套件的 Agent、工作流与任务自定义与社区模块则来自任意 Git 仓库或本地目录并通过同一套安装器接入。本文以 BMad 官方文档的模块扩展流程为主线结合本仓库内的模块清单、安装辅助脚本与技能文档源码完整讲解官方模块选择、自定义源安装交互式与非交互式、安装器发现机制、本地开发迭代、更新维护以及如何创建可供他人安装的自定义模块。BMad 的模块体系核心、BMM 与可扩展模块BMad 的安装产物由三部分构成内置的core核心模块、官方的 **BMMAgile suite敏捷套件**模块以及按需扩展的领域模块。官方模块在安装时被选择安装器负责下载、配置并安装到你的 IDE 技能目录每个模块自身的文档会描述其提供的工作流。在仓库中可以看到模块化组织的直接证据每个已安装技能目录旁都带有一个module-manifest.toml清单文件。以仓库内的核心技能为例skills/bmad/module-manifest.toml 声明了module toolbox version 6.13.0-next update_source github:bmad-code-org/BMAD-METHOD/skills knowledge references/help.md in the bmad skill这个清单包含四个关键字段module该技能归属的模块名、version模块版本、update_source更新来源格式为github:org/repo/subdir、knowledge该模块知识文档的位置。仓库中的 skills/bmad/SKILL.md 进一步说明安装后技能会按module键分组module键是磁盘上声明的成员身份knowledge值则指明该模块的知识文档在哪里——这也解释了为什么安装器需要追踪模块来源无论是官方模块还是自定义模块更新时都要依据来源定位。官方模块一览运行npx bmad-method install并选择你需要的模块即可安装官方模块。当前官方模块集合如下安装器会随版本更新调整可选列表BMad Builder用于创建自定义 Agent、工作流和领域专属模块。代码bmbnpm 包bmad-builder提供能力Agent Builder——创建具有自定义专长和工具的 AgentWorkflow Builder——设计带步骤与决策点的工作流Module Builder——把 Agent 和工作流打包成可供他人安装的模块交互式安装向导支持 YAML 配置与 npm 发布支持Creative Intelligence Suite创意智能套件提供头脑风暴、设计思维与早期问题解决相关的 Agent 和框架。代码cisnpm 包bmad-creative-intelligence-suite提供能力Innovation Strategist创新战略家、Design Thinking Coach设计思维教练、Brainstorming Coach头脑风暴教练AgentProblem Solver 与 Creative Problem Solver用于系统性思维和横向思维Storyteller 与 Presentation Master用于叙事和提案陈述SCAMPER、Reverse Brainstorming逆向头脑风暴、problem reframing问题重构等构思框架Game Dev Studio游戏开发工作室覆盖 Unity、Unreal、Godot 与自定义引擎的游戏开发工作流从原型到规划化生产实现阶段使用标准的 Build 实现循环。代码gdsnpm 包bmad-game-dev-studio提供能力游戏设计文档GDD生成工作流面向游戏的规划与上下文输入标准 Build 实现循环支持角色、对话与世界构建的叙事设计覆盖 21 种游戏类型并提供引擎相关的架构指导Test ArchitectTEA通过一个 Agent 和九个工作流提供测试策略、自动化指导和发布门禁决策。其bmad-testarch-automate技能生成的测试覆盖比内置的bmad-qa-generate-e2e-tests更重包含 fixtures、更多测试层级与知识库模式。官方文档中Test Completed Work一节专门对比了两者帮助你二选一内置轻量技能的完整说明见仓库内的 skills/bmad-qa-generate-e2e-tests/SKILL.md。代码teanpm 包bmad-method-test-architecture-enterprise提供能力Murat Agent首席测试架构师与质量顾问测试设计、ATDD、自动化、测试评审与可追溯性工作流NFR 评估、CI 配置与框架脚手架P0-P3 优先级排序可选集成 Playwright Utils 与 MCP选择建议优先挑选官方模块如果官方集合未覆盖你的需求再从自定义源安装。从自定义源安装模块自定义模块是安装器从 Git 仓库或本地目录读取、而非从官方列表读取的任意模块。社区模块的安装方式完全相同社区模块的 URL 可在官方维护的插件市场仓库中查找。前置条件:::note 需要Node.js v20.12以及npx随 npm 附带若使用 Git URL 作为来源还需要Git。自定义模块既可以在全新安装过程中选择也可以添加到已有安装中。 :::与之呼应docs/start/install-bmad.md 中的安装前置条件也明确指出Node.js 20.12 或更高版本是运行安装器的要求Git 仅在安装来自 Git 的外部模块或自定义模块时才需要。交互式安装运行npx bmad-method install。在官方模块选择之后安装器会询问:::note[安装器提示] Do you want to install custom or community modules (Git URL or local path)? 是否要安装自定义或社区模块Git URL 或本地路径 :::回答 yes 并输入一个来源对于URL 来源安装器会发出安全警告UNVERIFIED MODULE: This module has not been reviewed by the BMad team. Only install modules from sources you trust.未验证模块该模块未经 BMad 团队审核只安装来自你信任来源的模块。对于本地路径安装器会提示对本地源的修改将在重新安装时生效。随后安装器会列出其发现的模块供你挑选安装已经安装过的模块会被预勾选为更新状态。在安装继续之前你还可以再添加一个来源。支持的输入类型如下输入类型示例HTTPS URL任意主机https://github.com/org/repoHTTP URL任意主机http://host/org/repo带子目录的 HTTPS URLhttps://github.com/org/repo/tree/main/my-moduleSSH URLgitgithub.com:org/repo.git带ref的 URLhttps://github.com/org/repov1.2.0本地路径/Users/me/projects/my-module带波浪号的本地路径~/projects/my-module非交互式安装使用--custom-source标志即可从命令行安装。来源中发现的每个模块都会被安装npx bmad-method install \ --directory . \ --custom-source /path/to/my-module \ --tools claude-code \ --yes--custom-source未搭配--modules时只安装核心模块和自定义模块。若还要包含官方模块请加上--modulesnpx bmad-method install \ --directory . \ --modules bmm \ --custom-source https://gitlab.com/myorg/my-module \ --tools claude-code \ --yes多个来源可以用逗号分隔。无法解析的来源会被报告并跳过其余来源照常安装--custom-source /path/one,https://github.com/org/repo,/path/two提示--tools参数用于指定目标 AI 编码工具如claude-code--directory指定安装目标目录--yes跳过交互确认适合 CI 流水线。查看 docs/start/install-bmad.md 中的无头headlessCI 安装示例可了解完整自动化参数。安装器如何发现模块安装器根据来源内容选择两种模式之一模式触发条件行为Discovery来源包含.claude-plugin/marketplace.json从清单中列出所有插件由你挑选要安装哪些Direct未找到marketplace.json扫描目录中的技能含SKILL.md的子目录将其解析为单个模块Discovery 模式是已发布模块的典型形态Direct 模式在本地开发时指向一个技能目录非常方便。:::note[关于.claude-plugin/].claude-plugin/marketplace.json是安装器共享的约定。它不需要Claude 或 Claude API也不会改变你使用的 AI 工具。 :::从源码视角看技能的判定与仓库中的模块组织方式完全一致在 skills/bmad/SKILL.md 中模块成员身份由磁盘上的module-manifest.toml的module键决定技能目录即模块的物理载体。因此 Direct 模式扫描含SKILL.md的子目录与仓库中每个技能目录的形态如 skills/bmad-brainstorming/SKILL.md 与其 skills/bmad-brainstorming/module-manifest.toml一一对应。本地开发与本地安装如果你正在用 BMad Builder 构建模块可以直接从工作目录安装npx bmad-method install \ --directory ~/my-project \ --custom-source ~/my-module-repo/skills \ --tools claude-code \ --yes本地源按路径引用不会被复制到缓存。当你修改模块源码后重新安装安装器会直接拾取最新变更——这正是本地迭代的核心优势。:::caution[源码目录被删除时] 如果在安装后删除了本地源目录_bmad/中已安装的模块文件会被保留。在源路径恢复之前该模块会在更新时被跳过。 :::安装完成后的目录结构安装完成后自定义模块会与官方模块一起出现在_bmad/中your-project/ ├── _bmad/ │ ├── core/ # 内置核心模块 │ ├── bmm/ # 官方模块如被选中 │ ├── my-module/ # 你的自定义模块 │ │ ├── my-skill/ │ │ │ └── SKILL.md │ │ └── module-help.csv │ └── _config/ │ └── manifest.yaml # 记录所有模块、版本与来源 └── ...manifest.yaml记录每个自定义模块的来源Git 来源为repoUrl本地来源为localPath以便更新时重新定位来源。这与仓库中module-manifest.toml的update_source字段设计一脉相承来源信息被持久化更新流程据此找回模块。更新与维护模块自定义模块参与常规更新流程快速更新--action quick-update从记录的来源刷新已安装模块。来源不再可用的模块会被跳过并给出警告其文件保留原位无法访问的 Git 来源不会刷新改用缓存克隆并给出警告。完整更新--action update重新执行模块选择以便添加或移除自定义模块。使用--yes且未指定--action时传入--custom-source默认执行完整更新而非快速更新。补充一点仓库源码层面的佐证仓库内bmad技能还提供只读的更新状态检查。skills/bmad/references/setup.md 说明bmad update会重扫已安装技能并读取各来源的module-manifest.toml报告每个模块的状态可能的状态包括current已最新、newer-available有更新、ahead领先、differing-unordered、could-not-check、version-spread、source-disagreement等。该检查本身只读、不安装也不移动文件当发现有更新时更新已安装技能文件夹的职责交由npx skills update即安装器体系处理——与上文quick-update/update的安装器动作形成闭环。创建可分发模块使用 BMad Builder 创建可供他人安装的模块运行bmad-module-builder搭建模块结构使用 BMad Builder 工具添加技能、Agent 与工作流发布到 Git 仓库或直接分享文件夹其他人通过--custom-source your-repo-url安装为了让模块支持 Discovery 模式请在仓库根目录包含.claude-plugin/marketplace.json具体格式参见 BMad Builder 文档。:::tip[先本地测试] 开发期间先用本地路径安装你的模块以快速迭代发布到 Git 仓库前再验证一遍。 :::安装后的定制与验证模块安装到_bmad/后你可以在_bmad/custom/下为每个技能编写 TOML 覆盖文件来定制其行为这正是模块扩展体系的延伸。仓库中的 skills/bmad/scripts/resolve_customization.py 展示了覆盖文件的解析逻辑从当前工作目录向上查找最近的_bmad/目录作为项目根再按技能自带customize.toml基础层 →_bmad/custom/skill.toml团队层 →_bmad/custom/skill.user.toml个人层的优先级合并实现见 skills/bmad/scripts/config_utils.py标量直接覆盖、表递归深合并、以code/id为键的数组合并、其余数组追加。bmad-customize技能skills/bmad-customize/SKILL.md会自动发现可定制项、生成覆盖文件并调用上述解析脚本验证合并结果。完整的分层定制规则见 docs/customize/customize-bmad.md。总结BMad 的模块体系遵循清晰的扩展路径官方模块覆盖构建器、创意、游戏与测试架构等高频领域自定义模块通过统一的--custom-source机制从任意 Git 仓库或本地目录接入支持 Discoverymarketplace.json与 Direct技能目录两种发现模式本地路径按引用生效、可快速迭代manifest.yaml与module-manifest.toml持久化模块来源支撑quick-update与完整更新。无论你是选择官方模块、安装社区模块还是用 BMad Builder 构建并发布自己的模块都可以在npx bmad-method install这一条命令下完成从安装到更新的全生命周期管理。【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考