wxa-create-ai-miniprogram

wxa-create-ai-miniprogram

从零创建带 AI 能力的微信小程序项目。

职责边界

• ✅ 了解用户需求，推荐小程序功能方案
• ✅ 选择合适的模板创建项目骨架
• ✅ 安装首批 AI Skill
• ✅ 引导用户完成云开发配置
• ❌ 在已有项目中添加 Skill（交给 wxa-create-mp-skill）
• ❌ 搜索安装社区 Skill（交给 wxa-find-skills）
• ❌ 替用户填写 appid 或云环境 ID（用户自行获取）
• 📦 交付：完整的小程序项目目录 + 已安装的 Skill + 配置指引

术语约定

• 项目骨架：通过 mp-skills new 创建的带 AI 能力的基础项目模板
• 云环境 ID：云开发控制台中每个环境的唯一标识，用于 wx.cloud.init()
• appid：微信小程序的 AppID，在微信公众平台注册获取

参考资料索引

来源	用途	加载时机
npx mp-skills new <name>	创建新项目骨架	Step 2
npx mp-skills add ... --skill <name>	安装 Skill	Step 3
npx mp-skills add ... --all	安装全部 Skill	Step 3 备选
npx mp-skills setup	初始化环境	Step 4 引导
npx mp-skills list	查看已安装 Skill	用户要求查看时
npx mp-skills validate <project-dir>	检查 Skill 质量	用户要求检查时
npx mp-skills eval	端到端评测	用户要求评测时
TencentCloudBase/awesome-miniprogram-skills	可选 Skill 清单	Step 1 需求分析
微信公众平台	注册小程序，获取 appid	Step 4 引导
云开发控制台	获取云环境 ID	Step 4 引导

硬性约束

A. 项目创建规范

• 必须使用 npx mp-skills new <name> 创建项目，不要手动搭建
• 创建后 project.config.json 中的 appid 字段留空，由用户在微信公众平台注册获取

B. 阻断规则（立即停止）

阻断情况	处理方式
用户需求过于模糊，无法确定功能方向	追问 1-2 个问题明确（目标用户 / 核心功能）
用户已有项目想添加功能	转 wxa-find-skills 或 wxa-create-mp-skill
用户没有安装 Node.js 或 mp-skills CLI	提示先安装：npm install -g mp-skills

C. 配置安全规则

• 不要替用户填写 appid 或云环境 ID——必须由用户在对应控制台自行获取
• 安装 Skill 后必须提示用户执行 npx mp-skills setup

工作流

Step 1 — 需求分析

与用户对话，了解以下信息：

• 这个小程序是做什么的？
• 目标用户是谁？
• 需要哪些核心功能？

参考 awesome-miniprogram-skills 仓库中的现有 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	喝水记录	健康打卡

输出一个简短方案（3-5 句话）：目标用户、核心功能、推荐的 Skill。

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 — 引导配置

告诉用户还需要手动完成以下步骤：

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）

---

ClawHub

https://clawhub.ai/binggg/wxa-create-ai-miniprogram

安装：npx skills add TencentCloudBase/mp-skills -s wxa-create-ai-miniprogram