Menu
小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。
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 深度排查。
小程序/小游戏云开发操作：云环境、云函数部署、云数据库、云存储。 用户提到云环境、云函数、集合/文档、云存储上传下载时使用。
排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。
初始化微信开发者工具环境：打开/关闭项目窗口、扫码登录、获取 AppID、读取运行时上下文。 用户说打开项目、接管项目、登录、有哪些 AppID、退出开发者工具时使用。不负责自动化、预览或云操作。
小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。
| name | compiler |
| description | 小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。 |
区分「让模拟器跑起来看效果」与「校验局部文件编译产物」。
小游戏：以 simulator_refresh 为主。
compile_wxml / compile_wxss：仅适用于小程序页面模板与样式，不要用于小游戏工程。
| 意图 | 工具 |
|---|---|
| 编到某页看效果 | simulator_open_page |
| 刷新/等同工具栏编译 | simulator_refresh（成功只表示已触发，≠编译通过） |
| 校验 WXML（仅小程序） | compile_wxml |
| 校验 WXSS（仅小程序） | compile_wxss |
| 构建 npm | build_npm（主归属本 scene） |
wechatide -c <clientName> simulator_open_page --project <project> --page pages/index/index [--query id=1]
wechatide -c <clientName> simulator_refresh --project <project>
wechatide -c <clientName> build_npm --project <project> [--compile-type miniprogram]
参数细节：--help / tools.yaml。需要开窗时先走 initializer。小游戏构建 npm 时按项目类型传合适的 --compile-type。
simulator_open_page / simulator_refresh 成功 ≠ 整包或单文件编译通过build_npm 会改本地产物，排查时不要默认执行| 情况 | 处理 |
|---|---|
| 窗口未开 / 开窗类错误 | 经 initializer open_project_window；PROJECT_* 见 project-tool-error-guide.md |
simulator_refresh 成功但仍异常 | 用 debugger 取 console/截图；勿连续无差别刷新 |
对小游戏调用 compile_wxml/compile_wxss | 停止并改用 simulator_refresh / build_npm |
build_npm 失败 | 原样报告依赖/产物错误；勿在未要求时反复构建 |
| 目标 | 还需 |
|---|---|
| automator | 已打开的页面路径、待验证点 |
| debugger | 编译后现象、目标页、是否已 refresh |
| previewer | project；可不经模拟器直接预览 |