用途:校验测试规格(TSPEC)文档是否符合 Layer 10 模式标准,可在用户请求校验、创建或修改 TSPEC 产物后、生成下游 TASKS 之前,以及质量门检查中调用。
主要能力:校验 YAML frontmatter 元数据合规性、章节结构(6 个必需章节)、Document Control 完整性、8 个累积标签(@brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec)、TASKS-Ready 评分、文件命名规范、元素 ID 格式(TSPEC.NN.xxxx,类型码 40-45)、测试类型(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST)、覆盖矩阵与 I/O 表等。文件夹结构校验为阻塞项,TSPEC 必须位于嵌套目录 docs/10_TSPEC/{TYPE}/{TYPE}-NN_{slug}/ 下。
使用方式:按类型运行校验脚本,例如 python ai_dev_ssd_flow/10_TSPEC/scripts/validate_utest.py docs/10_TSPEC/UTEST/;也可用 bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_all_tspec.sh docs/10_TSPEC/ 校验全部类型,或用 validate_tspec_quality_score.sh 做质量评分校验。跨文档校验使用 python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/10_TSPEC/UTEST/UTEST-01.md --auto-fix;累积标签校验使用 python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact UTEST-01 --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict。
适用场景:TSPEC 文档质量门检查、测试覆盖矩阵校验、生成 TASKS 前的就绪度评估,以及由 doc-flow、doc-tspec、quality-advisor 等技能调用。
限制:资料未提供该技能的收费、价格、平台支持与具体运行环境要求;校验规则与错误码以资料所列清单为准,未列出的功能暂未提供。