SuperAPI AI 工具集

doc-adr-fixer

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:doc-adr-fixer 读取最新审计报告 .aidoc/audit/05_ADR-audit.md,对 ADR 应用修复,使审计与修复循环逐步收敛。它不用于创建新 ADR;无审计报告时不应使用,应先运行 doc-adr-audit。

主要能力:按阶段修复结构(嵌套目录规则、移动与重命名、相对链接)、缺失文件占位、损坏或绝对链接、元素 ID(重推导 ADR.NN.SS.xxxx,保留有效 ID)、内容(模板日期、状态默认 Proposed、标题规范化、标记 TODO/TBD)、引用(补充 @ears @bdd 等必需标签、@adr: 自标签、@depends: 交叉链接与索引)、上游元数据与漂移(分层合并,超 15% 走归档重生成),以及风格问题(禁用词、超长段落、frontmatter 不一致)。

使用方式:先备份 ADR 至 tmp/backup/ADR-NN_<ts>/;按团队模式或 single_pass 模式执行。团队模式会依据报告与 .aidoc/review/05_ADR/<ADR-id>/ 下各 persona 槽位,将阻塞性 P0/P1 发现分派给对应角色做补丁验证,把结果写入 <persona>.fix_<N>.json,回归则回滚并标记 manual_required;P2/P3 仅作建议,确定性应用。最终由 synthesizer 生成 ADR-NN.F_fix_report_vNNN.md。存在 saga.json 时会记录状态转换,检查点在 1500 秒软截止,超时写入 PARTIAL_TIMEOUT 并保留已完成验证。

适用场景:在 doc-adr-audit 返回 FAIL 后,作为 Audit → Fix → Audit 循环的一环使用;也支持被 doc-adr-autopilot 编排或单独调用。

限制:依赖审计报告与 ADR 文档;无报告不得使用;不创建新 ADR;不确定信息如收费、价格与效果暂未提供。修复不得删除既有决策、上下文或备选方案内容,不得为通过检查而改动决策依据。