SuperAPI AI 工具集

doc-tspec

测试与质量

查看项目

更新于 10-16 03:38

技能介绍

用途:doc-tspec 用于在 SDD 工作流的第 10 层创建测试规格(TSPEC),在 SPEC(第 9 层)与 TASKS(第 11 层)之间定义测试用例,服务于测试驱动开发(TDD)。上游为 BRD、PRD、EARS、BDD、ADR、SYS、REQ、CTR、SPEC,下游为 TASKS 与代码。

主要能力:支持多种测试类型,包括单元测试 UTEST(代码 40)、集成测试 ITEST(41)、冒烟测试 STEST(42)、功能测试 FTEST(43),以及性能测试 PTEST(44)、安全测试 SECTEST(45)。每类测试有对应模板与校验脚本,如 validate_utest.py、validate_itest.py、validate_stest.py、validate_ftest.py,并提供综合质量评分脚本 validate_tspec_quality_score.sh。

使用方式:先确认上游产物存在,读取 SPEC 与 REQ 作为主要来源;在 docs/10_TSPEC/{TYPE}/ 下按 {TYPE}-NN_{slug}.md 命名创建文件;填写文档控制、测试范围、测试用例索引、测试用例详情、覆盖矩阵与追溯标签。元素 ID 采用 TSPEC.NN.xxxx 三段式,禁止使用 TC-XXX、UT-XXX 等旧格式。第 10 层需包含 8 至 9 个累积追溯标签(@brd 至 @spec,含 @ctr 时 9 个)。创建后运行校验命令,例如 python ai_dev_ssd_flow/10_TSPEC/scripts/validate_utest.py docs/10_TSPEC/UTEST/UTEST-01_*.md,并更新 TSPEC-00_TRACEABILITY_MATRIX.md。

适用场景:已完成 BRD 至 SPEC 各层、准备在实现前定义测试用例、需要编写单元/集成/冒烟/功能测试规格时使用。

限制:保留 ID 为 000 的文档(如索引、模板、术语表)完全豁免校验;图表必须使用 Mermaid 语法,禁止文本图;验收测试保留在 BDD 第 4 层,不在 TSPEC 中重复。资料未提供具体收费、价格与平台信息。