SuperAPI AI 工具集

fix-loop

通用与其它

查看项目

更新于 10-16 03:47

技能介绍

fix-loop 是一套有界的修复与验证协议,用于处理审查中已确认的问题,核心目的是防止无限循环,通过限制尝试次数并在失败时升级给用户。

用途:适用于两轮审查(或任意审查)产生已确认的 P0/P1 问题需要修复时,也适用于测试失败后需要修复代码或测试的场景。

输入与筛选:接收 findings(符合其输出 schema 的已确认 P0/P1 问题)、artifacts 路径和标准。只处理 verdict="confirmed" 且 severity 为 P0 或 P1 的问题,忽略 P2/P3,由调用方负责确认质量。

流程:第 1 轮修复,为每个问题(或影响同一批文件的相关问题)启动修复子代理,返回变更文件、摘要和疑虑,用 git add 暂存特定文件但不提交。随后做确定性针对性验证,如重跑相关测试、grep 检查代码或抽查行为;若无法运行(测试不稳定、缺环境、工具故障)视为不确定,不记为失败尝试。第 2 轮为完整修复加验证:再次启动修复子代理并告知上轮尝试,暂存后用 git diff --staged 生成范围差异,交由验证器按原标准和“无新增 P0/P1 回归”复核,发现新 P0/P1 问题则升级,不进入第 3 轮。

升级:若第 2 轮仍有未解决的 P0/P1,停止并向用户展示原问题、两轮尝试和仍存在的问题。使用 AskUserQuestion 询问“手动修复”“换一种方法”“推迟此问题”。

规则:最多 2 次尝试;修复必须限定在问题范围内,超出范围需先返回 needs_scope_expansion 并获批准;每次修复都必须验证;影响同一文件的相关问题可合并;测试失败需先判断是代码缺陷还是测试缺陷再修复。输出 schema 包含 Finding 与 ReviewOutput,严重级别 P0 至 P3 及 confidence、criterion、verdict、evidence 等字段。资料未提供具体费用、平台限制或效果数据。