前言¶
小程序 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
