用途
doc-ftest-validator 用于校验 FTEST（Functional Test Specifications，功能测试规格）文档，检查其子类型专属的 schema、结构、可追溯性以及阈值质量约束。
校验依据
校验参考以下 schema 与模板文件：
- ai_dev_ssd_flow/10_TSPEC/FTEST/FTEST_MVP_SCHEMA.yaml
- ai_dev_ssd_flow/10_TSPEC/FTEST/FTEST-MVP-TEMPLATE.md
- ai_dev_ssd_flow/10_TSPEC/FTEST/FTEST_MVP_SCHEMA.yaml
主要能力（校验清单）
- 嵌套目录规则（FTEST-NN_{slug}/FTEST-NN_{slug}.md）
- 六个必需章节存在且顺序正确
- FTEST 元素 ID 使用 TSPEC.NN.43.SS
- 存在必需的累积标签（@brd..@spec，可选 @ctr）
- 存在必需的子类型标签（@sys、@threshold）
- 存在 SYS 覆盖矩阵与阈值引用
- 存在 TASKS-Ready 分数声明并与阈值对齐
使用方式
通过以下命令执行校验：
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
集成关系
- 被调用方：doc-ftest、doc-ftest-autopilot、doc-ftest-audit
- 输出给：doc-ftest-audit、doc-ftest-fixer
实施计划一致性（IPLAN-004）
- 将计划派生产出视为有效的 source mode，并验证实施计划范围/目标的意图保持。
- 验证上游 autopilot 优先级假设：--iplan > --ref > --prompt。
- 将计划上下文与产出物之间的目标/范围冲突标记为阻塞性问题，需要澄清。
- 不引入如 docs-v2.0/00_REF 的旧版回退路径。
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0 | 2026-02-27 | 初始 FTEST 校验器，含 schema/结构/标签/阈值检查及规范脚本引用 |
限制
官方文本暂未提供，其他细节暂未提供。