SuperAPI AI 工具集

tools-debugging-root-cause

测试与质量

查看项目

更新于 10-16 06:42

技能介绍

用途:针对在深层调用栈、worker 或异步任务中才暴露的 bug,沿调用链向上回溯,找到错误值的真正来源,而不是只修补表面症状。

主要能力:提供回溯流程(观察症状、定位直接原因、追问调用者、检查参数与状态、继续向上、在源头修复);建议在可疑操作前插桩,用 new Error().stack 捕获完整调用链并打印目录、环境变量等上下文,在测试中用 console.error 并配合 npm test 2>&1 | grep 'DEBUG git init' 过滤;提供查找污染测试的思路与脚本 ./find-polluter.sh '.git' 'src/**/*.test.ts';在修复源头后按层加固(入口校验、中间层检查、环境守卫、保留轻量插桩)。

使用方式:按决策流判断 bug 是否可回溯;若可回溯则执行回溯流程并在最早出错点修复,再补充防御;若无法回溯,可临时修症状作为最后手段。

适用场景:堆栈冗长或信息不足、无法判断无效数据来源、不同测试或运行间行为不一致、怀疑 setup 或 beforeEach 等早期代码埋下坏状态。

限制与验证:不要只改症状;修复后需确认症状消失、补充校验、重跑完整测试套件以防回归;临时插桩应加门控或确认后移除。其他细节暂未提供。