菜单
小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
微信开发者工具任务根入口。先完成环境与登录检查，再路由到创建项目、初始化、项目管理、项目配置、 编译、预览、页面自动化、调试或云开发操作。适用于小程序与小游戏。用户提到微信开发者工具、 小程序/小游戏模拟器、新建项目、预览上传、自动化点击、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；可不经模拟器直接预览 |