SuperAPI AI 工具集

debug

测试与质量

查看项目

更新于 10-16 08:39

技能介绍

用途:调试 React Native 应用,查看控制台日志、JS 错误、Metro 状态,求值表达式,检查 React 组件树,监控网络请求与 HMR 事件。

主要能力:metro.sh 负责 Metro 健康检查、bundle 校验与堆栈符号化;logs.sh 做 OS 级 JS 控制台日志捕获(iOS/Android,无需 Metro);cdp-bridge.js 提供 CDP WebSocket 桥接,支持 console、eval、tree、network;hmr.sh 监控 HMR 事件。

使用方式:先做预检,运行 ${CLAUDE_SKILL_DIR}/../_shared/scripts/metro.sh status、xcrun simctl list devices booted,以及 metro.sh targets(返回可调试 CDP 页面 JSON 数组)。CDP 功能需 Metro 运行且应用已连接;Metro 未运行时控制台日志回退到 logs.sh。求值用 cdp-bridge.js eval "expr";组件树用 tree [--find "ComponentName"] [--depth N];网络用 network;HMR 用 hmr.sh monitor。控制台流、组件树、网络日志体积大,需派发子代理处理。

适用场景:排查 JS 错误与警告、检查组件层级与 props/state、观察 API 请求与失败状态码、跟踪热更新。

限制:CDP 功能依赖 Metro 运行且应用连接;tree 需应用运行在 dev 模式(非 dev 构建会剥离 React DevTools hook);cdp-bridge.js 与 hmr.sh 需 Node 22+;端口解析顺序为 --port > RCT_METRO_PORT > 默认 8081。Expo SDK 54+ 已测试。Metro HTTP API 细节见 references/metro-endpoints.md。收费、价格等信息暂未提供。