用途:在 SPEC 文件已存在、尚未生成 TDD 时进行统一审计,产出合并报告(.aidoc/audit/06_SPEC-audit.md),并可在自动流程的审计↔修复循环中使用;不用于创建 SPEC。
主要能力:一次执行内完成结构检查与内容质量评审。结构检查含模板符合性枚举(加载 SPEC-TEMPLATE.yaml,要求每个必填章节以 ## 标题出现,缺失即阻断)、YAML 语法、文档 ID(SPEC-NN 形式)、章节完整非空、上游累积标签链(@brd @prd @ears @bdd @adr)及 TDD-Ready 分数阈值(默认 90)。另有建议级检查:元数据、C4-L3 范围、内部链接、@threshold 引用、@tdd 契约、@diagram 标签与写作风格。内容评审有两种模式:team 模式按角色分工(architect 30、tech_lead 30、integration_lead 20、chaos_engineer 10、security_engineer 10)派发子代理,写入槽位后由 synthesizer 汇总为 verdict.json 与 report.md;single_pass 模式在本技能上下文内顺序应用所有视角。
使用方式:输入 SPEC 路径与可选分数阈值,按“结构检查→记录→内容评审→合并归一化→写报告→必要时移交 doc-spec-fixer”执行。每次从头审计,不复用历史分数。若通过 autopilot 触发会读写 saga.json 并检查 1500 秒软截止;独立调用则不初始化 saga 日志。
限制:每次覆盖写单个报告文件;内容评审须忽略作者自评字段(如 *_ready_score、audit_score 等);若评审未达法定人数则标记为低可信度交人工复核,不得静默通过;只有 autopilot 驱动的运行才产生 saga.json。