SuperAPI AI 工具集

doc-utest-validator

测试与质量

查看项目

更新于 10-16 05:53

技能介绍

用途:校验 UTEST(Unit Test Specifications)文档是否符合 Layer 10 UTEST MVP 的 schema 与结构契约,并检查可追溯性与单元测试门禁要求。

主要能力:校验嵌套文件夹规则(UTEST-NN_{slug}/UTEST-NN_{slug}.md);检查六个必需章节是否齐全且顺序正确;检查 UTEST 元素 ID 是否使用 TSPEC.NN.40.SS;检查必需累积标签是否包含 @brd 至 @spec(可选 @ctr)及子类型标签 @req、@spec;检查 TASKS-Ready 评分标记(目标 >=90%)与 REQ 覆盖标记(Coverage >=90%);检查测试类别是否包含 [Logic]、[State]、[Validation]、[Edge];检查测试用例是否满足 Input/Output 表要求;检查复杂测试逻辑是否有伪代码指引。schema 参考文件包括 ai_dev_ssd_flow/10_TSPEC/UTEST/UTEST_MVP_SCHEMA.yaml 与 UTEST-MVP-TEMPLATE.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

集成关系:被 doc-utest、doc-utest-autopilot、doc-utest-audit 调用;向 doc-utest-audit、doc-utest-fixer 提供结果。版本 1.0(2026-02-27)初始版本。IPLAN-004 一致性要求:把计划派生输出视为有效源模式,验证实现计划范围/目标的意图保持;校验上游 autopilot 优先级假设 --iplan > --ref > --prompt;将计划上下文与产出物之间的目标/范围冲突标记为需澄清的阻塞问题;不引入 docs-v2.0/00_REF 之类旧式回退路径。限制:资料未提供独立安装方式、收费模式与支持平台信息。