mcpField
B
bmad-module-builder

bmad-module-builder

github.com/bmad-code-orgAgent 工作流217110 次安装5 周前更新
代码仓库

关于 bmad-module-builder

bmad-module-builder 帮助 BMad 用户从构想或现有技能出发,规划、搭建并验证可安装模块。它提供构思、创建和验证路径,创建与验证支持无交互模式。

主要功能

  1. 01构思模块方向与架构
  2. 02创建可安装模块的基础结构
  3. 03为多技能模块生成设置技能
  4. 04在单技能模块中嵌入注册流程
  5. 05验证模块结构与能力登记
  6. 06无交互创建与验证

适用场景

  1. 01从初步想法规划模块
  2. 02将现有技能打包为模块
  3. 03为多技能模块准备设置流程
  4. 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.md
assets/setup-skill-template/assets/
module-help.csv
module.yaml
assets/setup-skill-template/scripts/
cleanup-legacy.py
merge-config.py
merge-help-csv.py
assets/standalone-module-template/
merge-config.py
merge-help-csv.py
module-setup.md
references/
create-module.md
ideate-module.md
validate-module.md
scripts/
scaffold-setup-skill.py
scaffold-standalone-module.py
validate-module.py
scripts/tests/
test-scaffold-setup-skill.py
test-scaffold-standalone-module.py
test-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