用途
根据资料,doc-stest 用于创建 Smoke Test Specifications(STEST)工件,作为 Layer 10 的 TSPEC 子类型,目标是部署关键路径验证,采用严格的 fail-fast 通过/失败结果。
适用场景
创建或编辑仅 STEST 的工件时使用;当 @ears、@bdd、@req 约束为主,且核心目标是部署冒烟验证与关键路径回滚就绪时使用。若需要多子类型编排(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST)或跨子类型规范化、批量 TSPEC 工作,则改用 doc-tspec。
主要能力与结构
STEST 遵循 6 段合同:Document Control、Test Scope、Critical Path Index、Test Case Details、Rollback Procedures、Traceability。必需标签包含累积 Layer-10 标签 @brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec(以及存在时的 @ctr);类型专属必需标签为 @ears、@bdd、@req。
部署门禁要求
总超时预算必须 <=300s(最大 300s / 少于 5 分钟);质量门目标为 100%;每个测试必须有回滚程序;通过/失败标准必须二元且 fail-fast。文件夹规则为嵌套结构 docs/10_TSPEC/STEST/STEST-NN_{slug}/STEST-NN_{slug}.md。
必要用法
资料给出的验证命令包括:python ai_dev_ssd_flow/10_TSPEC/scripts/validate_stest.py docs/10_TSPEC/STEST/;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/STEST/STEST-NN_slug/STEST-NN_slug.md --auto-fix;python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact STEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict。
输出质量门与限制
不得有 schema/结构阻塞;所有必需 STEST 段必须存在;@ears、@bdd、@req 映射需显式;超时与回滚约束需存在;关键路径二元通过/失败标准需明确;报告引用在适用时使用版本化命名。资料未提供具体收费、价格、平台或效果信息。