用途:当用户请求校验 SPEC 文档,或创建、修改 SPEC 工件后触发,依据 Layer 9 模式(ai_dev_ssd_flow/09_SPEC/SPEC_MVP_SCHEMA.yaml)校验技术规格文档。
主要能力:一是目录结构校验(阻塞项),SPEC 必须置于嵌套目录 docs/09_SPEC/SPEC-NN_{slug}/,文件名须与目录同名且为 .yaml,对应错误码 SPEC-E020、SPEC-E021、SPEC-E022;二是文件格式与字段校验,检查 .yaml 扩展名、UTF-8、YAML 1.2,以及 id、summary、metadata、traceability、architecture、interfaces、behavior、performance、security、observability、verification、implementation 等必填顶层字段;三是分节校验,包括 metadata 的版本、状态、日期、作者,interfaces 的类与方法,performance 的延迟(p50<p95<p99)与吞吐、资源限制,security 的认证与授权,observability 的指标、日志与健康检查,traceability 的 7 个累积标签(@brd、@prd、@ears、@bdd、@adr、@sys、@req,@ctr 可选)。
使用方式:运行校验脚本,例如 python3 ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py docs/09_SPEC/SPEC-001_example/SPEC-001_example.yaml;批量校验可用 find docs/09_SPEC -name "SPEC-*.yaml" -exec python3 ai_dev_ssd_flow/09_SPEC/scripts/validate_spec.py {} ;;verbose 输出使用 validate_spec_implementation_readiness.py 加 --verbose。
适用场景:SPEC 文档的创建后校验、质量门禁,由 doc-flow、doc-spec 调用,输出供 trace-check 跨文档校验使用,并报告给 quality-advisor。
限制:校验按错误、警告、信息三级输出 SPEC-E0xx、SPEC-W0xx、SPEC-I0xx 码;目录结构校验为阻塞项,未通过前不进行其他检查。收费、平台等信息暂未提供。