SuperAPI AI 工具集

doc-ptest

测试与质量

查看项目

更新于 10-16 05:53

技能介绍

用途:doc-ptest 是 vladm3105/aidoc-flow-framework 中的一项创作技能,用于为系统性能验证创建性能测试规范(PTEST),属于 Layer 10 的 TSPEC 子类型,覆盖 [Load]、[Stress]、[Endurance]、[Spike] 四类测试。当只需创建或编辑 PTEST 工件、以 @sys 和 @spec 约束为主、且核心目标是性能阈值与负载画像行为时使用;若需要多子类型编排(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST)或跨子类型规范化与批量 TSPEC 工作,则应改用 doc-tspec。

主要能力:PTEST 遵循 6 段式契约:文档控制、测试范围、测试用例索引、测试用例详情、SYS 覆盖矩阵、可追溯性。必需标签为累积 Layer-10 标签 @brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec(如存在则加 @ctr),其中类型特定必需标签为 @sys、@spec。要求覆盖四类必需类别,TASKS 就绪阈值为 >=90%,SYS 覆盖目标与模板对齐(基线 >=85%)。

使用方式:使用嵌套文件夹结构 docs/10_TSPEC/PTEST/PTEST-NN_{slug}/PTEST-NN_{slug}.md。所有测试用例使用 Load Scenario 表格,复杂场景包含 execution_profile。编写前阅读规范参考:ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST-MVP-TEMPLATE.md、PTEST-MVP-TEMPLATE.yaml、PTEST_MVP_SCHEMA.yaml。验证命令保持原样: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。

限制:输出需通过质量门禁,不得存在 schema/结构阻塞、必需段落缺失、@sys 与 @spec 映射不明确、缺少负载场景与可度量阈值、可追溯性缺少累积标签等问题。资料未提供具体价格、安装方式与更多平台信息。