用途:面向部署冒烟验证的 STEST 文档自动化生命周期编排,覆盖从上游上下文生成 STEST、验证审计输出,以及在需要时交给修复器处理。
输入契约:支持 --ref <path>、--prompt "<text>"、--iplan <path|IPLAN-NNN> 三种模式,优先级为 --iplan > --ref > --prompt。IPLAN 解析依次尝试显式文件路径、work_plans/IPLAN-NNN*.md、governance/plans/IPLAN-NNN*.md;多匹配时报错要求消歧。主源与补充源在目标/范围上冲突属阻塞,需要用户澄清。
执行模式:生成/查找模式中,输入 STEST-NN 时审阅现有文档;输入 EARS-NN、BDD-NN 或 REQ-NN 时,缺少则生成,否则审阅现有 STEST-NN;可选 SPEC-NN 用于加入部署目标一致性检查。审计/修复模式先运行 doc-stest-audit,若不通过或低于门禁则运行 doc-stest-fixer,再重复审计直到通过或达到最大迭代次数。
编排流程为:解析目标 STEST 文档、生成或加载 STEST、运行 doc-stest-audit、按需运行 doc-stest-fixer、重新审计、输出状态与下一步建议。
命名与契约:主审计输出为 STEST-NN.A_audit_report_vNNN.md,兼容的审阅输出为 STEST-NN.R_review_report_vNNN.md,修复报告为 STEST-NN.F_fix_report_vNNN.md,报告存放在父 STEST 同级的嵌套目录中。生成实例时须将 document_type 设为 stest-document(模板为 template),字段来源为 ai_dev_ssd_flow/10_TSPEC/STEST/STEST-MVP-TEMPLATE.yaml 的 metadata.instance_document_type;缺失时默认 stest-document。
部署门禁约束:总超时预算不超过 300 秒;目标为 100% 质量门禁;每个测试必须有回滚流程;关键路径检查须使用二元通过/失败标准。仅限 STEST 范围时使用本技能,跨子类型编排时改用 doc-tspec-autopilot;无法解决子类型阻塞时升级至 doc-tspec-autopilot,同时保持报告兼容性(优先 .A_,兼容 .R_)。
触发示例:/doc-stest-autopilot STEST-01、EARS-01、BDD-01、REQ-01、SPEC-01。质量门禁通过条件:STEST 结构符合 6 节契约、必需标签完整、包含超时/回滚/100% 门禁约束、明确二元通过失败标准,且严格门禁下审计状态为 PASS。相关技能包括 doc-stest、doc-stest-validator、doc-stest-reviewer、doc-stest-fixer、doc-stest-audit 及作为混合子类型回退的 doc-tspec-autopilot。限制方面,资料未提供具体命令实现、底层依赖版本或运行环境要求。