SuperAPI AI 工具集

debug-tool

测试与质量

查看项目

更新于 10-16 07:14

技能介绍

用途:调试出现异常或不可用的 MCP 工具,系统性地追踪完整请求生命周期以定位问题,参数以 $ARGUMENTS 传入,要求不靠猜测。

主要能力:按四个阶段排查。阶段一识别受影响的工具、预期行为与实际行为(报错、数据错误、空响应、崩溃)。阶段二逐层追踪:工具 Schema(src/tools/<category>/<tool>.ts)中名称是否与 index.ts 的路由名一致、inputSchema 是否与 handler 实际读取的 args 匹配、必填字段与枚举值是否完整;Handler 逻辑中 getApiKey(args) 调用、参数校验、类型转换(String()、Number())与 params 传递;endpoints.ts 中的 URL 模式(/api/mcp/${projectId}/...)、查询参数构造、projectId 是否在拼接查询串前被解构;request.ts 中的 HTTP 方法、Content-Type: application/json、Authorization 头、POST/PATCH 的 body 是否 JSON.stringify;响应处理中是否检查 response.ok、失败时是否读取错误文本、返回值是否 JSON.stringify。阶段三通过阅读代码、与同类别可用工具对比、核对 API 文档来隔离可疑层。阶段四修复根因、运行 npm run typecheck && npm run lint、若行为或参数变更则更新 docs/TOOLS.md、并移除临时 console.error。

常见问题参考:Unknown tool 检查工具未加入 tools 数组或 index.ts 缺路由;Missing PAT 检查 getApiKey 是否收到 args 或环境变量;404 检查 endpoints.ts URL 与 projectId 位置;空响应检查包装结构;错误数据检查查询参数;类型错误检查 .js 导入或参数类型;启动崩溃检查循环导入或顶层 await。

限制:技能要求逐层追踪、与可用工具对比、只修根因而非症状,提交前清除调试日志;其余细节暂未提供。