前言¶
做微信小程序時，難點往往不在「會不會寫頁面」，而在微信生態裏的約束：appid 與主體資質、原生與跨端框架怎麼選、雲開發和自建後端如何分工、wx.login 與 session 怎麼接、支付與訂閱消息的接入路徑，以及提審被駁回後該改哪裏。通用 Web 開發的經驗不能直接照搬，查官方文檔又容易在多個主題之間來回跳。
下面介紹 SkillHub 上的「微信小程序開發助手」，它把上述環節收斂成可在 AI 對話裏逐步推進的指導，專攻微信側特殊性，而不是泛泛的前端教程。
這是什麼¶
「微信小程序開發助手」是 SkillHub 社區來源（community）的 Agent Skill，座標爲 @user_36c7efa2/wechat-miniapp-zh，當前版本 1.0.0，分類爲 dev-programming，由發佈者 user_36c7efa2 維護。
官方簡介將其定位爲微信小程序開發的全流程助手：從 appid 申請、原生 / Taro / uni-app 選型、雲開發 / 自建後端選型，到登錄鑑權、支付、訂閱消息、審覈避坑；並強調與通用 Web 開發的區別，聚焦微信生態特殊性。頁面標註 requires_api_key=false，安裝使用不依賴額外 API Key。
在 SkillHub 上，該 Skill 評分 100000，累計下載 17459 次（截至頁面展示數據）。
核心功能¶
依據官方簡介與 SkillHub 頁面說明，可覈實的能力範圍如下。
- 准入與選型：appid 申請相關指引；原生、Taro、uni-app 等技術路線對比與選型建議；雲開發與自建後端的取捨。
- 關鍵業務鏈路：登錄鑑權、微信支付、訂閱消息等常見接入問題的結構化說明（具體 API 與配置以微信官方文檔爲準，Skill 負責在對話中對齊步驟與注意點）。
- 上線與合規：審覈避坑、微信側規則與通用 Web 差異，減少因生態特殊性導致的返工。
Skill 本體遵循通用 SKILL.md 格式，由支持 Skills 的 AI 客戶端在匹配到小程序相關意圖時加載，在編碼與方案討論中提供上下文化的回答。
安裝與啓用¶
方式一：讓 AI 按 SkillHub 安裝文檔執行¶
SkillHub 技能頁給出的提示詞爲：請 AI 根據 SkillHub 安裝說明 安裝 @user_36c7efa2/wechat-miniapp-zh。適用於 Cursor、Claude Code、Codex 等已支持 Skill 的客戶端，由 Agent 讀取安裝文檔並完成落盤。
方式二：使用 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 文檔執行完整安裝（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/ 可能不會被客戶端識別。示例：
skillhub install user_36c7efa2/wechat-miniapp-zh --dir <skills 目錄>
常用客戶端 skills 目錄（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按所用客戶端要求刷新或重啓，使新 Skill 生效。
典型用法¶
官方頁面未附帶獨立代碼倉庫示例；典型用法是對話驅動，在已啓用 Skill 的項目或全局 skills 目錄下，用自然語言描述當前階段的問題。下列表述與官方簡介中的主題一致，便於觸發 Skill 上下文：
- 新建項目前：說明團隊棧偏好，詢問「原生、Taro、uni-app 如何選型」或「雲開發和自建後端怎麼選」。
- 接入能力時：直接提具體目標，例如「小程序登錄鑑權怎麼接」「支付流程要準備哪些參數」「訂閱消息模板與下發注意什麼」。
- 提審前：描述類目與功能點，詢問「審覈容易踩的坑」或對照簡介中的「審覈避坑」逐項覈對。
經過上面的步驟，AI 會按 Skill 內嵌的流程與微信生態約束組織回答；涉及密鑰、商戶號、證書等敏感信息時，仍應在本地配置與環境變量中管理，不要寫入對話或倉庫。
適用場景與注意¶
適合誰：正在做或準備做微信小程序的開發者、技術負責人，需要在選型、架構和關鍵 API 之間快速對齊，並希望在提審前減少明顯違規項。
限制與注意：
- 內容來源爲社區 Skill，微信官方政策與接口以 微信公衆平臺文檔 爲準；上線前務必自行覈對最新規則。
- SkillHub 頁面顯示安裝計數爲 0，與下載量分開統計；是否已裝入本機以你本地 skills 目錄爲準。
- 未要求 API Key，但不替代微信側的真實賬號、支付商戶資質與服務器域名配置。
結尾¶
「微信小程序開發助手」把 appid、跨端選型、後端形態、登錄支付訂閱與審覈避坑串成一條可對話推進的路徑，適合作爲微信生態專項的補充知識源。官方 Skill 頁與 API 入口：
- https://www.skillhub.cn/skills/user_36c7efa2/wechat-miniapp-zh
- https://api.skillhub.cn/user_36c7efa2/wechat-miniapp-zh
