用途:当用户把一项功能、用户故事、缺陷修复或有意义的改动交给代理执行时使用,将实现工作落成可运行且经过审查与验证的代码。
主要能力:通过渲染工作流文件驱动执行,支持指定 route(oneshot 或 full)与 review(none、quick、thorough,skip review 或 no review 等同 none)选项。
使用方式:运行 uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}",其中 {project-root} 为从当前目录向上最近的含 _bmad/ 的文件夹,{skill-root} 为本技能目录的绝对路径。命令只运行一次且不改变当前工作目录;指定 route 时追加 --set workflow.route=<值>,指定 review 时追加 --set workflow.review=<值>。命令应向 stdout 打印一行,据此读取并遵循渲染出的 workflow.md;若输出 HALT: <reason> 则报告原因并停止。
限制:若脚本不存在,说明项目尚未配置 BMad,可先用 bmad 技能配置后再运行,或先安装 bmad 技能。遇到其他输出或失败(包括 uv 不可用),报告命令输出并停止,不要直接运行任何工作流源码。官方文档未提供其他细节。