BMad Review 通过“镜头”审查内容,每个镜头是一种独立的方法与立场,最终以统一格式报告发现,且强调只报告真实问题、不为显得全面而凑数。多数镜头允许零发现;对立批评镜头要求至少十条具体发现,空结果被视为需复查的信号;编辑类镜头视内容为不可更改,只批评组织与表达方式。
镜头集合由 {workflow.lenses} 解析结果决定,并非固定列表,覆盖项可增删镜头。输入包括:content(待审查的 diff、分支、未提交改动、文件、规格、故事或任何文档);可选 lenses(镜头代码或名称,支持 skill:bmad-review lenses=<code> 形式,默认运行全部适用镜头);可选 also_consider(额外关注点);可选 claims(变更自身的叙述,仅交给边界情况镜头);可选预解析定制项。
路径约定:裸路径从 {skill-root} 解析,{project-root} 为最近的含 _bmad/ 的目录。style_guide、review_guidance、persistent_facts 中 file: 前缀表示文件路径或 glob,读取失败时在输出头注明并继续。
执行流程:先运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析定制;脚本不存在时说明 BMad 未配置,可安装 npx skills add bmad-code-org/BMAD-METHOD --skill bmad 后重试;其他失败则直接读 customize.toml 用默认值。随后加载内容并暂存为文件(分支取与基分支合并基点的 diff,未提交改动含未跟踪文件),空或不可解码时按调用方契约返回或提示。最后选择镜头、单行公布计划并运行。
输出为一个 JSON 数组,集中所有镜头的发现,每条含 lens、location、trigger_condition、guard_snippet、potential_consequence,镜头可扩展字段或自定义形状(编辑类镜头输出表格);[] 表示无发现;不设严重性或优先级。按 {workflow.output_format}(json、markdown 或 both)呈现,若设置了 {workflow.report_path} 则写入该路径,否则在对话中呈现。