用途:在 IPLAN 文件已存在、代码实现开始之前,对 IPLAN 执行统一审计——声明式结构检查加内容质量评审,一次运行产出单一合并报告,供 ../doc-iplan-fixer/SKILL.md 消费。框架本身不含运行时代码,本技能即校验器,由 Claude 依据规范直接对 IPLAN 逐项检查。也可用于 autopilot 的审计↔修复循环。不用于创建 IPLAN(应使用 ../doc-iplan/SKILL.md 或 ../doc-iplan-autopilot/SKILL.md)。
主要能力:输入为 IPLAN 路径(docs/08_IPLAN/IPLAN-NN_*.yaml),可选分数阈值(默认 90)。执行顺序:结构检查→记录发现→内容评审→合并归一化发现(含 playbook 覆盖行)→写入 .aidoc/audit/08_IPLAN-audit.md→若存在可自动修复项则交给 doc-iplan-fixer。每次审计均从零开始,不复用旧分数或缓存,独立计算 CODE-Ready 分数;报告为单文件原地覆盖。
评审模式:从 .aidoc/profile.yaml 解析 review_mode,未设置时按框架默认(门禁处 team,写入时 single_pass)。team 模式下按 REVIEW_CREWS.yaml 的权重(tech_lead 30、architect 25、operator 15、integration_lead 12、auditor 10、chaos_engineer 8)向各 lens 派发 Task 子代理,读取 framework/playbooks/08_IPLAN/<lens>.md 并内联;playbook 缺失则标记 BRANCH_FAILED 并跳过该 lens。各 lens 写入槽位后由 synthesizer 生成 verdict.json 与 report.md。single_pass 模式在本技能上下文内顺序应用全部 lens,不派发子代理、不适用 quorum。两种模式下结构门禁均在此确定性执行,不委托。
限制与约定:lens 不得读取、引用或加权作者的 _ready_score、_score、readiness_score、audit_score 等自评字段。team 模式下若 verdict.coverage.quorum_met 为 false,结果标记为低置信度并转人工复核,绝不静默通过。saga 交互:由 autopilot 调用时读写 .aidoc/review/08_IPLAN/<IPLAN-id>/saga.json;独立调用且无 saga.json 时不初始化 saga。断点策略:所有 lens 派发返回后、调用 synthesizer 前检查耗时,超过 SOFT_DEADLINE 1500 秒则以 PARTIAL_TIMEOUT 干净退出。迭代上限 MAX_ITERATIONS=3 由 saga 驱动方执行,本审计不重试。