调试排错专家助手技能，当遇到Bug、异常、错误时，提供系统化的调试方法论，帮助快速定位问题根因并修复。涵盖复现优先原则、假设验证循环、常见Bug类型诊断清单、根因定位流程，有效减少盲目试错，提高问题解决效率。
调试排错技能：系统化定位Bug根因减少盲目试错
【适用场景】
Step 1：遇到Bug时的系统化排查
当你遇到Bug不知从何下手时，按照"复现→分析→假设→验证→修复→确认"的系统化流程进行排查，禁止盲目猜测和试错。Step 2：定位疑难杂症的根本原因
当一个问题反复出现却找不到根因时，使用假设验证法，从最可能的原因开始逐一排查，直到定位真正的根因。Step 3：代码异常和错误的快速诊断
当程序抛出异常或报错时，根据错误信息和上下文快速判断问题类型，缩小排查范围。【操作步骤】
第一步：复现问题
复现优先原则： - 无法复现的Bug无法彻底修复 - 记录错误信息、运行环境、操作步骤 - 尝试在最小化环境中复现问题
第二步：收集信息
收集以下信息： - 错误堆栈（Stack Trace） - 相关日志 - 输入数据 - 环境配置 - 出现问题前的变更记录
第三步：提出假设
基于收集的信息提出假设： - 最可能的原因是什么？ - 哪些假设最容易验证？ - 是否符合常见Bug模式？
第四步：验证假设
用证据验证假设： - 添加日志或断点验证假设 - 使用排除法缩小范围 - 逐步逼近根因
第五步：修复问题
修复时注意： - 修复的是根因，不是表象 - 修复后需要验证问题不再出现 - 确认修复不会引入新问题
第六步：确认解决
验证清单： - 问题是否在原环境复现？ - 测试是否覆盖了问题场景？ - 是否有回归风险？
【代码模板】
常见Bug类型诊断表：
| Bug类型 | 典型表现 | 排查重点 |
|---|---|---|
| 空指针 | NullPointerException | 变量是否初始化、返回值是否可能为空 |
| 数组越界 | IndexOutOfBounds | 索引计算、循环边界、数组长度 |
| 类型错误 | ClassCastException | 对象的实际类型是否匹配 |
| 并发问题 | 数据不一致 | 共享资源访问、锁的范围 |
| 资源泄漏 | OOM、连接耗尽 | 资源是否正确释放 |
| 逻辑错误 | 输出不符合预期 | 条件判断、循环逻辑、算法实现 |
假设验证循环： ``` 1. 提出假设：基于错误信息，最可能的原因是什么？ 2. 设计验证方案：如何验证这个假设？ 3. 执行验证：添加日志/断点/测试 4. 分析结果：假设成立？→ 修复；假设不成立？→ 下一个假设 5. 如果所有已知假设都不成立 → 收集更多信息，重新分析 ```
【复盘要点】
1. 先复现再分析是调试的铁律：无法复现的Bug往往是间歇性的，其根因可能在某些特定条件下才会触发。记录完整的复现步骤是解决问题的关键第一步。
2. 假设验证比盲目试错高效10倍：遇到问题时不要随意修改代码期望碰巧解决问题，而是系统地提出假设、设计验证方案、用证据排除或确认假设。
3. 记录调试过程的价值：每次调试后记录问题和解决方案，下次遇到类似问题时可以快速定位。积累常见Bug的诊断经验能显著提高调试效率。
来源：dkbnull/hello-skill (GitHub) | https://raw.githubusercontent.com/dkbnull/hello-skill/main/common/skills/debug/SKILL.md