Menu
初始化 微信开发者工具 开发环境与基础信息。用于项目窗口打开或接管、登录信息获取、AppID 信息获取以及运行时上下文读取。
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
微信开发者工具 任务执行的根入口。用于在执行前先完成环境检查，再路由到预览、自动化、调试与云相关操作。
负责页面操作：点击、输入、滚动、截图、验证。
负责云操作：云环境、云函数、云数据库、云存储。
负责编译：项目编译、单文件编译、编译到指定页面、构建 npm、刷新模拟器。
负责排查：查日志、查运行时、定位问题原因，也包括模拟器相关的状态检查与刷新。
负责预览和发布：推送手机预览、生成预览码、真机预览、上传代码包。
| name | initializer |
| description | 初始化 微信开发者工具 开发环境与基础信息。用于项目窗口打开或接管、登录信息获取、AppID 信息获取以及运行时上下文读取。 |
这个 scene 用来完成开发前的基础初始化，不负责后续自动化、调试、预览或云操作本身。
适合场景：
读取 微信开发者工具 当前登录态、openid 和当前运行的 skill 版本号；传入当前调用侧 agent 加载的 skill.yaml version 字段值时，会检查两者是否匹配。通过 skill-cli 调用时，如果 微信开发者工具 MCP 服务未启动或当前 client 尚未授权，CLI 会使用同一个 <clientName> 自动执行一次 auth 并重试。会话开始时调用一次，确认返回内容中有 openid 且无 warning 后不必重复调用。
wechatide -c <clientName> -t check_devtools_status --skill-version <skillVersionFromSkillYaml>
其中 <skillVersionFromSkillYaml> 不是固定字符串；调用前应读取当前调用侧 agent 加载的 miniprogram-dev-skill/skill.yaml，取该文件顶层 version 字段的值填入。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
version | string | 否 | 当前调用侧 agent 加载的 miniprogram-dev-skill/skill.yaml 文件中的 version 字段值；不传则跳过版本对比提醒 |
打开微信开发者工具并显示扫码登录二维码，等待用户扫码完成登录。
wechatide -c <clientName> -t scan_login
无参数。
打开包含模拟器的项目窗口，自动导入到项目列表（如尚未导入）。
⚠️ 必须先执行前置检查，不得直接调用：
<project>/project.config.json 文件内容appid 字段存在且不为空（"" 和 "touristappid" 视为无效）appid 属性预检触发 微信开发者工具 请求链路的 token 刷新与重试project.config.json 不存在或 appid 无效：
get_user_appids 获取可用 AppIDproject.config.json（参考 miniprogram-tools/references/open-project-window-guide.md）open_project_windowwechatide -c <clientName> -t open_project_window --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
关闭包含模拟器的项目窗口，不等于关闭整个 DevTools。
wechatide -c <clientName> -t close_project_window --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
关闭 DevTools。
wechatide -c <clientName> -t quit
无参数。
获取当前登录用户可管理的全部 AppID 列表。
wechatide -c <clientName> -t get_user_appids
无参数。
读取 微信开发者工具 当前项目窗口和运行时基础状态（pageStack、currentPage、systemInfo）。
wechatide -c <clientName> -t automation_runtime_info --project <project> --action currentPage
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
action | string | 是 | pageStack、currentPage、systemInfo |
读取当前项目设置。
wechatide -c <clientName> -t project_setting_get --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
更新项目设置，修改后即时生效并写入项目配置。
wechatide -c <clientName> -t project_setting_update --project <project> --settings-file ./settings.json
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
settings | object | 是 | 要更新的设置键值对；CLI 使用 --settings-file 传递 JSON 文件 |
构建项目 npm 依赖产物，会修改本地构建结果。
wechatide -c <clientName> -t buildnpm --project <project> [--compile-type miniprogram]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project | string | 是 | 项目本地绝对路径 |
compile-type | string | 否 | 编译类型：miniprogram（默认）或 plugin |
| 用户意图 | 选择 |
|---|---|
| "先把项目打开" / "接管当前项目" | 先读取 project.config.json 确认 appid 有效 → open_project_window |
| "看看现在登没登录" | check_devtools_status |
| "需要主动登录" | scan_login |
| "关闭项目窗口" | close_project_window |
| "退出 微信开发者工具" | quit |
| "帮我看看这个项目的 AppID" | get_user_appids |
| "当前页面是什么" | automation_runtime_info（action: currentPage） |
| "看看项目设置" | project_setting_get |
| "改一下项目设置" | project_setting_update |
| "构建 npm" | buildnpm |
只有在登录态、项目路径以及目标 scene 所需关键信息已经明确时，才给出 nextScene。移交时不要让下一个 scene 重新判断初始化问题；把已确认的信息放到 handoffContext。
| 目标 scene | 适用目标 | 移交前必须带上的信息 |
|---|---|---|
automator | 点击、输入、滚动、截图、页面断言 | projectPath、当前页面或目标页面、关键选择器或待验证结果 |
debugger | console/network/运行态/模拟器状态排查 | projectPath、currentPage、已观察到的异常、可复现步骤或日志关键字 |
compiler | 编译到页面、单文件编译、构建 npm、刷新模拟器 | projectPath、目标页面或目标文件、编译参数、是否需要构建 npm |
previewer | 推送手机预览、生成二维码、上传体验版 | projectPath、预览方式、上传版本信息或二维码输出诉求 |
cloudbase-operator | 查询云环境、云函数列表、部署或增量部署云函数 | projectPath 或 appid、目标 env、函数目录；增量部署需带 appid、云函数目录和相对变更文件或目录 |
如果用户目标同时覆盖多个 scene，先只移交给当前最直接能完成目标的 scene；后续 scene 由任务结果自然触发，不在 initializer 中提前串联多步计划。