SuperAPI AI 工具集

debug-assist

编程与开发

查看项目

更新于 10-16 05:47

技能介绍

用途:debug-assist 提供一套系统化调试流程,解决循环调试问题(试一下→不行→再试别的→忘记试过什么→重复)。它把所有假设和结果记录为调试轨迹。

适用时机:bug 不简单(不是明显的拼写错误);初步修复尝试未奏效;用户表示“想不通为什么会这样”。

执行模型:始终由主智能体直接运行该技能;输出为基于聊天的调试轨迹加上修复本身。

工作流:

  1. 定义 bug:用提问工具澄清预期行为、实际行为、何时开始、是否可复现。
  2. 复现:在本地运行触发 bug 的命令;若无法复现,说明与环境相关,检查操作系统、版本、配置、数据。记录“是否复现、所用命令”。
  3. 隔离:根据堆栈或错误信息定位出错文件、失败函数、触发输入,必要时加日志。记录“隔离到某文件某函数,由某输入触发”。
  4. 假设:列出最多 3 个可能原因,此时不要修复。
  5. 验证:对每个假设加针对性日志或断言,运行失败场景,记录“假设 A:确认/排除,因为……”。
  6. 修复:只针对已确认的根因做最小修改,不重构。
  7. 测试:运行原始失败场景必须通过,运行完整测试套件确认无回归,移除调试日志。
  8. 记录:若 bug 不明显,记录根因、为何不明显、如何预防,并考虑添加防回归测试用例。

规则:记录路径,每个假设及结果都要留痕;先复现再修复;先隔离再改代码;一次只验证一个假设;最小修复,不做改进或重构;不要使用内置的 explore 子智能体。

限制:资料未提供安装命令、收费、价格、平台支持等具体信息。