mcpField
C
code-debugging

code-debugging

github.com/lingzhi227开发4401.7k 次安装35 周前更新
代码仓库

关于 code-debugging

系统排查实验代码错误并选择针对性修复方案的技能。它对故障分类、追踪可能原因，并指导修改后的验证与预防。

主要功能

  1. 01按类型和严重程度分类错误
  2. 02依据错误输出追踪原因
  3. 03按错误类别采用修复策略
  4. 04验证修复并预防回归
  5. 05记录尝试过程和错误历史

适用场景

  1. 01排查 traceback 或 stderr 输出
  2. 02调查张量形状或设备不匹配
  3. 03修复实验结果异常

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lingzhi227/agent-research-skills --skill code-debugging

安装后在 Claude Code 中输入/code-debugging确认已加载。

附带文件references/debug-patterns.md

详细介绍

代码调试

通过结构化的错误分类和修复策略，系统地调试实验代码。

输入

  • $0 — 错误消息、stderr 输出或存在问题的代码文件
  • $1 — 可选：产生错误的代码

参考资料

  • 调试模式和状态机：~/.claude/skills/code-debugging/references/debug-patterns.md

工作流

第 1 步：对错误分类
类别示例严重程度
SyntaxError语法无效、缩进错误低
ImportError缺少模块、名称错误低
RuntimeError除以零、形状不匹配中
TimeoutError无限循环、运行过慢中
OutputError缺少文件、格式错误中
LogicError结果错误、准确率为 0%高
第 2 步：分析根本原因
  1. 阅读错误回溯（如果被截断，查看最后 1500 个字符）
  2. 找出导致错误的确切代码行和变量
  3. 检查常见模式：
    • 设备不匹配（CPU 与 GPU 张量）
    • 矩阵运算中的形状不匹配
    • 缺少数据归一化
    • 索引中的差一错误
    • 任务类型对应的损失函数不正确
第 3 步：应用修复策略

语法/导入错误：直接修复，尝试一次 运行时错误：修复并重新运行，最多重试 4 次 逻辑错误：反思解决方法，考虑替代方案 超时：缩小数据集、优化瓶颈、添加提前停止

第 4 步：反思并预防

修复后：

  1. 解释错误发生的原因
  2. 找出导致错误的代码行
  3. 逐行描述修复内容
  4. 指出今后编写代码时应避免的模式

修复策略状态机

Stage 0 (first attempt) → repost code as fresh
Stage 1 (second attempt) → repost or leave depending on severity
Stage 2 (third attempt) → regenerate from scratch if still failing

规则

  • 优先进行有针对性的最小改动，而不是完全重写
  • 更换解决方法前，最多尝试修复 4-5 次
  • 始终将较长的错误输出截断至最后 1500 个字符
  • 修复后，验证没有引入新错误
  • 保留错误历史，避免重复犯同样的错误
  • 如果准确率为 0%，先检查准确率计算，再检查数据流水线

相关技能

评论

支持 Markdown