用途:doc-tspec-audit 属于第 10 层 TSPEC 质量门封装,用于以单一命令完成 TSPEC 质量检查,避免用户在 validator 与 reviewer 之间混淆,同时保留职责分离:doc-tspec-validator 负责结构与模板合规,doc-tspec-reviewer 负责内容质量与实现就绪度,doc-tspec-audit 作为唯一面向用户的审计入口,并输出可直接喂给 doc-tspec-fixer 的综合报告。
主要能力与执行序列(强制顺序):1) 运行 doc-tspec-validator;2) 运行 doc-tspec-reviewer;3) 规范化并合并发现项;4) 写出 TSPEC-NN.A_audit_report_vNNN.md;5) 若存在可自动修复的发现项,则交接给 doc-tspec-fixer。
输入与阈值:输入为 TSPEC 路径(docs/10_TSPEC/{TYPE}/{TYPE}-NN_*/...),可选 threshold,默认评审阈值为 90。
综合状态规则:PASS 需 validator PASS 且 reviewer 分数 >= 阈值且无阻塞问题;FAIL 为 validator FAIL 或 reviewer 分数低于阈值或存在阻塞/需人工处理的问题。评分采用扣减制:100 - total_deductions,并与 >=90 的通过门槛比较。
报告格式:输出文件 TSPEC-NN.A_audit_report_vNNN.md,包含 Summary(TSPEC ID、EST 时间戳、总体状态、validator 状态、reviewer 分数)、Score Calculation (Deduction-Based)、Validator Findings、Reviewer Findings、Coverage Findings(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST 覆盖、可追溯/标签覆盖、SPEC 对齐与边界用例覆盖)、Fix Queue for doc-tspec-fixer(auto_fixable、manual_required、blocked)以及 Recommended Next Step(运行 doc-tspec-fixer 或需人工更新)。
发现项规范化要求:每条发现必须包含 source(validator|reviewer)、code、severity(error|warning|info)、file(相对路径)、section(已知的标题/锚点)、action_hint(简短祈使指引)、confidence(high|medium|manual-required)。
交接契约:doc-tspec-fixer 必须接受综合审计报告作为等价上游输入,优先 TSPEC-NN.A_audit_report_vNNN.md,兼容旧版 TSPEC-NN.R_review_report_vNNN.md;优先级为先选最新时间戳,时间戳相同则优先 .A_audit_report。
适用场景:需要一条命令做 TSPEC 质量检查、需要为 doc-tspec-fixer 生成综合报告、或在生成 TASKS 之前执行 QA。不适用场景:TSPEC 尚未存在(应先使用 doc-tspec / doc-tspec-autopilot 生成),或只需要单一检查域(直接使用 validator 或 reviewer)。
示例调用:/doc-tspec-audit docs/10_TSPEC/UTEST/UTEST-01_auth_service/UTEST-01_auth_service.md;预期结果为 validator 运行、reviewer 运行、生成综合审计报告、fixer 可直接从综合报告执行。
实现计划一致性(IPLAN-004):将计划派生输出视为有效来源模式,验证实现计划范围/目标的意图保持;校验上游 autopilot 优先级假设 --iplan > --ref > --prompt;将计划上下文与产物输出之间的目标/范围冲突标记为需要澄清的阻塞问题;不要引入 docs-v2.0/00_REF 之类的旧式回退路径。
版本历史:1.0(2026-02-27)初始 TSPEC 审计封装,validator→reviewer 编排,为 fixer 提供以 .A_ 优先、.R_ 兼容的综合报告契约。
限制:资料未提供具体的安装步骤、收费信息或平台要求。