前言¶
小程序 AI 開發模式要求頁面能力拆成符合 wx.modelContext 的原子接口與原子組件，並落在獨立的 skills/ 分包裏，同時改好 app.json、project.config.json。手工從現有業務代碼裏梳理網絡請求、JSAPI 調用和業務步驟，工作量大，也容易漏改配置。
下面介紹 SkillHub 上的 @tencent-adm/wxa-skills-generate（微信小程序AI開發模式生成Skills）。它面向「已有小程序工程、需要一次性產出技能分包骨架」的場景：由 Agent 讀取 Skill 說明，對項目源碼做靜態分析並生成代碼與配置，生成結束後應交給 @tencent-adm/wxa-skills-validate 做校驗，而不是自行當作已可上線。
這是什麼¶
一句話定位：分析小程序項目源代碼（含壓縮、混淆），識別核心業務步驟，提取網絡接口與 JSAPI 調用，生成符合 wx.modelContext 規範的技能分包（原子接口 + 原子組件），並完成 app.json / project.config.json 的配置集成。
- 座標：
@tencent-adm/wxa-skills-generate - 版本：0.2.3（SkillHub 頁面標註）
- 來源：enterprise
- 發佈者：微信小程序團隊
- 分類：dev-programming
- API Key：標籤
requires_api_key=false，安裝後無需單獨配置 SkillHub API Key
官方入口：
- Skill 元數據：
https://api.skillhub.cn/tencent-adm/wxa-skills-generate - SkillHub 詳情頁：
https://www.skillhub.cn/skills/tencent-adm/wxa-skills-generate
核心功能¶
以下能力均來自官方簡介，本 Skill 只做靜態生成，不包含運行時校驗。
- 源碼分析：讀取小程序項目源代碼；說明中明確支持壓縮、混淆後的代碼。
- 業務步驟識別：從源碼中歸納核心業務步驟，作爲後續原子能力劃分的依據。
- 接口與 JSAPI 提取：梳理項目中的網絡接口調用與微信 JSAPI 調用，便於映射到 AI 可調用的原子接口。
- 技能分包生成：產出符合
wx.modelContext規範的分包內容，包含原子接口與原子組件，通常對應工程內的skills/分包結構。 - 工程配置集成：自動或半自動完成
app.json、project.config.json中與技能分包相關的配置項寫入，減少手工改配置遺漏。 - 與校驗 Skill 分工：生成完成後必須交棒
wxa-skills-validate（@tencent-adm/wxa-skills-validate）做規範與完整性校驗；本 Skill 不替代校驗步驟。
建議在 Agent 中觸發的場景（官方列舉）：
- 把小程序頁面能力改造爲小程序 AI 原子接口
- 生成
skills/分包代碼 - 從源項目派生 MCP 工具
- 小程序 AI 開發模式下的代碼生成
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub 安裝到當前 Agent 的 skills 目錄後，由 Agent 在對話中按 Skill 文檔執行。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
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
說明見：https://skillhub.cn/install/skillhub.md。
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 正在使用的 skills 目錄，否則默認裝到 ./skills/，Agent 可能識別不到。
skillhub install @tencent-adm/wxa-skills-generate --dir <skills 目錄>
常用客戶端 skills 路徑（來自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目 .windsurf/skills/ |
SkillHub 頁面也提供「將提示詞發送給 AI 安裝」的方式：讓 Agent 根據 https://skillhub.cn/install/skillhub.md 安裝 @tencent-adm/wxa-skills-generate。這與 CLI 安裝目標一致，差別在於由 Agent 代勞目錄選擇與命令執行。
3、啓用與後續 Skill¶
本 Skill 無需 API Key。若要走完整「生成 → 校驗」鏈路，需在同一 Agent 環境中另行安裝 @tencent-adm/wxa-skills-validate，並在生成任務結束後顯式觸發校驗。
典型用法¶
官方頁面未給出固定的一行 shell 示例；實際用法是：在已安裝 Skill 的 Agent 裏，針對目標小程序工程發起生成任務。可按下面順序理解工作流。
- 準備工程：本地可讀寫的小程序項目目錄，含頁面、邏輯與現有
app.json/project.config.json。 - 在 Agent 中說明意圖，並引用上節觸發場景之一，例如：「分析當前小程序項目，生成符合 wx.modelContext 的
skills/分包，並更新app.json與project.config.json。」 - Agent 按 SKILL.md 執行：掃描源碼（含混淆）、提取接口與 JSAPI、輸出原子接口/組件及分包文件，並寫入或提示合併配置變更。
- 交棒校驗：生成完成後，在同一 Agent 中調用
wxa-skills-validate，對生成物做規範檢查；不要跳過這一步直接提交審覈或上線。
若工程路徑不在當前工作區，應在對話中寫清絕對路徑或先打開對應文件夾，避免 Agent 分析錯目錄。
適用場景與注意¶
適合誰
- 已在用或計劃用微信小程序 AI 開發模式，需要把存量頁面能力拆成原子接口/組件的團隊。
- 希望從現有小程序派生
skills/分包或 MCP 工具定義，而不是從零手寫分包骨架的開發者。
限制與注意
- 僅靜態生成：不保證生成結果可直接運行；必須通過
wxa-skills-validate校驗後再迭代。 - 混淆代碼：官方稱支持壓縮/混淆源碼，但極端混淆仍可能影響步驟識別質量，生成後需人工 diff 關鍵業務路徑。
- 配置合併：
app.json、project.config.json若已有複雜自定義結構，生成結果可能需要人工合併衝突項。 - 數據參考：SkillHub 抓取元數據顯示評分爲 100000、下載約 53585 次（統計隨 SkillHub 更新變化，以頁面爲準）。
結尾¶
@tencent-adm/wxa-skills-generate 由微信小程序團隊發佈，把「讀源碼 → 抽接口與 JSAPI → 出 wx.modelContext 技能分包與工程配置」收斂成 Agent 可重複執行的 Skill 流程，並與 wxa-skills-validate 形成生成與校驗分工。
- SkillHub：
https://www.skillhub.cn/skills/tencent-adm/wxa-skills-generate - 元數據 API：
https://api.skillhub.cn/tencent-adm/wxa-skills-generate
