前言¶
用 AI 生成微信小程序 SKILL 產物時，常見問題不在「能不能寫出來」，而在「能不能過校驗、能不能在真機上跑通」。目錄結構、原子接口、組件渲染各有一套約束，單靠人工對照文檔逐項檢查成本高，也容易漏項。
下面介紹微信小程序團隊發佈的 Skill @tencent-adm/wxa-skills-validate（微信小程序 AI 開發模式校驗 Skills）。它面向小程序 AI SKILLs 產物的校驗與修復，並依託微信開發者工具做真機驗證，把靜態檢查、接口聯調與交付文檔串成一條可重複的路徑。
這是什麼¶
一句話定位：校驗和修復小程序 AI SKILLs 產物，並在需要時輸出交付文檔。
- 出品 / 維護：微信小程序團隊（SkillHub 來源標註爲 enterprise）
- 座標：
@tencent-adm/wxa-skills-validate - 當前版本：v0.2.3
- SkillHub 分類：dev-programming
- 標籤：
requires_api_key=false（按頁面說明，不依賴 API Key）
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/wxa-skills-validate
- API 座標頁：https://api.skillhub.cn/tencent-adm/wxa-skills-validate
核心功能¶
以下能力均來自官方簡介，未在資料中出現的細節不展開。
-
對
skills/目錄做靜態校驗
在產物落盤後，先檢查目錄與 SKILL 相關結構是否符合預期，減少後續聯調階段的返工。 -
跑通原子接口
在靜態校驗之後，驗證原子層接口能否按預期調用，避免「文件齊全但運行時失敗」。 -
驗證原子組件渲染
覆蓋 UI / 組件側：確認原子組件能否正確渲染，而不只停留在接口返回。 -
修復校驗報錯
校驗失敗時，由 Agent 按 Skill 指引定位並修復報錯項，而不是隻輸出錯誤列表。 -
輸出交付文檔
在流程末尾整理交付說明，便於團隊交接或歸檔。 -
真機驗證
依託微信開發者工具進行真機驗證，把「開發者工具內通過」與「真機行爲」對齊。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓 AI 按通用安裝文檔安裝本 Skill。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/wxa-skills-validate`。
若本機已安裝 SkillHub CLI，可按官方文檔將技能裝到當前 Agent 識別的 skills 目錄（安裝時必須使用 --dir，否則默認落在 ./skills/ 可能不被識別）：
command -v skillhub && skillhub --version
未安裝 CLI 時，完整安裝（CLI + 默認 Skill）示例：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill（將 <skills 目錄> 換成你當前環境的路徑）：
skillhub install tencent-adm/wxa-skills-validate --dir <skills 目錄>
常用客戶端 skills 目錄（摘自 SkillHub 安裝文檔，以你本機實際配置爲準）：
| 客戶端 | 典型路徑 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝後按所用 Agent 的要求重啓或刷新技能列表，再在對話中觸發下文場景即可。
典型用法¶
官方簡介將觸發場景寫得很明確，可按下面順序在 Agent 裏提出需求（表述可與項目實際對齊，不必逐字照搬）：
- 靜態校驗：「對當前項目的
skills/目錄做靜態校驗。」 - 原子接口：「跑通 SKILL 相關的原子接口。」
- 組件渲染：「驗證原子組件渲染是否正常。」
- 修復報錯：「根據校驗結果修復報錯。」
- 交付文檔：「輸出本次 SKILL 產物的交付文檔。」
- 真機：在微信開發者工具中按 Skill 指引完成真機驗證。
整條鏈路是：先靜態、再接口與渲染、有問題則修復、最後文檔與真機。具體命令與檢查項由 Skill 包內的 SKILL.md 及引用資源定義，本文不臆造步驟編號或配置字段。
適用場景與注意¶
適合誰
- 正在用 AI 模式產出微信小程序 SKILL、且需要可交付、可驗收結果的團隊或個人開發者。
- 希望在「目錄規範、接口、組件、真機」之間有一致檢查清單，而不是每次手寫 checklist 的場景。
使用注意
- 真機環節依賴微信開發者工具，需提前準備好小程序工程與真機調試環境。
- SkillHub 頁面標註
requires_api_key=false；若你使用的其他工具鏈仍要求密鑰，以各工具文檔爲準。 - 社區數據（截至資料抓取）：SkillHub 評分 100000，下載 15061 次；版本以頁面顯示的 v0.2.3 爲準，升級後行爲以新版本說明爲準。
結尾¶
@tencent-adm/wxa-skills-validate 把小程序 AI SKILLs 產物的靜態校驗、原子接口與組件驗證、報錯修復、交付文檔和微信開發者工具真機驗證串成一條工作流，適合作爲 AI 生成產物之後的質量門禁。
官方 SkillHub 地址：https://www.skillhub.cn/skills/tencent-adm/wxa-skills-validate
