SuperAPI AI 工具集

bugfix

测试与质量

查看项目

更新于 10-16 05:07

技能介绍

用途:在出现可复现 bug、失败测试、运行时错误、回归或缺陷报告时,按固定顺序执行修复流程,强调先复现、再读代码、后假设,修复根因而非症状。

主要能力与步骤:1)复现:建立最小可靠复现路径(测试、命令、点击序列、载荷);无法复现则停止并向负责人索取复现步骤,不修无法复现的问题。2)先读代码:用工具实际读取失败相关文件,不略读;涉及外部 SDK/API 时触发 official-docs-first 技能;推理中引用具体 file:line。3)定位根因:从症状反向走失败路径,检查失败文件的 git log -p --follow <file>,用 Grep/Serena find_references 查相关调用点;读码后才允许假设,并标注“Hypothesis (unverified): X. Verifying via Y.”。4)修原因不修症状:做架构上正确的修复,不用 try/catch 包装;若正确修复超出该 bug 范围,写 ADR 并提出后续 TZ,而非打补丁。5)验证:新增或更新能捕获该 bug 的测试,运行 pytest tests/test_X.py 或等价命令必须通过,对改动文件运行 mypy/ruff 必须干净。6)更新记忆:问题部分解决或暴露更深问题时记录到 docs/agent/06_known_issues.md;达到事故级别则写 docs/agent/08_postmortems.md;追加 docs/agent/04_changelog.md。7)若做了架构决策则写 ADR,例如“从 X 切换到 Y 以修复此问题”需要 ADR,“修补 Y 的边界情况”不需要。

反模式(禁止):静默捕获异常、添加 try/except: pass、加布尔开关跳过损坏路径、用“// FIXME: weird issue, working around”注释包裹 bug、未加验证修复的测试就标记任务完成。

适用场景:有明确复现路径的缺陷修复、失败测试排查、回归定位。限制:无法复现时不应继续修复;资料未提供具体安装命令、收费、价格、平台或效果信息。