用途:doc-cspec-fixer 是 aidoc-flow-framework 中的自动化修复技能,位于第 9.50 层(CSPEC 质量改进)。它读取最新审查报告,对 CSPEC(Code Specification)文档应用修复,衔接 doc-cspec-reviewer(发现问题)与修正后的 CSPEC,支持迭代改进循环。
上游输入:REQ、CTR、CSPEC、审查报告(CSPEC-NN.A_audit_report_vNNN.md)。下游输出:修复后的 CSPEC、修复报告(CSPEC-NN.F_fix_report_vNNN.md)。
适用时机:在 doc-cspec-reviewer 识别问题后运行;属于 Review → Fix → Review 循环;修复 CTR 合规问题;CSPEC 含格式错误的 YAML 块时。不适用:无审查报告(需先运行 doc-cspec-reviewer);问题需人工架构决策;CTR 契约本身需修改。
可修复问题类型:自动修复包括缺失 document_type(添加 document_type: cspec-document)、缺失 subtype_code(添加 subtype_code: 50)、断开的内部链接(更新为正确路径)、缺失可追溯标签(添加必需累积标签)、YAML 语法错误(修复格式)、不完整元数据(添加必需字段)。半自动修复(需确认)包括缺失接口定义(从 CTR 生成骨架)、不完整测试映射(生成测试用例占位符)、缺失算法细节(添加 TODO 标记)。需人工审查:架构变更、CTR 契约不匹配、业务逻辑错误。
执行流程:读取审查报告 → 判断是否有问题 → 分类问题 → 应用自动修复 → 生成修复报告 → 重新验证 → 判断是否全部修复 → 完成或标记人工问题。
修复报告格式包含摘要(文档、修复日期、来源报告、已修复数、剩余数)、已应用修复(类型、位置、修改前、修改后)、剩余问题(原因、建议)、验证(修复后 CODE-Ready 分数、状态)。输出文件为更新后的 CSPEC YAML 与 CSPEC-NN.F_fix_report_vNNN.md。
集成:doc-cspec-reviewer → CSPEC-NN.A_audit_report.md → doc-cspec-fixer → 修复后的 CSPEC;迭代循环最多 3 次以防死循环。参考模板与 schema 位于 ai_dev_ssd_flow/09_SPEC/CSPEC/ 下。具体安装命令与收费信息暂未提供。