前言¶
微信小程序和通用 Web 前端不是同一套約束：包體要卡在分包與 2MB 規則裏，登錄與支付要走微信開放能力，雲開發、訂閱消息、內容安全各有獨立文檔。平時靠搜索引擎拼片段，容易踩到已廢棄的 API，或在分包、鑑權細節上反覆試錯。
下面介紹 SkillHub 上的 Wechat Miniprogram Toolkit。它把初始化、雲開發、支付、分包分析等能力收進標準 SKILL.md 與 references/ 文檔，讓 Coding Agent 按任務加載對應章節，而不是每次從零檢索官方文檔。
這是什麼¶
Wechat Miniprogram Toolkit（包名 wechat-miniprogram-toolkit，當前公開元數據版本 1.6.0，MIT 許可證）是面向微信小程序的 Agent Skill。SkillHub 分類爲 dev-programming，社區評分 93834，累計下載 1574 次（截至任務線索中的平臺統計）。
發佈路徑爲 @user_64e5b706/wechat-miniprogram-toolkit。Skill 自述整合騰訊雲側常見實踐、Skyline Worklet 規範與 CI/CD 參考，目標是從項目初始化到上線發佈的一站式指引；框架級細節仍以微信開放文檔爲準。
官方入口：
- API 地址：https://api.skillhub.cn/user_64e5b706/wechat-miniprogram-toolkit
- 社區頁面：https://www.skillhub.cn/skills/user_64e5b706/wechat-miniprogram-toolkit
核心功能¶
Skill 入口 SKILL.md 與分主題 references/*.md 覆蓋下列模塊（按官方描述整理）：
- 工程與規範：項目目錄、
project.config.json、app.json初始化（project-init.md）。 - 雲開發：數據庫、存儲、雲函數，含聚合查詢與事務（
cloud-dev.md）。 - 登錄鑑權：openid / UnionID、手機號等（
auth.md）。 - 微信支付：JSAPI、統一下單、支付通知、退款（
payment.md）。 - 直播與實時音視頻：live 組件與 TRTC 相關指引（
live-stream.md）。 - 數據與增長：數據分析、埋點（
analytics.md）；分享、海報、朋友圈（share.md）。 - TypeScript：類型與泛型封裝（
typescript.md）。 - 雲託管：容器化後端（
cloudhosting.md）。 - 消息：客服消息、訂閱消息（
messaging.md）。 - 合規與跳轉：內容安全審覈（
content-safety.md）；APP 與小程序互跳、URL Scheme（miniapp-handoff.md）。 - 端能力：藍牙、GPS、NFC、Wi-Fi、掃碼等（
hardware.md）。 - 性能與渲染：分包策略（
subpackage.md）；Skyline / Worklet（advanced-render.md）；WXS 與性能（wxs-performance.md）。 - 工程化：CI/CD（
ci-cd.md）；Python 腳本scripts/analyze_subpackages.py做分包分析；references/error-log.md記錄錯誤與進化。
Skill 聲明適用基礎庫：≥ 2.2.3（雲開發）、≥ 3.0（Skyline）。明確不適用的場景包括：Web 端微信登錄（需其他 skill）、非微信系小程序、以及強依賴非雲開發商戶後臺直連且未覆蓋的服務端形態。
安裝與啓用¶
先做安裝，再在對話裏用自然語言觸發 Skill 內文檔。公開資料給出兩種安裝方式，按你使用的工具鏈選擇其一。
方式一：SkillHub CLI（Skill 快速上手中的寫法）
skillhub install wechat-miniprogram-toolkit
未安裝 CLI 時，Skill 說明可讓 Agent 協助完成 SkillHub 環境準備。
方式二：secure-skills-cli（360 安全技能中心等鏡像頁列出的同款包）
npx secure-skills-cli add wechat-miniprogram-toolkit
安裝完成後，Agent 應讀取 Skill 根目錄的 SKILL.md，並按「寫代碼前先讀」表加載對應 references/ 文件。Cursor、Codex CLI、Claude Code 等客戶端若已支持 Skill 目錄或 SkillHub 集成，行爲一致：以本地 Skill 包爲準，無需額外配置文件（公開材料未給出各客戶端差異說明時，不單獨臆造路徑）。
典型用法¶
經過上面的安裝步驟，可以按下面幾類任務復現官方示例。
1. 從零初始化項目
對 Agent 說明需求，例如：「幫我創建一個微信小程序項目，包含雲開發、分包、登錄功能」。Agent 應參照 references/project-init.md 生成目錄與配置。
2. 上線前分包分析
在項目根目錄準備好頁面與資源後，讓 Agent 運行分包腳本。命令形如：
python scripts/analyze_subpackages.py <項目目錄> --main-max 2 --pkg-max 2
腳本會輸出可併入 app.json 的分包配置片段。
3. 雲開發 CRUD（片段示例）
Skill 文檔中的數據庫讀寫模式如下，Agent 生成業務代碼時可對照：
const db = wx.cloud.database()
await db.collection('posts').add({ data: { title: '標題', _openid, createdAt: db.serverDate() } })
await db.collection('posts').where({ _openid: wx.getStorageSync('openid') }).get()
await db.collection('posts').doc(id).update({ data: { title: '新標題' } })
await db.collection('posts').doc(id).remove()
4. 登錄與雲函數鑑權
小程序端初始化雲環境；openid 在雲函數內通過上下文獲取，避免前後端來回傳遞：
wx.cloud.init({ env: 'your-env-id', traceUser: true })
// 雲函數內：const openid = cloud.getWXContext().OPENID
5. 可選：GitHub Actions 發佈
對 Agent 說：「配置 GitHub Actions 自動發佈」，應參照 references/ci-cd.md。項目側如需上傳審覈，文檔列出可選依賴 miniprogram-ci：
npm install miniprogram-ci -D
遇到報錯時，Skill 建議先查「常見錯誤處理」表，再讀對應 reference 的 Common Mistakes，或讓 Agent「查看這個 skill 的錯誤臺賬」。
適用場景與注意¶
適合誰
- 已在用 Coding Agent 寫微信小程序，希望減少翻文檔、廢棄 API 和分包踩坑的開發者。
- 需要雲開發、支付、訂閱消息、內容安全等「多條線並行」的中大型小程序，希望 Agent 按模塊引用統一範本。
使用前準備（Skill 列出的平臺側事項）
- 微信開發者工具、小程序 AppID、雲開發環境；支付場景需商戶號；CI/CD 場景可選 GitHub 倉庫與
miniprogram-ci。 - 賬號註冊與實名認證需本人在微信公衆平臺完成，Skill 只能覆蓋代碼與配置層。
限制與坑
- 不要把 Web 登錄頁照搬到小程序；頭像暱稱應使用
chooseAvatar與type="nickname"，勿依賴已廢棄的getUserInfo/getUserProfile。 - 雲函數內環境 ID 宜用
cloud.DYNAMIC_CURRENT_ENV；小程序端wx.cloud.init需使用字符串環境 ID。 - 分包之間不要直接
require跨包組件，可用雲函數或 eventBus 解耦。 - Skill 自述的「自我進化」會寫入
error-log.md；團隊若 fork 或二次分發，需自行評審變更。
結尾¶
Wechat Miniprogram Toolkit 把微信小程序高頻能力拆成可檢索的 reference，並附帶分包分析腳本與錯誤臺賬，適合作爲 Agent 側的長期開發手冊。若你要在 SkillHub 查看詳情或安裝，可打開：https://api.skillhub.cn/user_64e5b706/wechat-miniprogram-toolkit
