用途:系统化调试实验代码,通过结构化错误分类与修复策略处理报错。
输入:$0 为错误信息、stderr 输出或存在问题的代码文件;$1 可选,为产生该错误的代码。参考文档位于 ~/.claude/skills/code-debugging/references/debug-patterns.md。
主要能力与流程:第一步对错误分类,涵盖 SyntaxError、ImportError、RuntimeError、TimeoutError、OutputError、LogicError,并标注严重程度。第二步分析根因,读取 traceback(截断时取最后 1500 字符),定位出错行与变量,检查常见模式,如设备不匹配(CPU 与 GPU 张量)、矩阵运算形状不匹配、缺少数据归一化、索引差一错误、损失函数与任务类型不符。第三步应用修复策略:语法或导入错误直接修复一次;运行时错误修复后重跑,最多 4 次重试;逻辑错误反思方法并考虑替代方案;超时则减少数据规模、优化瓶颈或加入早停。第四步反思与预防,说明错误原因、涉及行、逐行修复并记录应避免的模式。修复策略状态机:首次尝试重新提交代码;第二次视严重程度决定重新提交或保留;第三次仍失败则从零重写。
规则:优先最小化针对性编辑而非全量重写;最多 4-5 次修复尝试后应改变思路;始终将长错误输出截断为最后 1500 字符;修复后验证未引入新错误;保留错误历史以避免重复;若准确率为 0% 先检查准确率计算再检查数据管道。
相关技能:上游为 experiment-code,另见 paper-to-code、data-analysis。适用场景为实验代码调试;限制条件暂未提供。