bmad-review 是一个审查技能,用于通过“透镜”(lens)审阅内容。每个透镜是一种独立的方法与立场,最终以统一形态报告发现。它强调只报告真实问题,不为显得详尽而注水:多数透镜允许空结果;对抗性透镜要求至少十条具体发现,把空列表视为需要复查的信号;编辑类透镜视内容为神圣,只批评组织与表达方式。
用途与输入:可审查 diff、分支、未提交改动、文件、规格、故事或任意文档,参数形式为 [path]。可选 lenses 指定一个或多个透镜代码或名称,默认运行全部适用透镜;also_consider 用于补充关注点;claims 为该改动自身的叙述,只交给边界情况透镜;pre-resolved customization 由转发调用方提供。
用法:先运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析定制,失败则直接读取 customize.toml。内容会被暂存为临时文件后再分析。运行前用一行说明要审查的内容类别与将运行的透镜。独立透镜并行运行,依赖透镜在其目标透镜完成后运行。各透镜将发现以 text 形式返回,不通过任何报告工具。
输出与限制:输出为一个 JSON 数组,每条发现含 lens、location、trigger_condition、guard_snippet、potential_consequence,透镜可增加自有字段。无 severity、priority 或排名。[] 为有效空结果。按 output_format 以 json、markdown 或 both 呈现。设为 report_path 时写入文件,否则在对话中呈现。透镜集合由 {workflow.lenses} 决定而非固定列表。具体平台、收费与效果资料暂未提供。