用途:doc-ftest 用于创建或编辑仅含 FTEST 的工件,核心目标是质量属性阈值验证,@sys 与 @threshold 约束为主要内容。当需要多子类型编排(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST)或跨子类型批量 TSPEC 工作时,应改用 doc-tspec。
主要能力:按 FTEST 契约组织文档,包含 6 个必需段落:Document Control、Test Scope、Test Case Index、Test Case Details、SYS Coverage Matrix、Traceability。必需标签为累计第 10 层标签 @brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec(如存在 @ctr 也加入),类型专属必需标签为 @sys、@threshold。TASKS 就绪阈值为 >=90%,SYS 覆盖目标模板对齐(基线 >=85%)。作者此前需阅读规范参考模板与 schema(FTEST-MVP-TEMPLATE.md/.yaml、FTEST_MVP_SCHEMA.yaml)。
使用方式:目录采用嵌套结构 docs/10_TSPEC/FTEST/FTEST-NN_{slug}/FTEST-NN_{slug}.md。校验命令包括:python ai_dev_ssd_flow/10_TSPEC/scripts/validate_ftest.py docs/10_TSPEC/FTEST/;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/FTEST/FTEST-NN_slug/FTEST-NN_slug.md --auto-fix;python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact FTEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict。
输出质量门:无 schema/结构阻塞,全部必需段落齐备,可度量的标准显式映射 @threshold,追溯包含必需累计标签,报告引用在适用时使用带版本命名。
适用场景与限制:适用于系统级质量属性阈值验证类测试规范编写;不适用于多子类型编排。相关技能包括 doc-ftest-autopilot、doc-ftest-validator、doc-ftest-reviewer、doc-ftest-fixer、doc-ftest-audit 以及回退路径 doc-tspec。版本 1.0(2026-02-27)。除以上资料外,具体安装方式、收费与平台信息暂未提供。