前言¶

用 AI 寫微信小程序時，常見問題不是「能不能生成頁面」，而是上下文不對：把 Web 登錄流程塞進小程序、沒看 project.config.json 就建議預覽、默認 Stable 版開發者工具卻要用 Nightly 的 wechatide，或者項目並未接入雲開發卻強行套用 wx.cloud 約束。官方文檔分散在微信開放文檔、開發者工具與 CloudBase 文檔裏，Agent 一次對話很難對齊這些邊界。

下面介紹 SkillHub 上的 微信小程序開發（@tencent-adm/miniprogram-development）。它把項目結構、調試預覽發佈、消息推送與可選的雲開發集成，整理成 Agent 可遵循的 SKILL.md 與 reference，適合在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏啓用。

這是什麼¶

微信小程序開發 · WeChat Mini Program Development 是騰訊雲 CloudBase 團隊發佈的企業來源 Skill（enterprise），當前版本 2.36.0，座標 @tencent-adm/miniprogram-development，分類爲 dev-programming。頁面標註 requires_api_key=false，安裝本 Skill 本身不需要額外 API Key。

定位一句話：面向 AI 編碼場景 的微信小程序開發指南，覆蓋項目腳手架、tabBar、路由、調試、預覽、發佈與 wx.cloud 集成；並說明何時應切換到同系列的 Web 開發、雲函數、UI 設計等兄弟 Skill，避免範圍混用。

• SkillHub 展示頁：https://www.skillhub.cn/skills/tencent-adm/miniprogram-development
• 介紹入口：https://api.skillhub.cn/zcwl/miniprogram-development

核心功能¶

以下內容均來自該 Skill 的 SKILL.md 與 SkillHub 簡介，按場景歸納。

項目結構與配置¶

• 遵循 project.config.json 中的小程序根目錄、appid、miniprogramRoot 等配置。
• 頁面需具備完整文件集（含頁面 .json 配置）；引用本地資源前確認文件存在。
• tabBar：未明確要求圖標時，默認推薦 純文字自定義 tabBar（tabBar.custom = true，僅 pagePath 與 text），減少圖標資源與留白問題；需要圖標時再配置 iconPath / selectedIconPath 並落地資源文件。

構建、調試、預覽與發佈¶

• 默認工作流指向 微信開發者工具 Nightly 及 wechatide CLI（內置 Skills/MCP），用於打開項目、編譯、模擬器、控制台/網絡調試、預覽、上傳等。
• Nightly 下載說明見 SKILL 內鏈接：https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly_backup.html。
• 若環境中沒有 wechatide，Skill 要求先說明這是 環境缺口、提示需要 Nightly，並等待用戶決定是否安裝；用戶拒絕或無法安裝時，再回退到 miniprogram-ci 預覽/上傳及 CloudBase MCP 等路徑，並明確缺失的能力（如模擬器、控制台等）。
• 涉及上傳/發佈前，需結合同插件中的 Change Safety Protocol 與 Deployment Gate 協議（路徑在 SKILL 的 Sibling skills 小節中給出）。

雲開發（按需）¶

• 僅當用戶或代碼庫明確使用 CloudBase、wx.cloud、騰訊雲開發時，才應用雲開發相關約束與 reference。
• 覆蓋賬號與主體前提（個人/企業主體、測試號、雲開發入口置灰、環境不可見等）的診斷指引，以及認證、文檔庫、微信支付/虛擬支付等場景的 兄弟 Skill 路由說明。

消息推送與客服¶

• 消息推送（消息推送）、客服自動回覆等走開發者工具 IDE + wxide CLI 的當前支持路徑；客服回覆需使用 cloud.openapi.customerServiceMessage.send 及 config.json 中的 openapi 權限，不能僅靠雲函數返回值自動回覆。

搜索與推廣¶

• 小程序搜索優化、頁面收錄、搜索推廣等場景有獨立 reference（含 mpcrawler、標題與縮略圖等說明）。

明確不覆蓋的範圍¶

• 純 Web 前端 → 使用 web-development。
• 純後端服務 → 使用 cloudrun-development / cloud-functions。
• 僅 UI 設計、無小程序開發上下文 → 使用 ui-design。

安裝與啓用¶

Skill 基於通用 SKILL.md 格式。在 SkillHub 上安裝時，需把文件裝到 當前 Agent 的 skills 目錄，否則默認落到 ./skills/ 可能不會被識別。

1、安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已有 skillhub：

command -v skillhub && skillhub --version

未安裝時可執行官方完整安裝（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

說明與路徑以 https://skillhub.cn/install/skillhub.md 爲準；若文檔中的 COS 域名與上略有差異，以該頁面當前內容爲準。

2、安裝本 Skill¶

skillhub install @tencent-adm/miniprogram-development --dir <skills 目錄>

常見 Agent 的 skills 目錄（來自 skillhub.md）：

也可將下面提示詞發給 AI，讓其按 skillhub.md 完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/miniprogram-development`。

安裝後按你所用客戶端要求重啓或刷新 Skills 緩存（以各客戶端文檔爲準）。

典型用法¶

啓用 Skill 後，Agent 會按 SKILL.md 中的 Activation Contract 判斷是否進入本 Skill，並按任務類型跳轉到對應 reference。下面是可以直接對照官方 SKILL 復現的兩類示例。

簡單 tabBar 默認寫法¶

在不需要 tab 圖標時，app.json 可採用純文字自定義 tabBar：

{
  "tabBar": {
    "custom": true,
    "list": [
      { "pagePath": "pages/index/index", "text": "首頁" },
      { "pagePath": "pages/travel/travel", "text": "行程" },
      { "pagePath": "pages/my/my", "text": "我的" }
    ]
  }
}

再在自定義 tabBar 組件裏只做文字佈局，避免預留圖標位導致的空白。

最小項目骨架¶

app.js：

App({
  onLaunch() {
    console.log("Mini Program launched");
  },
});

pages/index/index.js：

Page({
  data: {
    message: "Hello CloudBase Mini Program",
  },
});

pages/index/index.wxml：

<view class="page">
  <text>{{message}}</text>
</view>

pages/index/index.json：

{
  "navigationBarTitleText": "Home"
}

project.config.json（預覽/上傳前需替換爲真實 appid）：

{
  "appid": "your-mini-program-appid",
  "projectname": "cloudbase-mini-program",
  "miniprogramRoot": "./",
  "compileType": "miniprogram"
}

實際開發中，若涉及 Nightly、wechatide 參數、消息推送綁定或雲開發初始化，應讓 Agent 先讀取 SKILL 內列出的 references/ 文檔再改代碼，而不是一次性生成整倉。

適用場景與注意¶

適合誰

• 用 AI 輔助創建、修改、調試、預覽或發佈微信小程序的開發者。
• 項目可能接入騰訊雲開發，需要 Agent 區分「通用小程序」與 wx.cloud 路徑的團隊。
• 需要統一 tabBar、項目配置、DevTools/Nightly 工作流說明，減少 Agent 誤用 Web 模式或錯誤預覽方式的情況。

限制與注意

• Skill 依賴同目錄下的 CloudBase 兄弟 Skill（如 cloudbase-platform、auth-wechat-miniprogram 等）；若本地只裝了本包、缺少兄弟 Skill，SKILL 要求向用戶說明需安裝完整 CloudBase 插件或缺失項，不要通過 HTTP 拉取遠程 skill 文檔湊上下文。
• CLI 自動化默認面向 Nightly；Stable 版工具可能不含 Nightly Skills/wechatide，不要靜默降級爲「手動導入」而不告知用戶。
• 雲開發、微信支付、主體類型（個人/企業）有硬性業務限制，Skill 內強調先確認售賣類型再推薦主體，避免後期主體變更成本。
• SkillHub 頁面展示的評分爲 100000，下載 46019，安裝 7（統計隨 SkillHub 更新而變化，以頁面爲準）。

結尾¶

微信小程序開發 Skill 把小程序工程約定、DevTools/Nightly 調試發佈路徑、可選雲開發與消息推送等知識收斂到 Agent 可讀的結構裏，減少 AI 在小程序場景下的常識性錯誤。若你正在用 Cursor 或同類工具寫小程序，可先按上文安裝 @tencent-adm/miniprogram-development，再在對話中明確是否使用雲開發、是否需要預覽/上傳，以便 Agent 命中正確的 reference。

官方介紹與安裝入口：https://api.skillhub.cn/zcwl/miniprogram-development
SkillHub 詳情頁：https://www.skillhub.cn/skills/tencent-adm/miniprogram-development