前言¶
搭一个微信小程序的 AI 版本，通常要同时做几件事：申请 AppID、开云开发环境、写登录和支付、再决定哪些能力拆成 Skill。手工从零起一个项目，光是把 wx.cloud.init() 和云环境 ID 对齐就要花掉不少时间。
下面介绍的 Create AI Miniprogram 把这件事压缩成一条命令驱动的流程：你只描述需求，它按固定的工作流创建项目骨架、安装首批 AI Skill，并把需要你自己去控制台拿的 AppID 和云环境 ID 明确留在你手上。
这是什么¶
Create AI Miniprogram 是一个基于通用 SKILL.md 格式的 Skill，坐标 @tencent-adm/wxa-create-ai-miniprogram，由腾讯云 CloudBase 团队发布维护，上游仓库在 ClawHub（binggg/wxa-create-ai-miniprogram）。
它的定位很窄：只在你想从零新建一个微信小程序时触发。项目一旦建好，这个 Skill 的工作就结束了，后续加功能属于别的 Skill。
在 SkillHub 上的版本是 0.2.1，分类 dev-programming，来源 enterprise，评分 100000，下载 703 次，标签 requires_api_key=false（不需要 API Key）。上游 ClawHub 页面显示的版本是 0.2.0，许可 MIT-0。
核心功能¶
只做新建项目这一件事，分五步：
- 需求分析：跟你对齐小程序做什么、目标用户是谁、核心功能是什么。
- 创建项目骨架：用
mp-skills new生成带 AI 能力的基础项目，并初始化 git 仓库。 - 安装首批 AI Skill：至少装一个首页引导用的 Skill，再按方案装业务 Skill。
- 引导云开发配置：AppID、云环境 ID、
setup、打开开发者工具，都是你手动完成，Skill 不代填。 - 收尾：决定是再加 Skill，还是要在已有 Skill 上扩展。
官方给出的职责边界写得很明确，可以当清单核对：
- 做：推荐功能方案、选模板建骨架、装首批 Skill、引导云开发配置。
- 不做：在已有项目上加 Skill（交给
wxa-create-mp-skill）、搜索社区 Skill（交给wxa-find-skills）、替你填 AppID 或云环境 ID。 - 交付物：完整的小程序项目目录 + 已安装的 Skill + 配置指引。
几个术语在官方资料里有约定，后面看配置会用到：
- 项目骨架：通过
mp-skills new创建的带 AI 能力的基础项目模板。 - 云环境 ID：云开发控制台中每个环境的唯一标识，用于
wx.cloud.init()。 - AppID：微信小程序的 AppID，在微信公众平台注册获取。
安装与启用¶
环境要求¶
Node.js 18+，以及 mp-skills CLI。如果没有，先装 CLI：
npm install -g mp-skills
安装 Skill¶
官方 ClawHub 页面给出的安装命令是：
openclaw skills install @binggg/wxa-create-ai-miniprogram
页面同时标了 CLI npx skills 作为另一条安装入口，即也可以走 npx 方式安装。
注意这里的差异：资料里只出现了 ClawHub / openclaw 的安装路径，没有 Cursor、Codex CLI 或 Claude Code 的独立安装说明，所以不展开。如果你是在别的工具里用，需要自己确认该工具对 SKILL.md 格式的支持方式。
启用¶
装好之后，Skill 通过 SkillHub 页面上列出的能力点生效：推荐功能方案、创建项目骨架、安装首批 AI Skill、引导云开发配置。触发条件就是”用户想创建一个全新的微信小程序”。
典型用法¶
以下流程来自 Skill 的 SKILL.md，是可以直接复现的。
Step 1 — 需求分析¶
跟用户确认三件事：小程序做什么、目标用户是谁、需要哪些核心功能。Skill 会参考 TencentCloudBase/awesome-miniprogram-skills 仓库的现有 Skill 给建议，然后输出 3-5 句话的方案（目标用户、核心功能、推荐的 Skill）。
官方列出的可选 Skill 清单：
| Skill | 功能 | 适用场景 |
|---|---|---|
| greet-skill | 首页欢迎引导 | 所有项目（推荐安装） |
| queue-skill | 门店排队取号 | 餐饮、服务行业 |
| order-skill | 外卖点餐 | 餐饮外卖 |
| shopping-skill | 潮玩购物 | 电商零售 |
| taxi-skill | 出行打车 | 出行服务 |
| hospital-skill | 医院挂号 | 医疗健康 |
| travel-skill | 旅行规划 | 旅游出行 |
| bill-skill | 生活缴费 | 公共服务 |
| party-skill | 聚会安排 | 社交活动 |
| todolist-skill | 待办事项 | 效率工具 |
| payment-skill | 微信支付 | 通用支付能力 |
| water-tracker | 喝水记录 | 健康打卡 |
Step 2 — 创建项目¶
方案确认后执行：
npx mp-skills new <project-name>
cd <project-name>
官方给出的输出示例：
* 创建项目: my-app
ok 项目骨架已生成
ok git 仓库已初始化
[OK] 项目已创建: my-app
cd my-app
在 project.config.json 中填写 appid（微信公众平台获取）
Step 3 — 安装首批 Skill¶
至少安装 greet-skill（首页引导卡片）：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill greet-skill
再按方案装业务 Skill：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill <业务Skill名>
或者一次装完再移除不需要的：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all
Step 4 — 引导配置¶
这一步是手动完成的，Skill 只负责告诉你要做什么。
4.1 填 AppID：在微信公众平台注册小程序，拿到 AppID 后填入 project.config.json。
4.2 填云环境 ID：在云开发控制台创建环境，把环境 ID 填入 miniprogram/app.js 的 CLOUD_ENV_ID。
4.3 跑 setup：
npx mp-skills setup
官方描述的结果是：交互式选择云环境 → 聚合云函数 → 生成 cloudbaserc.json → 初始化数据库。
4.4 打开项目：
# macOS
/Applications/wechatwebdevtools.app/Contents/MacOS/cli open --project <项目路径>
# Windows
"C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat" open --project <项目路径>
Step 5 — 收尾¶
问用户是否还要：再添加更多 Skill（回到 Step 3 或转 wxa-find-skills），或者在已有 Skill 上加自定义能力（转 wxa-create-mp-skill）。
其他 CLI 能力¶
资料里还列了几条命令，用途和触发时机如下：
npx mp-skills list：查看已安装 Skill，用户要求查看时使用。npx mp-skills validate <project-dir>：检查 Skill 质量，用户要求检查时使用。npx mp-skills eval：端到端评测，用户要求评测时使用。
适用场景与注意¶
适合谁：
- 准备新建微信小程序、想直接带上云开发、数据库、登录、支付这些能力，并且想把部分能力做成 Skill 的开发者。
- 愿意按固定流程走、能接受 AppID 和云环境 ID 需要自己去控制台拿的开发者。
限制和坑，照官方的硬性约束来：
- 必须用
npx mp-skills new <name>创建项目，不要手动搭建。 - 创建后
project.config.json里的appid字段留空，由你在微信公众平台注册获取。 - 不要替用户（或让 Skill 替自己）填写 AppID 或云环境 ID，两者都必须在对应控制台自行获取。这是配置安全规则，不是建议。
- 装完 Skill 之后必须提示执行
npx mp-skills setup。
遇到以下情况会被阻断，需要先处理：
- 需求过于模糊、无法确定功能方向：追问 1-2 个问题明确（目标用户 / 核心功能）。
- 用户已经有项目想加功能：转
wxa-find-skills或wxa-create-mp-skill。 - 没装 Node.js 或
mp-skillsCLI：先执行npm install -g mp-skills。
另外要留意：本 Skill 只管新建项目。它明确把”在已有项目上加 Skill”和”搜索社区 Skill”划出去了，这两个需求分别由 wxa-create-mp-skill 和 wxa-find-skills 承接。如果你的需求属于后两种，装这个 Skill 不会得到预期结果。
结尾¶
Create AI Miniprogram 的价值在于把新建带 AI 能力的微信小程序这件事变成一条可复现的命令流：骨架、Skill、云开发配置各有固定入口，边界也写得清楚。前提是你确实要新建项目，并且能接受 AppID 和云环境 ID 由自己获取。
官方地址：https://api.skillhub.cn/tencent-adm/wxa-create-ai-miniprogram
SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/wxa-create-ai-miniprogram
上游仓库：https://clawhub.ai/binggg/wxa-create-ai-miniprogram
