前言¶
做微信小程序的開發者常遇到三類問題：一是剛上手時不知道工程結構怎麼搭，每個頁面要寫哪幾個文件、wxml 和 wxss 怎麼配合、尺寸單位用 rpx 還是 px；二是寫完之後調試階段反覆踩坑，比如 app.json 裏的 disableScroll 配置非法、ctx is not defined、頁面滾動卡頓；三是準備上線時搞不清 AppID 和測試號的區別、體驗成員權限怎麼配、上傳、審覈、發佈這幾步在哪個後臺操作。這個 Skill 就是針對這三段流程給 Agent 提供一套可執行的指引。
這是什麼¶
微信小程序從零到上線助手（座標 @user_ea18365b/wb-skill-wechat-miniprogram-helper-skill）是一個基於通用 SKILL.md 格式編寫的社區 Skill，發佈在 SkillHub 上，由 user_ea18365b 維護。它解決的問題是：當 Agent 接到”幫我做個小程序”“小程序報錯了”“小程序怎麼發佈”這類需求時，能按一條完整的路徑走完從創建項目到提交審覈上線的全過程，而不是零散地回答單個問題。
目前版本 1.0.3，分類爲 dev-programming，來源標記爲 community，無需 API Key 即可使用。
核心功能¶
下面介紹的覆蓋範圍均來自該 Skill 的官方簡介。
項目搭建與架構¶
- 從零搭建小程序工程，包括目錄結構和初始配置文件。
- 雙線程架構：邏輯層（App Service）與渲染層（WebView）分離，這是理解所有 API 行爲的基礎。
- 頁面四文件結構：
wxml、wxss、js、json，一個頁面由這四個文件組成，職責互不替代。
開發期關鍵概念¶
- 尺寸單位
rpx：以 750 爲屏幕寬度基準，按屏幕寬度等比縮放，替代固定 px。 setData的使用方式與常見性能誤區，數據量過大時會引起渲染開銷。- Canvas 2D 接口的使用方式。
常見錯誤定位¶
Skill 明確列出了三類高頻問題的處理思路：
app.json中disableScroll配置非法導致的啓動報錯。- Canvas 相關代碼報
ctx is not defined。 - 頁面滾動或交互出現 jank（卡頓）的排查方向。
賬號與權限¶
- AppID 與測試賬號的區別和適用場景。
- 小程序體驗成員權限的申請與配置。
發佈流程¶
- 上傳、提交審覈、發佈上線的完整工作流，對應微信公衆平臺後臺的具體操作位置。
觸發方式¶
Skill 設定的觸發短語包括：微信小程序、做個小程序、小程序上線、小程序報錯、小程序發佈、小程序體驗權限。在 Agent 對話中出現這些關鍵詞時，該 Skill 會被激活，按上述覆蓋範圍組織回答。
安裝與啓用¶
該 Skill 基於通用 SKILL.md 格式編寫，屬於社區發佈（community）來源，不依賴 API Key。目前官方資料中未提供可覈實的具體安裝命令或配置文件路徑，因此這裏不給出臆造的安裝步驟。需要使用時，建議直接訪問官方頁面獲取最新的啓用方式。
典型用法¶
以下場景均來自該 Skill 的觸發短語與功能覆蓋範圍。
場景一：從零創建項目¶
用戶說”做個小程序”，Agent 會按四文件結構生成頁面骨架，給出 app.json、頁面 json 和 wxml/wxss/js 的最小可運行版本，並在生成過程中說明 rpx 的使用約定。
場景二：排查啓動報錯¶
用戶說”小程序報錯了，啓動不了”，Agent 會先檢查 app.json 中的 disableScroll 等全局配置項是否符合規範，再判斷是否爲頁面級配置問題，最後定位到具體文件行號給出修改建議。
場景三：解決 Canvas 報錯¶
用戶說”小程序報錯 ctx is not defined“，Agent 會定位到 Canvas 2D 上下文獲取時機的問題——通常是在節點尚未渲染完成時就嘗試獲取 ctx，給出在 onReady 或節點查詢回調中獲取上下文的改法。
場景四：申請體驗權限¶
用戶說”小程序體驗權限怎麼開”，Agent 會說明體驗成員添加入口在微信公衆平臺的”成員管理”—“體驗成員”中，並解釋需要對方微信號且對方需接受邀請。
場景五：上傳與發佈¶
用戶說”小程序怎麼發佈”，Agent 會按”上傳代碼 → 提交審覈 → 審覈通過後發佈”的順序說明每一步在哪個後臺頁面操作，並提醒發佈前確認 AppID 已通過認證、體驗成員權限已配置。
適用場景與注意¶
適合以下開發者使用：
- 正在從零學習小程序開發，需要有人把工程結構和常用 API 講清楚。
- 遇到具體報錯或性能問題，需要一份常見錯誤的排查清單。
- 首次走發佈流程，需要知道每一步操作位置。
需要注意的限制：
- 該 Skill 是社區維護（community），功能覆蓋以簡介中列出的範圍爲準，遇到超出範圍的問題（如原生組件具體兼容性、雲開發細節）時，需要結合其他資料補充。
- Skill 不替代微信開發者工具本身的調試能力，複雜斷點調試仍需在工具內完成。
- 目前版本爲 1.0.3，屬於早期版本，後續更新可能調整覆蓋範圍。
結尾¶
微信小程序從零到上線助手的價值在於，把小程序開發中分散在文檔各處的知識——工程結構、rpx、setData、Canvas 2D、典型報錯、賬號權限、發佈流程——整合成一條 Agent 可以按序執行的路徑。對於剛接觸小程序的開發者和需要快速排查問題的團隊，它適合作爲 Agent 工具箱裏的標準組件。
官方地址：https://api.skillhub.cn/user_ea18365b/wb-skill-wechat-miniprogram-helper-skill
