Systematic Debugging
系统化调试指南，先定位根因再修复
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Systematic Debugging。 它的用途是：系统化调试指南，先定位根因再修复 完整的 Skill 内容见：https://321skill.com/skills/systematic-debugging-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我遇到一个API返回500错误，日志显示NullPointerException，请求参数是{userId: 123}，请按照Systematic Debugging流程帮我分析根因。' AI会先要求你提供完整堆栈、复现步骤、环境版本等信息，然后列出假设并逐一验证，最终定位到某行代码因未判空导致的异常。
介绍
解决什么问题：在开发、测试或运维中遇到 Bug、测试失败或意外行为时，开发者往往急于直接修复，却忽略了系统性的根因分析，导致同一问题反复出现或修复后引入新缺陷。Systematic Debugging 提供一套标准化的调试流程，引导你从现象出发，逐步缩小范围，最终准确定位根本原因。
怎么用：当遇到任何异常时，先不要提问“如何修复”，而是执行该 Skill。它会要求你提供完整的错误重现步骤、环境信息、相关日志和代码片段。然后按照“描述问题 → 收集证据 → 提出假设 → 验证假设 → 确认根因”的步骤，与你协作完成分析。每一步都有明确的输出要求和检查点，确保不遗漏关键信息。
适合谁：后端开发、全栈开发、测试工程师、运维工程师等需要频繁排查复杂问题的技术角色。尤其适合团队中希望建立统一调试规范、减少重复沟通的场合。新手开发者也能通过此流程快速掌握专业调试方法。
使用建议：在非紧急的调试场景下使用效果最佳，例如日常开发、回归测试、代码审查前的异常分析。对于线上紧急故障，建议先快速止血，再回头用此 Skill 深度复盘。注意：该 Skill 本身不提供自动修复代码，而是帮助你提升定位问题的效率，修复仍需你根据根因自行决策。
核心特点
不同于普通答疑式提问，Systematic Debugging 强制要求你按结构化流程提供完整上下文（日志、环境、复现步骤），并引导 AI 进行多轮假设验证，避免直接给出“猜测性修复”，从而减少误判和遗漏。
注意事项
不适合需要秒级响应的线上紧急故障，因其系统化流程会消耗额外时间；也适用于完全无日志或无法复现的偶发问题。
常见问题
这个 Skill 能自动修复我的代码吗？
不能，它专注于定位根因，修复仍需你根据根因自行修改代码。
它和直接问AI‘为什么报错’有什么区别？
区别在于流程：直接问容易得到笼统猜测，而此 Skill 会要求你提供完整背景，并引导你按步骤分析，最终给出更可靠的根因结论。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/systematic-debugging-x-7/raw/index.md 读取 Systematic Debugging 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/systematic-debugging-x-7/raw/index.md（查看排版版本）