用途:在项目中安装、配置和升级 BMad Auto 模块。它做两件事:注册模块配置与帮助条目;安装或升级 bmad-auto 编排器(驱动循环的 Python 程序),并引导项目就绪。首次安装与升级由同一技能处理,重复运行视为升级。
主要能力:读取 ./assets/module.yaml 获取模块标识与变量;收集用户偏好并写入 {project-root}/_bmad/config.yaml(共享配置)、config.user.yaml(个人设置,建议 gitignore)、module-help.csv(帮助系统注册);采用防僵尸模式先删旧条目再写新值。安装编排器时支持 claude、codex、gemini 三种编码 CLI 适配器,注册钩子并铺设 bmad-auto-* 技能;升级时用 --force-skills 刷新技能副本。
必要用法:安装命令 uv tool install "bmad-auto[tui] @ git+https://github.com/bmad-code-org/bmad-auto.git";升级 uv tool upgrade bmad-auto --reinstall;引导 bmad-auto init --project "{project-root}" --cli claude;校验 bmad-auto validate --project "{project-root}"。配置脚本:python3 ./scripts/merge-config.py 与 merge-help-csv.py;清理脚本 cleanup-legacy.py。注意路径参数中的 {project-root} 需替换为真实项目根,配置值内则保留字面量。
适用场景:需要为项目部署 BMAD Auto 自动化循环、配置多 CLI 角色策略(.automator/policy.toml)或迁移旧版配置时。
限制:四个技能本身不工作,依赖编排器;validate 在项目未就绪时非零退出属预期;首次运行需在项目中启动一次 CLI 并接受信任与钩子对话框;具体收费、价格与效果资料暂未提供。