SuperAPI AI 工具集

pstack-principle-fix-root-causes

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

用途

本技能用于调试场景,帮助开发者或智能体在排查问题时坚持修复根因,而不是停留在症状出现的位置。它把“症状”定义为错误状态变得可见的地方,把“根因”定义为系统第一次做了不该做的事、或未能处理本应处理的状态之处。

主要能力

  • 引导将每个症状追溯到系统第一次出错的位置,并在那里修复。
  • 提供一套可复用的调试模式,包括复现、逐层追问“为什么”、插桩读取真实错误与状态、判断触发状态是否合法、检查同类故障的所有实例等。
  • 指出常见的掩盖 bug 的手段:守卫(guard)、重试、吞掉错误、钳制数值、丢弃状态。
  • 提示对仅在重启后出现的失败优先怀疑持久化状态,如配置文件、缓存、锁文件、序列化状态。
  • 强调若变通方案需要长篇注释才能自圆其说,说明代码本身有误,应修代码而非注释。
  • 建议当关键事实需要深挖才能发现时,提出一个廉价且常开的信号,以便第一时间暴露问题。

使用方式

资料未提供具体的安装命令、调用方式或代码示例。该技能以原则性指导文本的形式呈现,适用于在调试过程中作为思考框架使用。

适用场景

  • 调试过程中定位故障原因。
  • 判断某个状态是否合法,从而决定是处理该状态还是继续向上追溯。
  • 排查仅在重启后出现的失败。
  • 识别并消除代码中掩盖 bug 的变通方案。

限制

资料未提供该技能的具体实现细节、依赖环境、平台支持、收费情况或效果数据。其内容为调试原则,不包含可直接执行的代码或工具命令。