用途:doc-req-audit 用于统一执行 REQ 审计流程,避免用户在 validator 与 reviewer 之间混淆,同时保留职责分离。它先运行 doc-req-validator(结构与 schema 门禁),再运行 doc-req-reviewer(语义与内容质量门禁),最终输出一份面向 doc-req-fixer 的合并报告。该技能属于第 7 层 REQ 质量门禁包装,上游为 REQ 文件,下游为合并审计报告 REQ-NN.A_audit_report_vNNN.md,并可选触发 doc-req-fixer 修复循环。
主要能力:执行强制顺序的 validator→reviewer 编排;归并并规范化两方发现;写出合并审计报告;在存在可自动修复项时交接给 doc-req-fixer。合并状态规则为:validator 通过且 reviewer 分数不低于阈值(默认 90)且无阻断问题时为 PASS,否则 FAIL。报告采用扣分制公式 100 - total_deductions,包含 Summary、Score Calculation、Validator Findings、Reviewer Findings、Coverage Findings、Fix Queue(auto_fixable / manual_required / blocked)和 Recommended Next Step 等章节。
使用方式:输入为 REQ 路径(docs/07_REQ/REQ-NN_*/...),可选阈值默认 90。示例调用:/doc-req-audit docs/07_REQ/REQ-01_f1_iam/。预期结果为 validator 运行、reviewer 运行、生成合并审计报告,fixer 可直接依据该报告执行。每个发现项须包含 source、code、severity、file、section、action_hint、confidence 字段。
适用场景:需要一条命令完成 REQ 质量检查时;需要为 doc-req-fixer 提供合并报告时;在 CTR/SPEC 生成前执行 QA 时。不适用:REQ 不存在时应先用 doc-req / doc-req-autopilot 生成;仅需单一检查域时直接用 validator 或 reviewer。
限制与已说明要求:必须按先 validator 后 reviewer 的顺序执行;修复队列需区分 auto_fixable、manual_required 与 blocked;交接给 doc-req-fixer 时优先使用 .A_audit_report,其次为旧版 .R_review_report,时间戳更新者优先,时间相同则选 .A_;IPLAN-004 要求将计划派生输出视为有效来源模式,验证上游 autopilot 优先级假设 --iplan > --ref > --prompt,计划上下文与产物输出的目标/范围冲突应标记为阻断问题,且不得引入 docs-v2.0/00_REF 等旧版回退路径。收费、价格、平台等信息暂未提供。