用途
Systematic Debugging 是一个系统化调试技能,旨在提供结构化的调试方法,防止随机猜测,确保在解决问题之前先正确理解问题。适用于调试复杂问题。
主要能力
该技能围绕四阶段调试流程展开:
阶段一:复现(Reproduce)
在修复之前,先可靠地复现问题。技能提供复现步骤模板,包括精确的复现步骤、下一步操作以及预期结果与实际结果的对比。同时要求评估复现率,分为:始终(100%)、经常(50-90%)、有时(10-50%)、罕见(<10%)。
阶段二:隔离(Isolate)
缩小问题来源。技能提供一组隔离问题:这个问题何时开始出现?最近有什么变化?是否在所有环境中都发生?能否用最小代码复现?触发它的最小改动是什么?
阶段三:理解(Understand)
找到根本原因,而不仅仅是症状。技能提供根因分析方法,包括“五个为什么”(The 5 Whys):从第一个观察开始,逐层追问更深层原因,直到找到根本原因。
阶段四:修复与验证(Fix & Verify)
修复并验证问题确实被解决。技能提供修复验证清单:缺陷不再复现、相关功能仍然正常、没有引入新问题、添加测试以防止回归。
使用方式
该技能以清单和模板的形式指导调试过程:
调试清单
开始之前:能否一致地复现?是否有最小复现案例?是否理解预期行为?
调查期间:检查最近的变更(git log)、检查日志中的错误、必要时添加日志、使用调试器/断点。
修复之后:记录根本原因、验证修复、添加回归测试、检查类似代码。
常用调试命令
# 最近的变更
git log --oneline -20
git diff HEAD~5
# 搜索模式
grep -r "errorPattern" --include="*.ts"
# 检查日志
pm2 logs app-name --err --lines 100
反模式(Anti-Patterns)
技能列出了应避免的做法:随机更改(“也许我改这个就行……”)、忽视证据(“那不可能是原因”)、没有证据就假设(“一定是 X”)、不先复现(盲目修复)、止步于症状(不找根本原因)。
适用场景
适用于调试复杂问题,尤其是需要系统化方法而非随机尝试的场景。
限制
该技能的具体安装方式、平台支持、收费情况等暂未提供。