用途:创建或编辑 UTEST(单元测试规格)工件,作为 Layer 10 的 TSPEC 子类型(子类型代码 40,命名形如 TSPEC.NN.40.SS),用于组件级测试验证,核心是组件逻辑、状态、校验与边界用例检查,并以 @req 和 @spec 映射为主。
主要能力与结构:UTEST 遵循 6 段式契约——Document Control、Test Scope、Test Case Index、Test Case Details、REQ Coverage Matrix、Traceability。必需标签包括累积的 Layer-10 标签 @brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec(若存在 @ctr 也需包含),其中 @req、@spec 为 UTEST 专属必需标签。
质量门禁:TASKS-Ready 分数目标须不低于 90%,REQ 覆盖率目标须不低于 90%;测试类别须覆盖 [Logic]、[State]、[Validation]、[Edge];每个测试用例须包含 Input/Output 表;复杂测试逻辑须包含伪代码。
使用方式:先阅读规范参考文件(如 ai_dev_ssd_flow/10_TSPEC/UTEST/UTEST-MVP-TEMPLATE.md、UTEST-MVP-TEMPLATE.yaml、UTEST_MVP_SCHEMA.yaml)。目录采用嵌套结构:docs/10_TSPEC/UTEST/UTEST-NN_{slug}/UTEST-NN_{slug}.md。校验命令包括: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/;bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_tspec_quality_score.sh docs/10_TSPEC/;python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/10_TSPEC/UTEST/UTEST-NN_slug/UTEST-NN_slug.md --auto-fix;python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact UTEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict。
适用场景:仅创建或编辑 UTEST 工件、以 @req/@spec 映射为主、聚焦组件级逻辑/状态/校验/边界检查时使用。若需要多子类型编排(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST)或跨子类型规范化、批量 TSPEC 工作,应改用 doc-tspec。
限制:输出质量门禁要求无 schema/结构阻塞、所有必需 UTEST 段齐全、@req 与 @spec 映射明确、覆盖率与 TASKS-ready 分数达标、四类测试类别齐备、必要处含 Input/Output 表与伪代码指引、报告引用使用版本化命名。相关技能包括 doc-utest-autopilot、doc-utest-validator、doc-utest-reviewer、doc-utest-fixer、doc-utest-audit 及 doc-tspec。版本 1.0(2026-02-27)为初始 UTEST 编写技能。