SuperAPI AI 工具集

code-debugging

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:系统化调试实验代码,通过结构化的错误分类与修复策略处理报错。输入为 $0(错误信息、stderr 输出或存在问题的代码文件),可选 $1(产生错误的代码)。参考文件位于 ~/.claude/skills/code-debugging/references/debug-patterns.md。

主要能力:按类别划分错误并评估严重程度,包括 SyntaxError(语法、缩进,低)、ImportError(缺模块、名称错误,低)、RuntimeError(除零、形状不匹配,中)、TimeoutError(死循环、过慢,中)、OutputError(缺文件、格式错误,中)、LogicError(结果错误、0% 准确率,高)。

使用方式:第一步分类错误;第二步分析根因,读取 traceback(截断时取最后 1500 字符),定位出错行与变量,检查设备不匹配(CPU 与 GPU 张量)、矩阵运算形状不匹配、缺少数据归一化、索引差一错误、损失函数与任务类型不符等常见模式;第三步按策略修复:语法/导入错误直接修复一次,运行时错误修复后重跑最多 4 次,逻辑错误反思方法并考虑替代方案,超时则缩小数据集、优化瓶颈或加早停;第四步反思与预防,说明错误原因、涉及行、逐行修复方式及需避免的模式。修复状态机:阶段 0 首次尝试重新提交代码,阶段 1 第二次按严重程度决定重提或保留,阶段 2 第三次仍失败则从头重新生成。

限制与规则:优先最小化定向修改而非整体重写;最多 4-5 次修复后更换方法;长错误输出始终截断到最后 1500 字符;修复后验证不引入新错误;保留错误历史避免重复;若准确率为 0%,先检查准确率计算再检查数据管道。相关技能:上游 experiment-code,另见 paper-to-code、data-analysis。