前言¶

小程序 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 只做静态生成，不包含运行时校验。

1. 源码分析：读取小程序项目源代码；说明中明确支持压缩、混淆后的代码。
2. 业务步骤识别：从源码中归纳核心业务步骤，作为后续原子能力划分的依据。
3. 接口与 JSAPI 提取：梳理项目中的网络接口调用与微信 JSAPI 调用，便于映射到 AI 可调用的原子接口。
4. 技能分包生成：产出符合 wx.modelContext 规范的分包内容，包含原子接口与原子组件，通常对应工程内的 skills/ 分包结构。
5. 工程配置集成：自动或半自动完成 app.json、project.config.json 中与技能分包相关的配置项写入，减少手工改配置遗漏。
6. 与校验 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 安装文档）：

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 里，针对目标小程序工程发起生成任务。可按下面顺序理解工作流。

1. 准备工程：本地可读写的小程序项目目录，含页面、逻辑与现有 app.json / project.config.json。
2. 在 Agent 中说明意图，并引用上节触发场景之一，例如：「分析当前小程序项目，生成符合 wx.modelContext 的 skills/ 分包，并更新 app.json 与 project.config.json。」
3. Agent 按 SKILL.md 执行：扫描源码（含混淆）、提取接口与 JSAPI、输出原子接口/组件及分包文件，并写入或提示合并配置变更。
4. 交棒校验：生成完成后，在同一 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