前言¶
做小遊戲時,工程往往落在本地編輯器或 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 上的基本信息¶
| 項 | 內容 |
|---|---|
| 名稱 | 微信小遊戲助手 |
| 座標 | @tencent-adm/weixin-minigame-helper |
| 版本 | 1.0.2 |
| 分類 | dev-programming |
| 發佈者 | 微信小遊戲團隊 |
| 評分 / 下載 | 評分 100000;下載 7176(頁面統計,以 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 助手按統一說明協助微信小遊戲工程的開發者。
注意:
- 公開頁僅概括爲「微信小遊戲開發工具包」,細粒度能力請以安裝後的
SKILL.md爲準。 requires_api_key=false只說明 SkillHub 未強制 API Key,不替代微信開放平臺賬號、AppID、開發者工具等既有要求。- 評分與下載數爲 SkillHub 展示統計,會隨時間變化;引用時以詳情頁爲準。
- 安裝腳本與 COS 地址來自 SkillHub 官方安裝文檔;在受限網絡環境執行時需允許訪問對應域名。
結尾¶
微信小遊戲助手由微信小遊戲團隊在 SkillHub 以 enterprise 形式發佈,把小遊戲開發工具鏈收斂爲一個可安裝的 Skill,便於在 Cursor 等環境裏通過同一座標 @tencent-adm/weixin-minigame-helper 接入。需要查看版本與安裝提示時,請打開 SkillHub 詳情頁:https://www.skillhub.cn/skills/tencent-adm/weixin-minigame-helper。