返回 Skill 列表
extension
分类: 其它无需 API Key

Create AI Miniprogram

从零创建具备 AI 能力的微信小程序。适用于全新项目(非在已有项目上追加功能)。集成云开发、数据库、登录、支付等能力。需 Node.js 18+ 和 mp-skills CLI。

person作者: u_e8d50233hubenterprise

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-skillswxa-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.jsCLOUD_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