用途:doc-cspec-reviewer 位于框架第 9.50 层(CSPEC 质量保障),对 CSPEC 文档做结构校验之外的内容深度分析,是生成 TSPEC/TASKS 之前的最终 QA 关口;上游为 doc-cspec-autopilot 产出的 CSPEC,下游无。
主要能力:按清单审查六类内容——接口定义(公共接口、方法签名、类型定义、API 契约与 CTR 一致)、CTR 合规(引用有效、接口实现与错误响应符合 CTR schema、数据模型对齐)、算法规范(核心算法、复杂度、边界情况、性能考量)、实现指导(类/模块结构、依赖注入、配置项、资源管理)、测试映射(单元/集成/边界/性能测试覆盖)、可追溯性(@brd 至 @ctr 累积标签、REQ 与实现映射、契约与测试引用)。输出 CSPEC-NN.A_audit_report_vNNN.md 审计报告与 CSPEC-NN.R_review_report_vNNN.md 旧格式报告,含 Summary(CODE-Ready 评分、PASS/FAIL)、Critical Issues、Warnings、Recommendations 及接口覆盖率、CTR 合规率、测试映射等指标表。
使用方式:在 doc-cspec-autopilot 完成后、手工编辑 CSPEC 后、运行 doc-tasks-autopilot 或 doc-tspec-autopilot 前,或对既有 CSPEC 做周期性检查时运行。发现问题后可接 doc-cspec-fixer 自动修复,再重跑审查验证。
限制:CSPEC 尚未存在时应先用 doc-cspec-autopilot;仅需结构校验应改用 doc-cspec-validator。参考模板与 schema 为 ai_dev_ssd_flow/09_SPEC/CSPEC/ 下的 CSPEC-MVP-TEMPLATE.yaml、CSPEC_MVP_SCHEMA.yaml;具体安装方式与命令资料未提供。