用途:读取最新审计报告并对 SPEC 文档应用修复,衔接 doc-spec-audit 与通过审计的 SPEC,使审计↔修复循环收敛。属于第 6 层(SPEC 质量改进)。上游输入为 SPEC 文档与 .aidoc/audit/06_SPEC-audit.md,下游输出为修复后的 SPEC 与 SPEC-NN.F_fix_report_vNNN.md。
使用时机:在 doc-spec-audit 返回 FAIL 后使用,作为 Audit → Fix → Audit 循环的一部分。没有审计报告时不要使用(应先运行审计),也不要用它创建新 SPEC(应使用 doc-spec 或 doc-spec-autopilot)。
输入契约:消费 .aidoc/audit/06_SPEC-audit.md 报告;编辑前备份 SPEC 到 tmp/backup/SPEC-NN_<ts>/,出错时恢复。ID 标准来自 ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md,结构规则来自 ${CLAUDE_PLUGIN_ROOT}/framework/layers/06_SPEC/SPEC-TEMPLATE.yaml 与 README.md。
修复模式:从 .aidoc/profile.yaml 解析 review_mode,未设置则按 ADAPTATION.md 的优先级链回退到框架默认 team。team 模式下读取审计报告及 .aidoc/review/06_SPEC/<SPEC-id>/ 下的按角色槽位,优先使用结构化发现;槽位缺失时回退解析报告 Findings。按发现解析责任视角并派发对应 agent(architect/tech_lead/integration_lead 映射到 aidoc-flow:solutions-architect,chaos_engineer、security_engineer 各自映射)。多视角发现并行派发,任一视角回归则回滚补丁并标记 manual_required。P2/P3 为建议项,确定性应用,不做视角验证。single_pass 模式直接按阶段 0–8 单次应用,不做视角验证。
修复阶段:0 结构(嵌套文件夹规则、移动与重命名、修复相对链接);1 YAML(修复缩进、引号、重复键与类型);2 缺失文件(按模板创建索引/引用占位);3 链接(重算相对路径、绝对转相对);4 ID(文档级强制 SPEC-NN 短横线形式,上游元素引用改为 TYPE.NN.SS.xxxx,移除旧式 ID);5 内容(填充模板日期、硬编码数字改为 @threshold: 引用、标记 TODO/TBD);6 引用(补齐本层 required_tags 与下游 @tdd,修复上游路径,更新追溯矩阵);7 上游(修复 deliverable_type/document_type,按变更比例执行分级漂移合并,记录到 .drift_cache.json);8 风格(替换填充语、处理超长段落、核对 frontmatter 与 Document Control)。
置信度分类:auto-safe、auto-assisted、manual-required,并在报告中给出计数。内容保留规则:不删除已有接口定义、数据模型或行为逻辑;仅在缺失或结构不足处插入模板;就地规范化等价 YAML 键/标题;仅在同节内重编号。
报告格式:输出 SPEC-NN.F_fix_report_vNNN.md,含 Summary、Fixes Applied、Manual-Review Queue、Upstream Drift Summary、Validation After Fix、Cleanup Summary、Next Steps(重新运行 doc-spec-audit)。表格单元格内 shell 管道需转义为 | 以避免 MD056。
Saga 交互:被 autopilot 调用时读写 .aidoc/review/06_SPEC/<SPEC-id>/saga.json,在补丁验证期间将分支转为 BRANCH_COMPENSATING,验证通过转回 BRANCH_COMPLETED,回归则转 BRANCH_FAILED。入口写入起始时间戳;在派发下一个验证前检查是否超过 SOFT_DEADLINE(1500s),超时则置 PARTIAL_TIMEOUT 并保留已完成验证。独立调用且无 saga.json 时跳过 saga 转换。
限制:无审计报告时不应使用;不用于创建新 SPEC;领域内容无法推断时标记 manual-required;不得静默保留回归修复;不得重新引入项目已关闭的可选章节。