SuperAPI AI 工具集

bug-fix-learning

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途与触发:在出现 bug、测试失败、build 失败、非预期行为、性能退化、整合问题,或修复一次后问题仍在、修 A 坏 B 时触发;也包括使用者描述代码行为不符预期,以及处理 GitHub issue 时判断其是否为 bug/regression。Feature request、question、documentation、refactor/chore 不触发;纯 typo、import path 错误、配置格式错误、开发中功能未完成也不触发。

主要能力与流程:先做根因调查,读错误信息、稳定重现、检查最近变更、追踪数据流;多元件系统在边界加 log 定位层级,错误信息直指根因时可走快速通道。随后做模式分析、提出假设并做最小验证,修根因不修症状,一次只做一个修复;连续 3 次修复失败应停下讨论架构。修复后记录根因,再评估是否沉淀。

沉淀判准:只写代码、类型、测试、import 关系看不出的知识。写前问三题:tsc/eslint 会抓到吗、grep import 或 deps-check 看得出关系吗、测试会失败吗;任一为是则不写,并改以补类型、加 lint rule、补测试等替代动作。可写内容限于跨时序/跨 runtime 耦合、外部库陷阱、隐性数据契约、业务规则、领域计算逻辑、流程约束、架构决策等。写入位置包括 docs/cookbook、memory 的 feedback_*.md、以及 .claude/commands 流程文件。

使用方式:处理 issue 时先用 gh issue view 读取内容再分类。评估后必须在 Step 3 调用写入工具完成实际写入;Step 4 必须无条件输出评估摘要,说明哪些文件已写入,或为何不写及建议替代动作。

限制:默认不写;仅当机械工具抓不到、且下次可能再犯时才写 cookbook。写入过多会使 cookbook 腐坏、无人阅读。资料未提供具体安装命令、收费或授权信息。