关于 bmad-module-builder
bmad-module-builder 帮助 BMad 用户从构想或现有技能出发,规划、搭建并验证可安装模块。它提供构思、创建和验证路径,创建与验证支持无交互模式。
主要功能
- 01构思模块方向与架构
- 02创建可安装模块的基础结构
- 03为多技能模块生成设置技能
- 04在单技能模块中嵌入注册流程
- 05验证模块结构与能力登记
- 06无交互创建与验证
适用场景
- 01从初步想法规划模块
- 02将现有技能打包为模块
- 03为多技能模块准备设置流程
- 04检查模块结构和注册信息
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bmad-code-org/ bmad-builder --skill bmad-module-builder安装后在 Claude Code 中输入/bmad-module-builder确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/module-plan-template.mdassets/setup-skill-template/assets/module-help.csvmodule.yamlassets/setup-skill-template/scripts/cleanup-legacy.pymerge-config.pymerge-help-csv.pyassets/standalone-module-template/merge-config.pymerge-help-csv.pymodule-setup.mdreferences/create-module.mdideate-module.mdvalidate-module.mdscripts/scaffold-setup-skill.pyscaffold-standalone-module.pyvalidate-module.pyscripts/tests/test-scaffold-setup-skill.pytest-scaffold-standalone-module.pytest-validate-module.py详细介绍
BMad 模块构建器
概述
此技能可帮助你将 BMad 模块变为现实——从最初的灵感,到完整搭建并可安装的模块。它提供三种路径:
- 构思模块(IM) — 通过创意头脑风暴,帮助你设想模块的形态,决定合适的架构(Agent、工作流或两者兼有),并生成详细的计划文档。随后,该计划会引导你使用 Agent Builder 和 Workflow Builder 构建各个部分。
- 创建模块(CM) — 基于现有的技能文件夹(或单个技能)搭建模块基础设施,让模块可供安装。对于包含多个技能的模块,会生成专用的
-setup技能;对于单技能模块,则将自注册功能直接嵌入该技能。支持--headless/-H。 - 验证模块(VM) — 检查模块结构是否完整且正确——每项技能的功能是否都已注册、条目是否准确且完善,以及结构是否完整。支持包含多个技能的模块和独立模块。支持
--headless/-H。
参数: CM 和 VM 路径支持 --headless / -H;IM 路径接受初始描述;CM/VM 路径接受技能文件夹路径或单个 SKILL.md 文件路径。
激活时
从 {project-root}/_bmad/config.yaml 和 {project-root}/_bmad/config.user.yaml(根目录及 bmb 部分)加载可用配置。如果两者都不存在,则回退到 {project-root}/_bmad/bmb/config.yaml(旧版的按模块配置格式)。如果该文件仍不存在,请告知用户,bmad-builder-setup 可随时配置此模块。未配置的项目使用合理的默认值。
检测用户意图:
- 构思 / 规划关键词,或未提供路径参数 → 加载
./references/ideate-module.md - 创建 / 搭建关键词、文件夹路径,或单个 SKILL.md 文件路径 → 加载
./references/create-module.md - 验证 / 检查关键词 → 加载
./references/validate-module.md - 不明确 → 提供以下选项:
- 构思模块(IM) —“我有一个模块构想,想进行头脑风暴并制定计划”
- 创建模块(CM) —“我已经构建好技能,想将它们打包成模块”
- 验证模块(VM) —“我想检查模块的设置技能是否完整且正确”
如果传入 --headless 或 -H,则以无头模式路由到 CM。
评论
支持 Markdown