SuperAPI AI 工具集

debugging-wizard

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

用途:Debugging Wizard 是一个系统化调试技能,面向任意代码库,帮助解析错误信息、跟踪堆栈调用流程、关联日志条目以定位故障点,并按假设驱动方式隔离和解决问题。

核心工作流:1)复现,建立稳定的复现步骤;2)隔离,缩小到最小失败用例;3)假设与验证,形成可测试的推断并逐一验证或推翻;4)修复,实施并验证解决方案;5)预防,补充测试或保护措施防止回归。

参考指南按其说明按需加载:调试工具(references/debugging-tools.md,用于按语言配置调试器)、常见模式(references/common-patterns.md,识别缺陷模式)、策略(references/strategies.md,二分查找、git bisect、时间旅行)、快速修复(references/quick-fixes.md,常见错误解决)、系统化调试(references/systematic-debugging.md,复杂缺陷、多次修复失败、根因分析)。

约束方面:必须先复现问题,收集完整错误信息和堆栈;一次只验证一个假设;记录发现;修复后添加回归测试;提交前移除所有调试代码。不得未经测试猜测、一次做多处修改、跳过复现、假定已知原因、无保护措施在生产环境调试,或在代码中遗留 console.log/debugger 语句。

常用命令:Python 使用 python -m pdb script.py;Node.js 使用 node --inspect-brk script.js 并配合 Chrome DevTools;回归定位使用 git bisect start、git bisect bad、git bisect good v1.2.0、git bisect reset;Go 使用 dlv debug ./cmd/server。

输出模板建议给出根因、证据、修复和预防四部分。文档部分提到该技能属于 AIX skill pack,用户侧别名为 aix-debugging-wizard,生成产物应写入 .aix/ 目录,写入前用 mkdir -p .aix 确保目录存在,生成文件默认可被覆盖,除非明确要求否则不要写入项目根目录。具体收费、价格、平台支持和实际效果暂未提供。