SuperAPI AI 工具集

fixer

编程与开发

查看项目

更新于 10-16 06:26

技能介绍

Fixer 是 Bug Hunter 流程中的外科式代码修复技能,负责把 Referee 智能体确认过的缺陷落地为精确、最小的代码改动。

用途 它接收一份已验证的缺陷清单,每个缺陷带有 BUG-ID、文件路径、行号范围、严重级别、描述和建议修复方向。同时接收修复策略上下文(safe-autofix、manual-review、larger-refactor 或 architectural-remediation)、技术栈上下文(框架、认证机制、数据库、关键依赖)以及按目录划分的缺陷范围。其职责是实施修复,而不是发现新缺陷。

主要能力

  • 按缺陷清单逐项修复,只处理被分配的缺陷,不处理其他发现的问题。
  • 尊重被分配的修复策略,不把 manual-review、larger-refactor 或 architectural-remediation 静默升级为外科式补丁。
  • 每个修复只改动解决该缺陷所需的最少行数,不重构、不添加测试、不改进代码风格。
  • 支持多文件修复:若缺陷涉及函数签名变更并影响调用方,会一并修改所有必要位置,避免留下损坏的调用方。
  • 处理同文件冲突:同一文件内多个缺陷的修复相互影响时,先修高严重级别缺陷,再调整第二个修复以适配。
  • 当修复依赖特定库 API 时,可通过文档查询脚本核对正确用法。

使用方式 工作分为三个阶段。第一阶段为阅读与理解:对每个缺陷,必须读取确切的文件与行范围,阅读完整函数、调用方、相关导入与类型,必要时读取交叉引用文件,理解代码应做什么与实际做了什么,并批判性地看待 Referee 给出的修复方向。第二阶段为规划:确定具体改动内容、是否有调用方或依赖方需要同步更新、修复是否可能破坏其他部分;同一文件内多个缺陷需统一规划以避免冲突。第三阶段为实施:逐个缺陷修复,保持原有代码风格(缩进、引号、分号、命名约定),不新增依赖,保持无关行为不变,并处理 Referee 指出的所有边界情况。

文档查询 当修复依赖库特定 API 时,使用以下命令核对正确做法: 搜索:node "$SKILL_DIR/scripts/doc-lookup.cjs" search "<library>" "<question>" 获取文档:node "$SKILL_DIR/scripts/doc-lookup.cjs" get "<library-or-id>" "<specific question>" 若 doc-lookup 失败,可回退到: 搜索:node "$SKILL_DIR/scripts/context7-api.cjs" search "<library>" "<question>" 获取文档:node "$SKILL_DIR/scripts/context7-api.cjs" context "<library-id>" "<specific question>" 每个修复最多查询一次。

输出 将结构化修复报告写入任务指定的文件路径(通常为 .bug-hunter/fix-report.json);若未提供路径,则输出 JSON 到 stdout。若要求 Markdown 副本,仅在 JSON 产物存在后再写入。JSON 包含 generatedAt、summary(bugsAssigned、bugsFixed、bugsNeedingLargerRefactor、bugsSkipped、filesModified)以及 fixes 数组,每项含 bugId、severity、filesChanged、whatChanged、confidenceLabel(high/medium/low)、sideEffects(无副作用时为 ["None"])和 notes。输出必须是有效 JSON,且 JSON 对象之外不添加任何说明文字。

限制 不添加测试(由单独的验证步骤负责)、不添加文档或注释(除非修复必需)、不重构或“改进”代码、不改变函数签名(除非缺陷要求,且需注明)、不寻找新缺陷。若 Referee 建议的修复需要大幅重构,则实施能修复缺陷的最小版本,并在输出中注明该缺陷需要更大重构才能完整修复。