用途
bmad-loop-setup 用于在项目中安装、配置和升级 bmad-loop 模块。该模块依赖 bmad-loop 编排器工具(一个 Python 程序,从公共 Git 仓库以 bmad-loop 包形式安装),技能本身不能独立工作。BMAD 安装器(npx bmad-method install)负责 _bmad/ 下的模块注册、配置与帮助文件;本技能负责安装器在结构上无法完成的部分:安装或升级编排器工具(安装器只复制技能目录,无法携带 Python 包)、运行 bmad-loop init 注册各 CLI 钩子并铺设技能、以及预检。
主要能力
- 判断是全新安装还是升级:依据用户参数或 uv tool list 中是否已有 bmad-loop 条目。
- 刷新 _bmad/bmad-loop/module-help.csv(本技能在 _bmad/ 下唯一写入的文件)。
- 从 Git 源安装或升级编排器工具,支持固定发布标签。
- 通过 bmad-loop init 为 claude、codex、gemini、copilot、antigravity 等编码 CLI 注册钩子,铺设 bmad-loop-* 技能,写入 .bmad-loop/policy.toml 模板与 gitignore 条目。
- 运行 bmad-loop validate 检查配置、sprint-status、git、tmux 和编码 CLI 的就绪情况。
- 指引用户在 policy.toml 中配置按角色(dev、review、triage)的适配器。
使用方式
安装/升级工具:
uv tool install "bmad-loop[tui] @ git+https://github.com/bmad-code-org/bmad-loop.git"
升级使用 uv tool upgrade bmad-loop --reinstall(Git 源必须加 --reinstall)。
初始化项目(可重复指定 --cli):
bmad-loop init --project "{project-root}" --cli claude
升级时追加 --force-skills 以刷新技能副本。预检:
bmad-loop validate --project "{project-root}"
适用场景
需要在项目中部署或升级 bmad-loop 自动化循环、为多个编码 CLI 注册钩子、或配置混合适配器(如开发用 claude、评审用 codex)时使用。
限制
- 不负责 _bmad/ 下的模块注册、config.toml 与帮助目录,这些归 BMAD 安装器所有。
- 若项目未经 BMAD 安装器安装模块,帮助条目需安装器下次运行后才在 /bmad-help 中可见。
- 若项目无 _bmad/ 目录,说明该项目没有 BMAD 安装,仍可安装编排器工具。
- bmad-loop --version 有输出不代表项目已配置,可能是源码检出或无关虚拟环境。
- 若配置解析脚本缺失或失败,则退回到中性英文称呼,不修改任何配置文件。