关于 debugging
一组面向软件开发调试的技能,指导 Agent 先调查根因,再验证修复。内容涵盖系统化排查、调用链追踪、分层防护与完成前验证。
主要功能
- 01四阶段系统化调试
- 02沿调用栈追踪根因
- 03多层数据验证
- 04完成前运行验证
适用场景
- 01调查测试失败或异常行为
- 02定位调用链深处的错误
- 03减少同类缺陷反复出现
- 04确认修复后再报告完成
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mrgoonie/ claudekit-skills --skill debugging安装后在 Claude Code 中输入/debugging确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
root-cause-tracing/find-polluter.shsystematic-debugging/CREATION-LOG.mdtest-academic.mdtest-pressure-1.mdtest-pressure-2.mdtest-pressure-3.md详细介绍
调试技能
一套系统化调试方法,确保在尝试修复之前进行全面调查。
可用子技能
系统化调试
位置: systematic-debugging/SKILL.md
四阶段调试框架:根因调查 → 模式分析 → 假设验证 → 实施。铁律:未经根因调查,绝不修复。
根因追踪
位置: root-cause-tracing/SKILL.md
沿调用栈反向追踪错误,找到最初的触发原因。不要修复症状——找出无效数据的来源,并从源头修复。
纵深防御式验证
位置: defense-in-depth/SKILL.md
在数据经过的每一层进行验证,从结构上杜绝错误。四个层级:入口点 → 业务逻辑 → 环境防护 → 调试检测。
完成前验证
位置: verification-before-completion/SKILL.md
运行验证命令并确认输出,然后再声称成功。铁律:没有最新的验证证据,绝不声称已完成。
适用场景
- 生产环境中的错误 → 从 systemat ic-debugging 开始
- 错误出现在调用栈深处 → 使用 root-cause-tracing
- 修复错误 → 找到根因后应用 defense-in-depth
- 准备声称“已完成” → 使用 verification-before-completion
快速选择
| 症状 | 子技能 |
|---|---|
| 测试失败、行为异常 | systematic-debugging |
| 错误出现在不该出现的位置 | root-cause-tracing |
| 同一错误反复出现 | defense-in-depth |
| 需要确认修复是否有效 | verification-before-completion |
核心理念
“系统化调试比猜测和反复试错更快。”
来自实际调试会话:
- 系统化方法:15-30 分钟完成修复
- 随机修复方法:反复折腾 2-3 小时
- 首次修复成功率:95%,而随机修复仅为 40%
评论
支持 Markdown