Menu
小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。
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、模拟器没刷新时使用。
排查小程序/小游戏运行问题：console/network 日志、模拟器截图、运行时状态、wx API 诊断、清缓存。 用户提到报错日志、接口失败、截图取证、模拟器卡住时使用。
初始化微信开发者工具环境：打开/关闭项目窗口、扫码登录、获取 AppID、读取运行时上下文。 用户说打开项目、接管项目、登录、有哪些 AppID、退出开发者工具时使用。不负责自动化、预览或云操作。
| name | previewer |
| description | 小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。 |
预览与上传。默认预览工具是 auto_preview。无需先 open_project_window。
| 意图 | 工具 |
|---|---|
| 预览 / 发到手机 / 真机预览 / 自动预览 | auto_preview（必填 project；用户指定页面时可加 --page-path / --query / --scene） |
| 要二维码 / 扫码预览 | create_preview_qrcode（优先 --qr-format window） |
| 上传代码 / 发布体验版（须用户明确要求） | upload |
wechatide -c <clientName> auto_preview --project <project>
wechatide -c <clientName> auto_preview --project <project> --page-path pages/index/index --query id=1
wechatide -c <clientName> create_preview_qrcode --project <project> --qr-format window
wechatide -c <clientName> upload --project <project> --upload-version 1.0.0 [--desc "备注"]
注意：upload 的 schema 字段名是 version，CLI flag 是 --upload-version（不是 --version）。
auto_preview 不要传本地输出路径类参数；需要落地二维码/信息文件时用 create_preview_qrcode。
upload 仅在用户明确要求时调用| 情况 | 处理 |
|---|---|
PROJECT_* / APPID_ERROR | project-tool-error-guide.md |
| 上传需确认 / User denied | 停等用户；拒绝后不要自动再 upload |
| 预览/上传权限或账号问题 | 说明需开发者权限或重新 login；勿死循环重试 |
| 超时 | 原样报告；可问用户是否重试一次，勿静默连打 |
| 目标 | 还需 |
|---|---|
| debugger | 预览失败现象、project、相关 page-path |
| compiler | 需先在模拟器验证时：说明要开窗 + 目标页 |
| 结束 | 预览/上传结果摘要 |