SuperAPI AI 工具集

debugging

编程与开发

查看项目

更新于 11-13 11:54

技能介绍

调试技能是一份用于指导调试过程的技能文档,重点采用定向日志注入与运行时分析的方式定位问题。

用途与启用时机

该技能建议在用户描述以下情况时激活:某个功能不工作;执行某操作时出现某个错误;某次改动后出现问题;出现静默失败或异常行为。

日志格式

日志遵循统一格式:console.log("[DEBUG] [file:line] description", { values })。其中 [DEBUG] 作为前缀,便于用 grep 检索和后续清理;[file:line] 标明位置,便于跳转导航;description 说明这条日志检查什么;{ values } 输出相关数据,但不得包含敏感信息。

日志模式示例

React/Next.js 场景覆盖生命周期挂载、副作用运行与清理、setState 之前的状态快照。Node.js/Express 场景覆盖请求信息与捕获到的错误名称和消息。API 调用场景覆盖请求开始时的 URL 与方法,以及完成后的状态码与成功标志。

常见缺陷模式

文档给出对照表:空值访问对应“Cannot read property X of undefined”,检查可选链与默认值;竞态条件表现为时好时坏,检查异步顺序与状态时机;闭包过期表现为回调中使用旧值,检查 useCallback 依赖与事件绑定;接口数据不匹配表现为数据不显示,检查响应结构与空值处理;静默错误表现为什么都不发生,检查空的 catch 块与缺失的错误状态。

置信度评分

结论按置信度分级:70 分及以上表示证据明确,作为可能原因报告;50 至 69 分表示有可能,建议增加日志确认;低于 50 分属于推测,不作报告。

清理方式

调试结束后,所有 [DEBUG] 日志会自动移除。也可手动检查,命令为:grep -rn '[DEBUG]' . --include='.ts' --include='.tsx' --include='.js' --include='.jsx'。

MCP 集成

资料提到可集成的 MCP 工具:Console Ninja 提供运行时值、测试状态与覆盖率;Chrome DevTools 提供网络检查、浏览器控制台与 DOM 状态。

适用场景与限制

该技能适用于前端组件调试、Node.js 服务端问题排查和 API 交互问题定位,以日志证据和置信度判断代替无根据猜测。资料未说明具体安装命令、收费方式、支持平台范围或自动清理的实现机制,这些内容暂未提供。