SuperAPI AI 工具集

doc-tspec-fixer

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:doc-tspec-fixer 是 TSPEC 质量改进层(Layer 10)的自动修复技能,读取最新审查报告并向 TSPEC 文档应用修复,衔接 doc-tspec-reviewer(发现问题)与修正后的 TSPEC,支持 Review→Fix→Review 循环。上游输入为 SPEC 文档、TSPEC 文档与审查/审计报告(优先 TSPEC-NN.A_audit_report_vNNN.md,兼容旧版 TSPEC-NN.R_review_report_vNNN.md);下游产出修复后的 TSPEC 与修复报告(TSPEC-NN.F_fix_report_vNNN.md)。适用场景:审查后修复、迭代改进、CI/CD 质量门禁、批量修复、测试用例结构问题。不适用:无审查报告、创建新 TSPEC、仅需校验。

报告选择按时间戳/版本取最新,并列时优先 .A 审计报告。依赖 doc-tspec-audit、doc-tspec-reviewer、doc-naming、doc-tspec、doc-spec。

修复分阶段:Phase 0 修复结构违规(TSPEC 必须置于嵌套文件夹,如 docs/10_TSPEC/UTEST/UTEST-NN_{slug}/UTEST-NN_{slug}.md,含移动文件、重命名文件夹、修正相对链接);Phase 1 创建缺失文件(测试数据、fixtures、矩阵、引用文档占位模板);Phase 2 修复损坏链接(更新路径、外部链接加警告、绝对路径转相对);Phase 3 修复元素 ID(旧式 TC-/TS-/TD-/TF- 转为 TSPEC.NN.40-43.SS);Phase 4 修复内容问题(替换模板日期/名称,补齐测试步骤、预期结果、前置条件占位,[TODO]/[TBD] 仅标记需人工完成);Phase 5 更新引用(补充 @spec:/@req: 追溯标签与追溯矩阵);Phase 6 处理上游漂移(哈希校验 FIX-H001~H003,按变更百分比分级:<5% 自动合并补丁版、5-15% 带变更日志合并次版本、>15% 归档并触发重新生成需强制评审)。测试 ID 格式为 {TYPE}-NN-TC-SS,如 UTEST-01-TC-01,NN 取 01-99。

限制:无法自动修复无效文件名、[TODO]/[TBD] 与大于 25KB 需分节的文档仅标记人工处理;外部链接不可达仅保留加警告;上游文件缺失时仅置 drift_detected 并转人工。官方文档未提供安装命令、发布时间与许可信息,暂未提供。