메뉴
小程序/小游戏预览与发布：自动推送手机预览、生成预览二维码、上传体验版。 用户说预览、发到手机、扫码预览、上传代码、发布体验版时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
微信开发者工具任务根入口。先完成环境与登录检查，再路由到创建项目、初始化、项目管理、项目配置、 编译、预览、页面自动化、调试或云开发操作。适用于小程序与小游戏。用户提到微信开发者工具、 小程序/小游戏模拟器、新建项目、预览上传、自动化点击、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 | 需先在模拟器验证时：说明要开窗 + 目标页 |
| 结束 | 预览/上传结果摘要 |