Menu
排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
微信开发者工具任务根入口。先完成环境与登录检查，再路由到创建项目、初始化、项目管理、项目配置、 编译、预览、页面自动化、调试或云开发操作。适用于小程序与小游戏。用户提到微信开发者工具、 小程序/小游戏模拟器、新建项目、预览上传、自动化点击、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 + 现象 |
| 结束 | 完整诊断输出字段 |