doc-cspec-validator

用途：按 Layer 9.50 schema 标准校验 Code Specifications（CSPEC）文档，通常在用户要求验证 CSPEC 文档时，或创建/修改 CSPEC 产物后触发。\n\n主要能力：校验目录结构（阻塞项）、元数据字段（document_type=cspec-document、artifact_type=CSPEC、deliverable_type=code、subtype_code=50、layer=9）、CTR 合规（强制）、接口定义完整性、实现细节、测试映射、可追溯性标签（@brd、@prd、@ears、@bdd、@adr、@sys、@req、@ctr）。CODE-Ready 评分权重：Interface Completeness 20%（最低100%）、CTR Compliance 20%（最低100%）、Algorithm Specification 15%（最低90%）、Error Handling 15%（最低90%）、Test Mapping 15%（最低90%）、Traceability 15%（最低100%），目标 CODE-Ready ≥90%。\n\n使用方式：YAML 类型须位于 docs/09_SPEC/CSPEC/CSPEC-NN_{slug}/CSPEC-NN_{slug}.yaml。单个校验：python ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py --spec-file docs/09_SPEC/CSPEC/CSPEC-NN_{slug}/CSPEC-NN_{slug}.yaml --subtype CSPEC；全部校验：python ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py --directory docs/09_SPEC/CSPEC --subtype CSPEC。\n\n错误码：CSPEC-E001 缺少 CTR 引用（Error）；CSPEC-E002 接口定义不完整（Error）；CSPEC-E003 缺少算法规范（Error）；CSPEC-W001 测试映射不完整（Warning）；CSPEC-W002 CODE-Ready 分数低于阈值（Warning）。\n\n适用场景：CSPEC 类代码规格文档在提交或修改后的质量校验，以及需要确认 CTR 契约、接口、测试映射和可追溯性是否达标的流程。\n\n限制：资料未提供平台支持范围、依赖环境、收费或价格信息。