SuperAPI AI 工具集

debug-investigator

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:把随意试探式调试替换为假设驱动的系统化调查,适用于间歇性失败、无清晰堆栈、性能回退、需 git bisect 或假设排序的非显而易见缺陷;清晰堆栈和明显错误由基础模型原生处理即可。

主要能力:分七阶段工作流——症状记录(现象、预期、可复现性、起始时间、环境);构建快速确定性的通过/失败反馈回路(失败测试、CLI/脚本、curl、浏览器自动化、重放 trace/HAR/日志、临时 harness、属性/模糊/压力循环、git bisect run);证据分析(自下而上读堆栈、日志模式与时间线、状态检查、git diff);生成 3-5 条按可能性排序的假设,每条含支持证据、确认测试与反驳测试;制定调查计划(先测 H1、二分、隔离变量、埋点);执行时一次只改一个变量并记录死路;最后输出根因、修复、预防与经验。

参考文件按需加载:stacktrace-patterns.md、hypothesis-templates.md、bisection-guide.md、log-analysis.md、instrumentation-points.md。

使用方式:先检查仓库内 docs/agents/domain.md、CONTEXT.md、docs/adr/ 等上下文;按 quick/standard/deep 三种范围模式选择深度。二分命令示例:git bisect start <bad> <good>。

限制与前提:需要 git、源码访问权限、可复现环境或至少错误输出;无法调试不透明二进制。若无法建立可信反馈回路,应停止并索取缺失材料,而非做推测性修复。错误信息已含修复、已知环境配置问题、实为功能请求、第三方不可控代码、生成/压缩代码等情况不建议调查。