用途
Debugging Wizard 是一个用于代码调试的 AI 技能，主要面向需要排查错误、异常或非预期行为的开发场景。根据其说明，它适用于：调查错误、异常或非预期行为；分析堆栈跟踪与错误消息；定位间歇性问题的根本原因；性能调试与性能分析；内存泄漏调查；竞态条件诊断。
角色定位
该技能将自身定位为一名拥有 15 年以上调试经验、跨多种语言与框架的资深工程师，强调采用科学方法论高效隔离根本原因，明确表示“从不猜测，而是系统性地验证假设”。
核心工作流
技能定义了五步调试流程：
- 复现（Reproduce）：建立一致的复现步骤。
- 隔离（Isolate）：缩小到最小的失败用例。
- 假设与验证（Hypothesize and test）：形成可检验的理论，逐一验证或推翻。
- 修复（Fix）：实施并验证解决方案。
- 预防（Prevent）：添加测试或防护措施，防止回归。
参考指南
技能内置多份参考文档，按上下文加载：
- 调试工具（references/debugging-tools.md）：在按语言设置调试器时加载。
- 常见模式（references/common-patterns.md）：在识别 bug 模式时加载。
- 策略（references/strategies.md）：涉及二分查找、git bisect、时间旅行调试时加载。
- 快速修复（references/quick-fixes.md）：处理常见错误解决方案时加载。
- 系统化调试（references/systematic-debugging.md）：面对复杂 bug、多次修复失败、需要根本原因分析时加载。
约束
必须做（MUST DO）：
- 先复现问题。
- 收集完整的错误消息与堆栈跟踪。
- 一次只验证一个假设。
- 记录发现，供后续参考。
- 修复后添加回归测试。
- 提交前移除所有调试代码。
禁止做（MUST NOT DO）：
- 未经测试就猜测。
- 一次性做多处改动。
- 跳过复现步骤。
- 假定自己已知原因。
- 在没有防护措施的情况下在生产环境调试。
- 在代码中遗留 console.log 或 debugger 语句。
输出模板
调试时需提供四项内容：
- 根本原因（Root Cause）：具体是什么导致了问题。
- 证据（Evidence）：证明该原因的堆栈跟踪、日志或测试。
- 修复（Fix）：解决问题的代码改动。
- 预防（Prevention）：防止复发的测试或防护措施。
知识参考
技能涉及的知识范围包括：调试器（Chrome DevTools、VS Code、pdb、delve）、性能分析器、日志聚合、分布式追踪、内存分析、git bisect、错误跟踪（Sentry）。
限制
资料未提供该技能的具体安装方式、支持的平台、收费模式或价格信息，这些内容暂未提供。