Systematic Debugging
系统性调试：先诊断再修复，避免误修
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Systematic Debugging。 它的用途是：系统性调试：先诊断再修复，避免误修 完整的 Skill 内容见：https://321skill.com/skills/systematic-debugging-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我部署的Node服务在凌晨3点会突然返回502，持续5分钟自动恢复，日志里只有'connect ETIMEDOUT'，没有其他异常。' 它会引导你检查数据库连接池耗尽、上游API超时配置、系统资源监控指标，最终定位到是连接池回收定时器与业务高峰重叠导致的问题。
介绍
面对代码中的 Bug、测试失败或意外行为时，很多开发者会急于直接修改代码，结果往往引入新问题。Systematic Debugging 提供了一套结构化的调试流程：先收集错误信息、复现条件、环境差异，再逐步缩小范围，最后才提出修复方案。它帮助你在动代码之前，先彻底理解问题根源。
使用方式非常简单：遇到任何异常时，告诉 AI 你观察到的现象（错误日志、异常堆栈、预期 vs 实际行为），AI 会引导你按步骤进行排查——检查输入数据、确认环境配置、分析日志关键行、对比正常与异常分支、假设验证循环。整个过程像一位经验丰富的架构师在旁边陪你调试。
适合所有需要调试代码的开发者：后端工程师排查服务器异常、前端工程师定位页面渲染问题、测试工程师分析失败用例、智能体开发者调试 Agent 行为异常。尤其适合那些在复杂系统中找不到头绪的场景。
建议：使用前先整理好完整的错误信息（堆栈、日志、环境信息），越详细越好。避免在没有任何上下文的情况下直接问“为什么报错”，AI 会反过来追问你。另外，本技能侧重“诊断”而非“修复”，修复方案仅作为最后一步输出，如果你需要一键修复，请配合其他专门修复的 Skill 使用。
核心特点
与同类调试 Skill 不同，Systematic Debugging 强制要求“先诊断再修复”，将调试过程拆解为可复现的排查步骤，避免跳步直接修改代码导致的二次错误。
注意事项
不适用于完全没有错误信息、无法复现的模糊问题，或者需要外部硬件/真实环境才能触发的偶发缺陷。
常见问题
如何用这个 Skill 调试内存泄漏？
先提供堆转储信息或内存增长曲线，AI 会引导你分析对象引用链和 GC 日志，定位泄漏对象。
能不能用它调试网络请求失败？
可以，提供请求链路、响应状态码、超时时间等，AI 会帮你检查 DNS、端口、防火墙、代理等环节。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/systematic-debugging-x-4/raw/index.md 读取 Systematic Debugging 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/systematic-debugging-x-4/raw/index.md（查看排版版本）