用途:在 doc-iplan-audit 返回 FAIL 后,作为 Audit → Fix → Audit 循环的一环,读取 .aidoc/audit/08_IPLAN-audit.md 并对 IPLAN 应用修复。不用于创建新 IPLAN,也不应在没有审计报告时使用。
主要能力:按 Phase 0–7 修复结构命名与放置、缺失章节、链接、ID、内容与清单、引用追溯、上游漂移与写作风格;修复前备份 IPLAN 到 tmp/backup/IPLAN-NN_<ts>/,出错时恢复。ID 规则来自 ID_NAMING_STANDARDS.md,结构规则来自 IPLAN-TEMPLATE.yaml 与 README.md。
使用方式:支持 team 与 single_pass 两种模式,由 .aidoc/profile.yaml 的 review_mode 决定,未设置时按 ADAPTATION.md 回退。team 模式优先读取 .aidoc/review/08_IPLAN/<IPLAN-id>/ 下的 per-persona 槽位,按 lens→agent 映射派发验证,P0/P1 需通过验证,回归则回滚并标记 manual_required;P2/P3 直接应用。single_pass 模式直接应用补丁,不做 lens 验证。
Saga 交互:被 doc-iplan-autopilot 调用时读写 saga.json,在补丁验证期间将分支转为 BRANCH_COMPENSATING,验证通过转 BRANCH_COMPLETED,回归转 BRANCH_FAILED;超过 SOFT_DEADLINE 1500s 时以 PARTIAL_TIMEOUT 干净退出,已写槽位可续跑。独立调用且无 saga.json 时跳过 saga 转换。
输出:生成 IPLAN-NN.F_fix_report_vNNN.md,含摘要、修复表、人工复核队列、修复后验证与验证槽位索引;循环至分数达标或 MAX_ITERATIONS=3。
限制:不删除既有清单条目、契约或会话历史;上游漂移按 <5%、5–15%、>15% 分级处理;无法推断的领域内容标记 manual-required;需遵守 section_toggles,不重新引入已关闭的可选章节。具体阈值、命令与配置细节以资料为准,其余暂未提供。