Menú
排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
微信开发者工具任务根入口。先完成环境与登录检查，再路由到创建项目、初始化、项目管理、项目配置、 编译、预览、页面自动化、调试或云开发操作。适用于小程序与小游戏。用户提到微信开发者工具、 小程序/小游戏模拟器、新建项目、预览上传、自动化点击、console/network、云函数/云数据库时使用。
小程序/小游戏页面自动化：点击、输入、滚动、导航、断言、生成 automator 脚本。 用户要点按钮、填表、页面验证、自动化测试时使用。不负责 console/network 深度排查。
小程序/小游戏云开发操作：云环境、云函数部署、云数据库、云存储。 用户提到云环境、云函数、集合/文档、云存储上传下载时使用。
小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。
初始化微信开发者工具环境：打开/关闭项目窗口、扫码登录、获取 AppID、读取运行时上下文。 用户说打开项目、接管项目、登录、有哪些 AppID、退出开发者工具时使用。不负责自动化、预览或云操作。
小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。
| name | debugger |
| description | 排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。 |
采集最小证据集，归因并给出下一步。默认优先只读诊断。
automation_runtime_info；主归属 initializer，此处只读）likelyCause + recoveryPath + nextActionssimulator_refresh（主归属 compiler，成功≠编译通过）| 意图 | 工具 |
|---|---|
| console | get_simulator_console（command 必须是 grep，如 grep -i error；全量用 grep -n .） |
| network | get_simulator_network（同上） |
| 模拟器 UI 截图 | simulator_screenshot（主归属本 scene；优先 waitForSelector） |
| 当前页/页栈 | automation_runtime_info |
| wx API 诊断/mock | automation_wx_api（主归属本 scene） |
| 清缓存 | debug_clear_cache |
| 刷新模拟器 | simulator_refresh（主归属 compiler） |
wechatide -c <clientName> get_simulator_console --project <project> --command "grep -i error"
wechatide -c <clientName> simulator_screenshot --project <project> --wait-for-selector .submit-btn
注意：command 不要传 "all"；返回空字符串=无匹配行，≠ console 为空。
runtime-exception | network-failure | preview-blocked | automation-mismatch | environment-not-ready | simulator-state-error
summary / issueClass / symptom / evidence / likelyCause / recoveryPath / nextActions
simulator_refreshquitautomation_viewport_action；本 scene 截图用于诊断取证| 情况 | 处理 |
|---|---|
窗口未开 / PROJECT_* | initializer；project-tool-error-guide.md |
| grep 结果为空 | 说明无匹配行；可放宽 pattern 或改用 grep -n .，≠「没有日志系统」 |
| 截图失败 | 确认窗口已开与 selector；勿与 automator screenshot 混用重试 |
| 清缓存后仍异常 | 记入 evidence；移交 compiler 或说明需用户手动确认 |
| 目标 | 还需 |
|---|---|
| automator | 复现步骤、稳定 selector、issueClass |
| compiler | 需 refresh/simulator_open_page 的路径 |
| previewer | 若属预览阻断：project + 现象 |
| 结束 | 完整诊断输出字段 |