用途:doc-cspec-audit 是 CSPEC 文档的统一质量门禁(Layer 9.50),把结构校验、内容审查与 CODE-Ready 评分合并为一次综合审计,输出可由 doc-cspec-fixer 消费的标准化报告。适用场景包括发布前最终质量门禁、需要结构与内容双重审查、需要官方 CODE-Ready 评分,以及 CI/CD 流水线中的自动质量检查。
主要能力:四类审计组件按权重计算。结构校验占 30%,涵盖文件位置合规、YAML 语法有效、必需章节存在、元数据完整;内容质量占 40%,涵盖接口定义完整、CTR 合规、算法规格存在、实现指引充分;追溯性占 15%,涵盖累积标签完整、REQ 映射有效、CTR 引用有效、测试映射完整;就绪度指标占 15%,含 CODE-Ready 评分、下游就绪评估与风险识别。
CODE-Ready 评分构成:接口完整性 20%、CTR 合规 20%、算法规格 15%、错误处理 15%、测试映射 15%、追溯性 15%。阈值为 PASS ≥90%、CONDITIONAL 80-89%、FAIL <80%。
使用方式:输出文件为 CSPEC-NN.A_audit_report_vNNN.md。CI/CD 中可参考给定步骤:先运行 invoke doc-cspec-audit --cspec docs/09_SPEC/CSPEC/CSPEC-NN/,再检查 CODE-Ready >= 90%,必要时运行 invoke doc-cspec-fixer --report CSPEC-NN.A_audit_report.md,形成审计→修复→复审循环。报告包含执行摘要、结构校验与内容质量表格、追溯性标签表、问题分级(必须修复、建议修复、可选建议)、指标汇总与后续步骤。
限制:其余模板、Schema、校验规则与创建规则路径见参考资料;具体命令参数、平台与收费信息暂未提供。