用途:审计新格式 BMAD 源文件中的文件引用约定违规。适用目录为 src/bmm、src/core、src/utility,排除旧格式的 src/bmm/workflows/4-implementation/。
约定:文件路径引用必须使用 {project-root}/_bmad/... 规范形式,或(新格式步骤文件中){installed_path}/...;模板与运行时变量(如 {nextStepFile}、{workflowFile}、{{mustache}}、{output_folder}、{communication_language} 等)应跳过。需标记的违规包括:./step-NN.md 或 ../something.md 相对路径;step-NN.md 裸文件名;steps/step-NN.md 缺前缀的 steps 相对路径;_bmad/core/tasks/help.md 缺 {project-root}/ 的裸 _bmad/ 路径;/Users/...、/home/...、C:... 等绝对系统路径。围栏代码块内的引用为例外,跳过。
用法:先运行 find src/bmm src/core src/utility -type f ( -name ".md" -o -name ".yaml" ) | grep -v "4-implementation" | sort 获取文件列表;按约 20 个文件分批,每批用 subagent_type: "Explore"、model: "haiku" 的子代理读取各文件,返回格式为 path/to/file.md:LINE_NUMBER | VIOLATION_TYPE | offending text,无违规记为 path/to/file.md | clean,并以 FILES CHECKED: N 结尾。汇总后需自检:find 返回的总文件数应与各子代理 FILES CHECKED 之和一致,不一致则补跑缺失文件,全部核对完成后再输出按违规类型分组的最终报告,含每条 file:line 与违规文本、违规总数及受影响文件数;无发现时输出 All files conform to the convention.。
限制:仅针对上述目录的新格式文件;不对围栏代码块与模板变量报错;依赖并行 Haiku 子代理执行读取;其它运行环境、安装方式与收费信息暂未提供。