doc-ptest-validator

用途

doc-ptest-validator 用于校验性能测试规格文档（PTEST），针对子类型特定的 schema、结构、可追溯性与性能阈值要求进行检查。

主要能力

校验依据以下 schema 与模板文件：

• ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST_MVP_SCHEMA.yaml
• ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST-MVP-TEMPLATE.md
• ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST_MVP_SCHEMA.yaml

校验清单包括：

• 嵌套文件夹规则（PTEST-NN_{slug}/PTEST-NN_{slug}.md）
• 六个必需章节存在且顺序正确
• PTEST 元素 ID 使用 TSPEC.NN.44.SS 格式
• 存在必需的累积标签（@brd..@spec，可选 @ctr）
• 存在必需的子类型标签（@sys、@spec）
• 必需类别齐全（[Load]、[Stress]、[Endurance]、[Spike]）
• 存在负载场景表格与可度量阈值
• 存在 TASKS-Ready 评分声明且与阈值对齐

使用方式

提供的命令如下：

python ai_dev_ssd_flow/10_TSPEC/scripts/validate_ptest.py docs/10_TSPEC/PTEST/
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/PTEST/PTEST-NN_slug/PTEST-NN_slug.md --auto-fix
python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact PTEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict

集成关系

• 被调用方：doc-ptest、doc-ptest-autopilot、doc-ptest-audit
• 输出去向：doc-ptest-audit、doc-ptest-fixer

版本历史

版本	日期	变更
1.0	2026-02-27	初始 PTEST 校验器，包含 schema/结构/标签/性能检查及规范脚本引用

实现计划一致性（IPLAN-004）

• 将计划派生的输出视为有效来源模式，并验证实现计划范围/目标中的意图保持。
• 验证上游 autopilot 优先级假设：--iplan > --ref > --prompt。
• 将计划上下文与产物输出之间的目标/范围冲突标记为阻断性问题，需澄清处理。
• 不引入诸如 docs-v2.0/00_REF 之类的遗留回退路径。

限制

关于该工具的收费、价格、平台支持及具体使用效果等信息暂未提供。