跳到主要内容

快速开始

本节介绍如何快速上手小程序 AI 开发模式。你可以选择以下任一方式开始：

  • 场景一：从零创建一个 AI 小程序 — 适合全新项目
  • 场景二：在已有小程序中接入 AI 开发模式 — 适合现有项目改造

前置条件​

场景一：从零创建 AI 小程序​

此场景使用 mp-skills CLI 创建一个全新的小程序项目，并安装开箱即用的 AI Skill。

第 1 步：创建项目​

# 创建项目骨架（含 AI 开发模式的基础配置）
npx mp-skills new my-ai-app

# 进入项目目录
cd my-ai-app

执行后会自动生成项目结构，包含 miniprogram/、cloudfunctions/ 等目录，并初始化 Git 仓库。

第 2 步：配置 AppID​

在微信公众平台获取小程序 AppID，填入 project.config.json 中的 appid 字段。

第 3 步：搜索并安装 Skill​

# 查看所有可用的 Skill
npx mp-skills find

找到感兴趣的业务 Skill 后，安装到项目中（以 order-skill 为例）：

# 安装指定 Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

# 或一次性安装所有 Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all

安装后自动完成：

  • 拷贝 Skill 到 miniprogram/skills/<name>/
  • 更新 miniprogram/app.json 的 agent.skills + subPackages
  • 更新 project.config.json 的 packOptions.include
  • 写入 skills-lock.json 版本锁

第 4 步：环境搭建​

若安装的 Skill 依赖云开发服务，运行一站式环境搭建：

npx mp-skills setup

setup 会自动聚合云函数、创建数据库集合、检查所需服务配置。

第 5 步：在开发者工具中打开​

# 用微信开发者工具打开项目
/Applications/wechatwebdevtools.app/Contents/MacOS/cli open --project /absolute/path/to/my-ai-app

在开发者工具中预览，即可看到 AI Agent 对话入口，体验 AI 交互。

场景二：在已有小程序中接入 AI 开发模式​

如果你已有一个微信小程序项目，可以按以下步骤接入 AI 开发模式。

第 1 步：进入项目目录​

cd your-existing-miniprogram

确保项目根目录包含 project.config.json。

第 2 步：搜索并安装 Skill​

# 查看可用的 Skill
npx mp-skills find

# 安装需要的 Skill（以 order-skill 为例）
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

第 3 步：校验安装结果​

安装完成后，使用 validate 命令确保 Skill 配置正确：

npx mp-skills validate

validate 会检查：

  • app.json 中 agent.skills 配置是否完整
  • Skill 分包结构是否合规
  • 原子接口定义是否完整

第 4 步：环境搭建​

# 一站式环境搭建
npx mp-skills setup

第 5 步：质量评估​

安装完成后，可以使用 eval 命令对已安装的 Skill 进行端到端质量评估：

# 配置 LLM 凭证（用于自动生成测试用例）
export WXA_SKILL_EVAL_LLM_BASE_URL=https://api.deepseek.com/v1
export WXA_SKILL_EVAL_LLM_API_KEY=sk-your-key
export WXA_SKILL_EVAL_LLM_MODEL=deepseek-chat

# 运行评估（生成 3 个测试用例）
npx mp-skills eval -c 3

# 只评估指定 Skill
npx mp-skills eval -s order-skill -c 3

# AI 辅助评估模式
npx mp-skills eval --mode agent -c 3

质量评估会验证 Skill 的端到端可用性，包括 AI 对话中的调用链路。

可用 Skill 列表​

以下 Skill 均可通过 npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s <skill-name> 安装：

Skill场景
order-skill点餐 - 搜索餐厅、浏览菜单、下单
bill-skill缴费 - 查询账单、在线缴费
hospital-skill挂号 - 搜索医院、选择科室时段
queue-skill排队 - 排队取号、查看排队状态
taxi-skill打车 - 预估价格、呼叫出租车
shopping-skill购物 - 搜索潮玩商品、查看详情
travel-skill旅行 - 搜索目的地、行程规划
party-skill聚会 - 创建聚会、场地推荐
payment-skill支付 - 创建支付订单、查询状态
todolist-skill待办 - 待办列表管理
text-gen-skill文本生成 - AI 写作、翻译、总结
image-gen-skill图片生成 - 文生图
image-edit-skill图片编辑 - AI 编辑图片
water-tracker喝水提醒 - 记录饮水、查看进度

提示：运行 npx mp-skills find 或 npx mp-skills list --remote 可查看最新可用 Skill 列表。

下一步​