用途:在 doc-bdd-audit 返回 FAIL 后,读取 .aidoc/audit/04_BDD-audit.md 审计报告,对 BDD 套件应用修复,使审计与修复循环收敛。不用于创建新 BDD(应使用 doc-bdd 或 doc-bdd-autopilot),也不应在没有审计报告时使用。
主要能力:按 Phase 0–7 修复——结构(目录/索引规则)、缺失文件、链接(相对路径重算)、元素 ID(按 BDD.{doc_id}.{section_id}.{hash} 重新推导,保留已有有效 ID)、内容(补齐模板日期与场景字段、内联 @threshold:)、引用(ears 列表、spec_trace、追溯矩阵)、上游元数据与漂移、风格(STY01 禁用短语、STY02/03 超长文本、FM01 frontmatter 不一致)。上游漂移按分级合并:<5% 自动合并,5–15% 自动合并并标记待审,>15% 归档并重新生成。
使用方式:编辑前先备份 BDD 到 tmp/backup/BDD-NN_<ts>/,出错时恢复。从 .aidoc/profile.yaml 解析 review_mode;team 模式下按 persona 槽位与 lens→agent 映射分派验证,回归则回滚并标记 manual_required;single_pass 模式直接应用补丁、不做 lens 验证。与 saga 日志交互,检查点超时(SOFT_DEADLINE 1500s)时以 PARTIAL_TIMEOUT 干净退出。输出 BDD-NN.F_fix_report_vNNN.md。
适用场景:BDD 质量改进层(Layer 4),由 doc-bdd-autopilot 调用或独立运行。
限制:不修改场景步骤文本与示例数据;缺失字段只标记不臆造;不删除上游已移除的场景(标记 @deprecated);需遵守 section_toggles,不重新引入已关闭的可选章节。具体阈值、评分门槛与迭代上限资料未提供。