SuperAPI AI 工具集

doc-ctr-fixer

编程与开发

查看项目

更新于 10-16 03:38

技能介绍

用途:doc-ctr-fixer 是 aidoc-flow-framework 中的自动化修复技能,位于第 8 层(CTR 质量改进)。它读取最新评审报告(CTR-NN-SSS.R_review_report_vNNN.md),对 CTR 合同文档应用修复,衔接 doc-ctr-reviewer(发现问题)与修正后的 CTR,支持“评审→修复→评审”迭代循环,可用于 CI/CD 质量门禁与批量修复。

主要能力:按阶段修复。阶段 0 修复结构违规(CTR 必须位于嵌套文件夹,如 docs/08_CTR/CTR-NN_{slug}/,含 .md 与 .yaml,并更新相对链接);阶段 1 创建缺失文件(YAML/MD 合同模板、schema、参考文档占位);阶段 2 修复断链(内部链接、外部链接、绝对路径转相对、YAML $ref、JSON Schema $ref);阶段 3 修复元素 ID(将 API-XXX、INT-XXX、MODEL-XXX、SCHEMA-XXX、CLAUSE-XXX 等旧格式映射为 CTR.NN.16/17/20.SS);阶段 4 修复内容问题(替换模板日期、空章节补最小内容、YAML 语法修复);阶段 5 更新引用与 REQ 可追溯性;阶段 6 处理上游漂移,按变更百分比分级自动合并(<5% 补丁版本、5-15% 次版本并生成变更日志、>15% 归档并触发重新生成),并维护 .drift_cache.json 审计记录。合同永不删除,废弃时加 [DEPRECATED] 标记与后继链接。

使用方式:在 doc-ctr-reviewer 生成评审报告后运行;输入为 CTR 路径,先查找并解析最新评审报告,再按阶段修复、写出修正后的 MD+YAML、生成修复报告(CTR-NN-SSS.F_fix_report_vNNN.md),可选重新运行评审直至评分达标。

适用场景:评审后修复、迭代改进、自动化流水线、批量修复、MD 与 YAML 双文件不同步。

限制:无评审报告时不可用(需先运行 doc-ctr-reviewer);不用于创建新 CTR(用 doc-ctr 或 doc-ctr-autopilot);仅需校验时用 doc-ctr-validator;[TODO]/[TBD] 占位符无法自动修复,仅标记人工完成;上游文件缺失时只能部分修复。具体安装命令与调用参数暂未提供。