SuperAPI AI 工具集

principle-fix-root-causes

编程与开发

查看项目

更新于 11-06 21:01

技能介绍

该技能用于调试阶段,指导开发者把每个症状追溯到系统第一次出错的位置并在那里修复。其基本判断是:症状是错误状态变得可见的地方,根因是系统第一次做了不该做的事,或未能处理本应处理的状态。只修症状会掩盖证据,让缺陷转移到别处显现,并使代码因无名 bug 的绕行方案而更难推理。

主要做法包括:先复现问题;在每一步追问“为什么”,直到答案指向代码中的错误决策而非更早决策的后果;卡住时加插桩,读取真实错误与实际状态,不靠猜测;判断触发症状的状态是否合法——若系统可能处于该状态,则在该处处理状态即为修复,若该状态本不应存在,则在出错点加检查只会掩盖 bug,应追查产生该状态的源头;守卫、重试、吞掉错误、钳制数值和丢弃状态是常见的掩盖手段;仅在重启后出现的失败应优先怀疑持久化状态,如配置文件、缓存、锁文件和序列化状态;按模式而非个例排查,找出所有同类缺陷一并修复;若绕行方案需要长篇注释辩解,说明代码有误,应改代码而非注释;若关键事实靠深挖才找到,应提出一种廉价、常开的信号,使其在第一时间可见。

使用方式:按照技能说明,在每个会话中先阅读一次宿主适配器,它会把上游 Cursor 专用的工具、模型、路径与权限说明映射到当前宿主,并设定权限边界。具体安装命令、调用示例和配置细节暂未提供。

适用场景为软件调试与缺陷排查,尤其是反复出现的同类问题、只在重启后出现的故障,以及容易用防御性代码掩盖的问题。限制方面:资料未说明收费、平台支持范围、效果保证,也未提供代码示例与具体操作命令,这些事实暂未提供。