SuperAPI AI 工具集

doc-ears-fixer

通用与其它

查看项目

更新于 10-16 03:44

技能介绍

doc-ears-fixer 用于读取最新审计报告并对 EARS 文档应用修复,衔接 doc-ears-audit 与可通过的 EARS 文档,使审计与修复循环收敛。属于第 3 层(EARS 质量改进),上游输入为 EARS 文档与 .aidoc/audit/03_EARS-audit.md,下游输出为修复后的 EARS 与 EARS-NN.F_fix_report_vNNN.md。

使用时机:在 doc-ears-audit 返回 FAIL 之后,作为审计→修复→审计循环的一部分;没有审计报告时不应使用(需先运行审计),也不用于创建新的 EARS(应使用 doc-ears 或 doc-ears-autopilot)。

修复阶段按顺序执行:Phase 0 结构(嵌套文件夹规则),Phase 1 缺失文件,Phase 2 链接(相对路径与绝对路径转换),Phase 3 元素 ID(重新推导 EARS.NN.SS.xxxx),Phase 4 内容(占位符与语法),Phase 5 引用(可追溯性与标签),Phase 6 上游元数据与漂移,Phase 7 风格(禁用短语、超长文本、frontmatter 一致性)。

模式:remediate 模式从 .aidoc/profile.yaml 读取 review_mode;team 模式下按 persona 槽位读取结构化发现,分派责任 lens 进行补丁验证,多 lens 发现需所有 lens 均无新增 P0/P1 才接受;single_pass 模式下直接应用 Phase 0–7,不做 lens 验证。

每项应用修复按置信度分类为 auto-safe、auto-assisted、manual-required;内容保留规则要求不得删除现有需求内容。修复报告写入 EARS-NN.F_fix_report_vNNN.md,包含摘要、已应用修复、人工审核队列、修复后验证、清理摘要与后续步骤,循环至分数达到阈值或达到最大迭代次数。

与 saga 交互:在团队模式下读取并更新 .aidoc/review/03_EARS/<EARS-id>/saga.json,修复器充当补救阶段;检查点边界位于多 lens 验证分派之间,若超过 SOFT_DEADLINE(1500 秒)则退出并标记 PARTIAL_TIMEOUT;独立调用时若无 saga.json 则不初始化完整 saga。具体平台、收费、价格等信息暂未提供。