用途:doc-sys-fixer 是 aidoc-flow-framework 第 6 层(SYS 质量改进)的自动化修复技能,读取最新审计/评审报告,对 SYS(系统设计规格)文档应用修复,衔接 doc-sys-reviewer/doc-sys-audit 与修正后的 SYS,形成“评审→修复→评审”的迭代循环。上游输入为 SYS 文档、审计/评审报告(优先 SYS-NN.A_audit_report_vNNN.md,兼容 SYS-NN.R_review_report_vNNN.md)及 ADR;下游输出为修复后的 SYS 与修复报告 SYS-NN.F_fix_report_vNNN.md。
主要能力:按阶段执行修复。Phase 0 修复结构违规(SYS 必须位于嵌套文件夹,如 docs/06_SYS/SYS-NN_{slug}/SYS-NN_{slug}.md,并更新相对链接);Phase 1 创建缺失文件(SYS-00_INDEX.md、COMP_、INT_、REF 等占位模板);Phase 2 修复断链(内部链接、绝对路径转相对、补充 ADR 追溯链接);Phase 3 修复元素 ID(将 SYS.NN.06.SS 等无效类型码转换为有效码,如 01/05/17/18/19/20/21,并转换 COMP-/INT-/MOD-/DEP-/FLOW- 旧式模式);Phase 4 修复内容问题(替换模板日期、默认状态 Draft、版本 0.1,TODO/TBD 仅标记需人工完成);Phase 5 更新引用与追溯矩阵;Phase 6 处理上游漂移,按变更百分比分级自动合并(<5% 补丁、5-15% 次版本并生成变更日志、>15% 归档并触发重新生成),并修复哈希占位符、缺失 sha256: 前缀等问题。
使用方式:在 doc-sys-reviewer 识别问题后运行,可作为 CI/CD 质量门禁的一部分,或批量修复多个 SYS 文档。需先存在审计/评审报告,否则应先运行 doc-sys-audit 或 doc-sys-reviewer。依赖 doc-sys-audit、doc-sys-reviewer、doc-naming、doc-sys、doc-adr 等技能。
适用场景:评审后的迭代改进、自动化流水线质量门禁、批量修复。限制:无审计/评审报告时不可用;创建新 SYS 应使用 doc-sys 或 doc-sys-autopilot;仅需校验应使用 doc-sys-validator;TODO/TBD 等占位内容无法自动补全,只能标记人工处理;具体安装命令与运行命令资料未提供。