前言¶

做小游戏时，工程往往落在本地编辑器或 AI 助手里，而编译、预览、真机验证和发布又依赖微信侧工具链。两边来回切上下文，对话里也很难稳定复现「下一步该跑哪条命令、改哪份配置」。SkillHub 上的 微信小游戏助手（@tencent-adm/weixin-minigame-helper）把这一套能力打包成通用 Skill，让支持 Skill 协议的 AI 编程助手按同一套说明安装和调用。下面介绍它是什么、如何安装，以及使用时需要留意的边界。

这是什么¶

微信小游戏助手在 SkillHub 上的简介为「微信小游戏开发工具包」。坐标为 @tencent-adm/weixin-minigame-helper，当前页面标注版本 v1.0.2，分类 dev-programming，来源为 enterprise，发布者为 微信小游戏团队。Skill 采用常见的 SKILL.md 格式，安装后由 Agent 读取其中的步骤与约定来协助开发相关工作。

标签 requires_api_key=false，表示 SkillHub 侧未要求为该 Skill 单独配置 API Key；本地是否还要安装微信开发者工具等依赖，以安装包内 SKILL.md 的说明为准。

在 SkillHub 上的基本信息¶

Skill 详情页：https://www.skillhub.cn/skills/tencent-adm/weixin-minigame-helper
资源入口：https://api.skillhub.cn/tencent-adm/weixin-minigame-helper

安装与启用¶

官方在 SkillHub 详情页给出的做法是：让 AI 按 SkillHub 安装文档操作，并安装坐标 @tencent-adm/weixin-minigame-helper。可将下面提示词发给 Cursor、Claude Code、Windsurf 等支持 Skill 的助手：

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

若本机已安装 skillhub CLI，也可按 SkillHub 安装与优先源配置 自行执行。安装前建议确认 CLI 可用：

command -v skillhub && skillhub --version

未安装 CLI 时，文档提供一键安装脚本（完整安装或仅 CLI）：

# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。常用路径如下（摘自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Windsurf：~/.codeium/windsurf/skills/ 或项目下的 .windsurf/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

示例（将 <skills 目录> 换成上面对应路径）：

skillhub install @tencent-adm/weixin-minigame-helper --dir <skills 目录>

经过上面的步骤，重启或刷新 Agent 后，对话中即可按 SKILL.md 的指引使用该 Skill。各客户端对 Skill 的加载方式略有差异，以你所用产品的文档为准。

典型用法¶

在尚未手工配置 CLI 时，最省事的方式仍是使用 SkillHub 页面提供的安装提示词：由 AI 读取 https://skillhub.cn/install/skillhub.md，再把 @tencent-adm/weixin-minigame-helper 装到正确的 skills 目录。

安装完成后，具体能做什么（例如调试、预览、上传等子步骤）以 Skill 包内 SKILL.md 及微信小游戏官方工具文档为准；本文不展开未在 SkillHub 公开页列出的能力清单，避免与版本迭代不一致。

适用场景与注意¶

适合谁：已在用 SkillHub 或 skillhub CLI 管理 Skill、并希望由 AI 助手按统一说明协助微信小游戏工程的开发者。

注意：

1. 公开页仅概括为「微信小游戏开发工具包」，细粒度能力请以安装后的 SKILL.md 为准。
2. requires_api_key=false 只说明 SkillHub 未强制 API Key，不替代微信开放平台账号、AppID、开发者工具等既有要求。
3. 评分与下载数为 SkillHub 展示统计，会随时间变化；引用时以详情页为准。
4. 安装脚本与 COS 地址来自 SkillHub 官方安装文档；在受限网络环境执行时需允许访问对应域名。

结尾¶

微信小游戏助手由微信小游戏团队在 SkillHub 以 enterprise 形式发布，把小游戏开发工具链收敛为一个可安装的 Skill，便于在 Cursor 等环境里通过同一坐标 @tencent-adm/weixin-minigame-helper 接入。需要查看版本与安装提示时，请打开 SkillHub 详情页：https://www.skillhub.cn/skills/tencent-adm/weixin-minigame-helper。