用途:自动化 UTEST 生命周期,针对特定子类型工作流完成生成、校验、审计,并在需要时转交修复器。
输入契约(IPLAN-004 标准):支持 --ref <path>、--prompt "<text>"、--iplan <path|IPLAN-NNN> 三种模式,优先级为 --iplan > --ref > --prompt。IPLAN 解析顺序:显式文件路径存在则使用;解析 work_plans/IPLAN-NNN*.md;解析 governance/plans/IPLAN-NNN*.md;多个匹配则报错请求消歧。主源与补充源在目标/范围上冲突属阻塞,需用户澄清。
执行模式:Generate/Find 模式下,UTEST-NN 为自类型时评审现有文档;REQ-NN 或 SPEC-NN 缺失则生成,否则评审现有 UTEST-NN;可选 CTR-NN 加入契约对齐检查。Audit/Fix 模式运行 doc-utest-audit,若失败或低于门禁则运行 doc-utest-fixer,重复审计直至通过或达到最大迭代。
编排流程:1) 解析目标 UTEST 文档;2) 生成或加载 UTEST;3) 运行 doc-utest-audit;4) 如需要运行 doc-utest-fixer;5) 重新审计;6) 输出状态与下一步建议。
命名与契约:审计输出为 UTEST-NN.A_audit_report_vNNN.md,兼容旧版评审输出为 UTEST-NN.R_review_report_vNNN.md,修复报告为 UTEST-NN.F_fix_report_vNNN.md,均存于父 UTEST 旁的嵌套文件夹。生成实例必须从模板读取 instance_document_type,并在 frontmatter 中设置 document_type: utest-document(而非 template)、artifact_type: UTEST、layer: 10、test_type_code: 40;模板为 template,实例为 utest-document,schema 校验两者。若模板缺少 instance_document_type,默认 utest-document。
质量门禁:TASKS-Ready 分数 >=90%,REQ 覆盖 >=90%;必需类别为 [Logic]、[State]、[Validation]、[Edge];每个测试用例需 Input/Output 表;复杂逻辑需伪代码。通过条件:UTEST 结构匹配 6 节契约、必需标签完整、覆盖率与分数达标、I/O 表与伪代码要求满足、审计在 UTEST 门禁下为 PASS。
与 doc-tspec-autopilot 共存:仅 UTEST 范围时使用本技能;跨子类型编排时路由至 doc-tspec-autopilot;若子类型阻塞未解决,升级至 doc-tspec-autopilot,并保持报告兼容(优先 .A_,旧版 .R_)。
示例调用:/doc-utest-autopilot UTEST-01、/doc-utest-autopilot REQ-01、/doc-utest-autopilot SPEC-01、/doc-utest-autopilot CTR-01。相关技能:doc-utest、doc-utest-validator、doc-utest-reviewer、doc-utest-fixer、doc-utest-audit。安装命令与价格暂未提供。