用途
doc-utest-audit 是一个统一的 UTEST 审计包装器,用来运行单一的 UTEST 审计工作流:先执行 doc-utest-validator,再执行 doc-utest-reviewer,最后输出一份合并的、可直接供修复流程使用的报告。
主要能力
它按顺序编排校验器与评审器两个环节,并产出一份合并报告。主要输出文件为 UTEST-NN.A_audit_report_vNNN.md。为兼容修复流程,doc-utest-fixer 接受 .A_(首选)与 .R_(旧版兼容)两种格式。
合并状态规则
报告给出 PASS 或 FAIL 结论:
- PASS:校验器 PASS,且评审器得分不低于 90,且不存在阻塞或需人工处理的问题。
- FAIL:校验器 FAIL,或评审器得分低于 90,或存在阻塞/需人工处理的问题。
单元测试门禁策略
以下情况属于需人工处理或阻塞,不能自动通过:缺少分类覆盖、缺少输入/输出表、需求(REQ)覆盖率低于 90%、复杂逻辑缺少伪代码。
合并报告包含的章节
摘要、得分计算、校验器发现、评审器发现、覆盖发现、单元测试门禁发现、修复队列(自动可修复、需人工、阻塞)、建议的下一步。
交接规则
如果需要修复,则使用最新报告运行 doc-utest-fixer。若出现时间戳或版本并列,优先选择 .A_ 而非 .R_。
使用方式示例
/doc-utest-audit docs/10_TSPEC/UTEST/UTEST-01_scope/UTEST-01_scope.md
实现计划一致性(IPLAN-004)
将计划派生输出视为有效来源模式,并验证从实现计划范围/目标到产物的意图保持。校验上游自动接管优先级假设:--iplan > --ref > --prompt。将计划上下文与产物输出之间的目标/范围冲突标记为需要澄清的阻塞问题。不引入类似 docs-v2.0/00_REF 的遗留回退路径。
版本历史
1.0 版,日期 2026-02-27,初始 UTEST 审计包装器,包含校验器->评审器编排以及 90% 门禁的单元测试通过契约。
适用场景与限制
适用于需要在单次流程中完成 UTEST 校验与评审、并生成修复就绪合并报告的场景。资料未提供关于收费、价格、支持平台或具体效果的信息,这些内容暂未提供。