SuperAPI AI 工具集

systematic-debugging

编程与开发

查看项目

更新于 10-16 07:44

技能介绍

用途

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”)、不先复现(盲目修复)、止步于症状(不找根本原因)。

适用场景

适用于调试复杂问题,尤其是需要系统化方法而非随机尝试的场景。

限制

该技能的具体安装方式、平台支持、收费情况等暂未提供。