Agent Skills
返回列表
微信小游戏助手

微信小游戏助手

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/weixin-minigame-helper。

技能介绍

解决什么问题

微信小游戏开发里，AI 助手通常要调用 MCP 才能跑 run_game、看日志或执行小游戏工具。真正卡住人的不是写代码，而是环境碎片化：Node 版本不足、MCP 包未安装、不同 AI host 的 mcp.json 路径不一致，以及配置存在但当前助手并没有读到。尤其是多 Agent、多配置目录并存时，排查成本会明显上升。这个 Skill 把这些前置检查收敛成一套可执行流程。

技能如何工作

它不绑定特定 IDE 插件，只依赖 Node.js ≥ 18 和 @weadmin/weixin-minigame-helper-mcp。核心步骤是：先直接尝试调用 MCP；失败后再用 scripts/ 检查 Node、包解析、配置候选与 recommendedAction。它把判断依据集中在脚本输出的 JSON 字段上，便于 AI 助手按分支处理，而不是把所有源码读入上下文。对明确的 host 信号可自动安装或配置；对弱信号或无法确认的 host，会返回 manualSnippet，让助手把 JSON 片段交给用户手动粘贴，而不是猜测路径。

适用边界与注意点

它属于 MCP-only 流程，不会用 shell 预览绕过 MCP。vscode 弱信号不代表 vanilla VSCode，也可能是 Cursor、Windsurf、CodeBuddy 或内部变体；遇到 targetHostCaveat、ask-user 时，应以手动粘贴为准。若 MCP 包能启动但当前助手仍调用失败，通常说明配置路径、传输方式或 host 变体不一致。配置写入后应直接验证并调用工具，不把“重启编辑器”作为常规建议。

使用场景

  • 在 Cursor 或 CodeBuddy 里打开微信小游戏工程，先确认 MCP 是否可用，再调用 run_game 启动预览。
  • 当 AI 助手报 MCP 工具不存在时，按 Node、包安装、mcp.json 配置逐项排查，避免反复重启 IDE。
  • 在多 Agent 环境里无法判断该写哪个 mcp.json 时，把 manualSnippet 交给用户粘贴到对应配置。
  • 本地 npm registry 慢导致 MCP 初始化超时时，用 verify 阶段输出定位 timeout 并预热包后重试。

适合人员

  • 在 Cursor 或 CodeBuddy 里开发微信小游戏的工程师，需要让 AI 助手稳定调用 MCP 跑预览。
  • 维护多 AI Agent 的团队成员，想减少 mcp.json 配错目录导致的连接失败。
  • 需要排查 Node 版本、MCP 包安装和服务启动失败的微信小程序开发者。
  • 给前端团队写开发规范的架构师，希望把 MCP 环境检查写成可复制的排障流程。