用途
doc-itest-validator 用于校验 ITEST 文档，检查其是否满足子类型专属的 schema、结构、可追溯性、契约和交互要求。它属于 aidoc-flow-framework 的文档验证链路，针对 Layer 10 的集成测试规格（Integration Test Specifications，ITEST）进行 MVP schema 与结构契约校验。
主要能力
该工具围绕一组校验清单开展工作，涵盖以下检查项：
- 嵌套文件夹规则：ITEST-NN_{slug}/ITEST-NN_{slug}.md
- 六个必需章节是否存在且顺序正确
- ITEST 元素 ID 是否使用 TSPEC.NN.41.SS 格式
- 必需的累计标签是否存在（@brd..@spec，可选 @ctr）
- 必需的子类型标签是否存在（@ctr、@sys）
- 契约合规表与交互覆盖率是否存在
- 复杂交互是否具备时序图
- CTR 覆盖矩阵与 TASKS-Ready 声明是否存在
校验 schema 参考
校验依据以下文件：
- ai_dev_ssd_flow/10_TSPEC/ITEST/ITEST_MVP_SCHEMA.yaml
- ai_dev_ssd_flow/10_TSPEC/ITEST/ITEST-MVP-TEMPLATE.md
- ai_dev_ssd_flow/10_TSPEC/ITEST/ITEST_MVP_SCHEMA.yaml
使用方式
通过以下命令执行校验：
python ai_dev_ssd_flow/10_TSPEC/scripts/validate_itest.py docs/10_TSPEC/ITEST/
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/ITEST/ITEST-NN_slug/ITEST-NN_slug.md --auto-fix
python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact ITEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict
集成关系
- 被以下对象调用：doc-itest、doc-itest-autopilot、doc-itest-audit
- 输出流向：doc-itest-audit、doc-itest-fixer
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0 | 2026-02-27 | 初始 ITEST 校验器，包含 schema/结构/标签/契约检查及规范脚本引用 |
实现计划一致性（IPLAN-004）
- 将计划派生的输出视为有效的 source mode，并校验实现计划范围/目标的意图保持情况。
- 校验上游 autopilot 优先级假设：--iplan > --ref > --prompt。
- 将计划上下文与产物输出之间的目标/范围冲突标记为阻塞性问题，需澄清处理。
- 不引入诸如 docs-v2.0/00_REF 之类的旧版回退路径。