用途:在项目中安装、配置与升级 bmad-loop 模块,并安装其编排器工具(驱动循环的 Python 程序),因为模块技能自身不执行任何操作。BMAD 安装器只复制技能目录,不携带 Python 包,因此工具安装由本技能负责。
主要能力:刷新 _bmad/bmad-loop/module-help.csv(本技能在 _bmad/ 下唯一写入的文件,幂等);通过 uv tool 从公开 Git 仓库 https://github.com/bmad-code-org/bmad-loop 安装或升级编排器,[tui] 额外项提供 Textual 仪表盘;运行 bmad-loop init 注册各 CLI 钩子、铺放 bmad-loop-* 技能、写入 .bmad-loop/policy.toml 与 gitignore;运行 bmad-loop validate 做预检。
使用方式:先读 ./assets/module.yaml 取模块元数据,判断全新安装或升级,并明确告知用户。命令示例:uv tool install "bmad-loop[tui] @ git+https://github.com/bmad-code-org/bmad-loop.git",升级用 uv tool upgrade bmad-loop --reinstall(Git 源必须加 --reinstall 才会拉取新代码),或加 @v<X.Y.Z> 固定版本。初始化:bmad-loop init --project "{project-root}" --cli claude,可重复 --cli 选择多个(claude、codex、gemini、copilot、antigravity),升级时加 --force-skills 刷新技能副本。预检:bmad-loop validate --project "{project-root}"。适配器选择由 policy.toml 的 [adapter] 及 [adapter.dev]/[adapter.review]/[adapter.triage] 控制,任何写入 policy.toml 的 CLI 都需先用 --cli 注册。
限制:模块注册、config.toml 与帮助目录由 BMAD 安装器负责,本技能不写这些内容;未通过安装器的项目需运行 npx bmad-method install 后帮助条目才在 /bmad-help 显示;validate 在项目未就绪时返回非零,属正常就绪清单;{project-root} 在配置值中是字面标记,但在文件系统路径参数中需解析为真实路径;脚本缺失时以中性英文称呼用户,不修复配置文件。其余收费、价格与平台细节暂未提供。