前言¶
做一個微信原生小程序，從頭到尾要碰的東西很雜：頁面結構是 WXML/WXSS，組件可能來自 TDesign MiniProgram，樣式與邏輯要過微信開發者工具和 npm 構建；換了 Skyline 渲染引擎還要考慮與 WebView 的差異；接 CloudBase 就要處理雲函數、登錄、權限和隱私聲明；只要小程序裏有用戶上傳的頭像、圖片、音頻或評論，就繞不開微信的內容安全接口和回調排查。把這些事拆到多個 Skill 或多次對話裏，上下文很容易斷，評審和驗收時也不容易對齊標準。
下面介紹的 build-wechat-miniprogram 是把這些環節收攏到一個 SKILL.md 裏的技能。它不做公衆號排版，也不涉及小程序之外的開發，只覆蓋微信原生小程序的設計、工程交付與用戶內容安全審覈。
這是什麼¶
build-wechat-miniprogram 是一個社區來源的 Agent Skill，座標 @user_c25e780d/build-wechat-miniprogram，當前版本 1.0.1，發佈和維護者爲 SkillHub 用戶 user_c25e780d，分類 dev-programming。它解決的問題是：讓 Agent 在一次連續的任務裏完成微信原生小程序的設計、搭建、實現、評審、排查、部署和驗收，而不是隻回答片段性的代碼問題。
官方頁面標註該 Skill 不需要 API Key，屬於通用 SKILL.md 格式，可用於支持該格式的 Agent 客戶端。
核心功能¶
按官方簡介，它的能力覆蓋三塊。
第一塊是頁面與工程。包括 WXML/WXSS 的編寫、微信原生組件的使用、TDesign MiniProgram 組件接入、usingComponents 的路徑與版本配置、npm 構建流程，以及微信開發者工具中的編譯、預覽和真機調試。
第二塊是運行時與後端。包括 Skyline 與 WebView 兩種渲染方式的差異處理、CloudBase 雲函數調用、微信登錄、權限與隱私聲明的配置和排查。
第三塊是用戶內容安全審覈。覆蓋頭像、圖片、音頻、暱稱、評論等場景，涉及 security.mediaCheckAsync、security.msgSecCheck 兩個接口，以及安全模式下的 HTTPS 回調配置。對於常見的 pending、審覈中、回調失敗、上傳失敗等狀態，它也給出了排查方向。
此外還包括髮布驗證、多端適配、適老化和無障礙等交付驗收事項。
安裝與啓用¶
官方資料未提供具體的安裝命令或配置文件字段。可確認的信息如下：
- 座標：
@user_c25e780d/build-wechat-miniprogram - 官方地址：https://api.skillhub.cn/user_c25e780d/build-wechat-miniprogram
- SkillHub 頁面：https://www.skillhub.cn/skills/user_c25e780d/build-wechat-miniprogram
- 版本：1.0.1
- 是否需要 API Key：否
在支持 SkillHub 的客戶端中按座標搜索並啓用即可。是否支持 Codex CLI、Cursor、Claude Code 的具體安裝方式，官方資料沒有說明，不做推測。
典型用法¶
官方簡介以觸發關鍵詞方式說明何時啓用該 Skill，實際使用時可直接用自然語言描述任務，例如：
幫我搭建一個微信原生小程序頁面，用 TDesign MiniProgram 的按鈕組件，
寫好 WXML 和 WXSS，並配置 usingComponents。
涉及用戶上傳內容時，描述清楚場景和已出現的現象：
用戶上傳頭像後一直顯示 pending，mediaCheckAsync 回調失敗，
幫我排查安全模式 HTTPS 回調配置。
涉及登錄和數據存儲時：
用 CloudBase 實現微信登錄，配置雲函數和權限，
並補上隱私聲明。
這些示例對應的是官方列出的觸發關鍵詞範圍：微信小程序、小程序搭建、小程序 UI/UX、WXML、WXSS、TDesign、構建 npm、usingComponents、Skyline、CloudBase、雲函數、微信登錄、權限、隱私、頭像審覈、內容安全、pending、審覈中、回調失敗、上傳失敗、開發者工具、真機、發佈驗收。
適用場景與注意¶
適合正在做微信原生小程序、且任務鏈條較長的開發者：從初始搭建、組件接入、構建調試，到 CloudBase 集成，再到內容安全審覈和發佈驗收，都可以在同一個 Skill 下連續完成。
需要注意幾點。
- 它只面向微信原生小程序，不覆蓋 uni-app、Taro 等跨端框架，也不涉及公衆號或視頻號開發。
- 內容安全部分依賴微信側的審覈接口和安全模式回調，涉及域名、HTTPS 和服務器配置；回調失敗時要先確認安全模式是否開啓、回調地址是否可達，再檢查接口調用參數。
- Skyline 與 WebView 的行爲存在差異，組件和樣式需要在真機上驗證，不能只看開發者工具的模擬器。
- 該 Skill 爲社區來源，版本 1.0.1，使用前建議對照官方文檔覈對接口參數和組件版本。
結尾¶
build-wechat-miniprogram 的價值在於把小程序交付中分散的工程環節和內容安全審覈收進一份可觸發的指令裏，減少多輪對話中的上下文斷裂。如果你正在做微信原生小程序，可以從這裏開始：
https://api.skillhub.cn/user_c25e780d/build-wechat-miniprogram
