mp-skills
微信小程序 AI 开发模式是微信提供的一种新型开发范式。传统小程序需要用户逐页点击完成操作；在 AI 开发模式下，开发者只需将业务功能封装为 SKILL（包含业务说明、原子接口和原子组件），用户便可通过自然语言对话直接调用——"帮我点一杯拿铁"、"挂明天下午的号"、"查一下这个月的水电费"，AI 理解意图后自动执行对应操作。
mp-skills 是 CloudBase 提供的工具套件，包含命令行工具和小程序 Skill 市场，让开发者无需从零搭建，即可快速为小程序接入 AI 对话能力。
查看「微信小程序 AI 开发模式」专题页 →核心工具
mp-skills CLI
一个开源命令行工具，用于管理小程序 AI 开发模式下的 SKILL：
- 搜索 Skill — 跨注册仓库搜索可用 Skill
- 安装 Skill — 从小程序 Skill 市场一键安装
- 从零创建 — 生成新小程序项目骨架
- 创建 SKILL — 生成脚手架，快速开始开发
- 管理 SKILL — 查看、更新、移除已安装的 SKILL
- 环境搭建 — 一站式初始化云函数、数据库
- 校验与评测 — 静态校验和端到端质量评估
# 从零创建 AI 小程序
npx mp-skills new my-ai-app
# 搜索可用 Skill
npx mp-skills find
# 安装 Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill
# 环境搭建
npx mp-skills setup
# 校验与评测
npx mp-skills validate
npx mp-skills eval -c 3
小程序 Skill 市场
Awesome MiniProgram Skills 是一个开源的小程序 Skill 集合，提供开箱即用的 Skill，覆盖点餐、出行、医疗、购物、生活服务等常见场 景。
每个 Skill 都是完整可运行的 SKILL 分包，包含原子接口、原子组件和业务配置，支持预览模式（本地 Mock 数据）和正式模式（云函数 + 云数据库）两种运行方式。
查看 全部小程序内 Skill 浏览详情。
两种类型的 Skill
mp-skills 管理两种用途不同的 Skill：
- 小程序内 Skill — 安装到小程序项目中，为用户提供 AI 对话式功能（点餐、挂号、缴费等）。终端用户通过自然语言直接调用。
- AI 开发辅助 — 安装给 AI 编码工具（如 CodeBuddy），引导 AI 帮你完成开发任务（搜索安装 Skill、从零创建项目、生成自定义 Skill 代码）。
两种 Skill 使用不同的 CLI 工具安装，区别如下：
| 小程序内 Skill | AI 开发辅助 | |
|---|---|---|
| 安装工具 | npx mp-skills add | npx skills add |
| 来源仓库 | awesome-miniprogram-skills | mp-skills |
| 安装到 | 小程序项目 | AI 编码工具工作目录 |
| 典型命令 | npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill | npx skills add TencentCloudBase/mp-skills -s wxa-find-skills |
详细说明请查看 小程序内 Skill 和 AI 开发辅助。
快速上手
场景一：从零创建新项目
# 创建项目骨架（含 AI 开发模式基础配置）
npx mp-skills new my-ai-app
# 搜索并安装 Skill
cd my-ai-app
npx mp-skills find
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill
# 环境搭建
npx mp-skills setup
# 在微信开发者工具中打开体验 AI 对话
场景二：在已有项目中接入
cd your-project
npx mp-skills find
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill
npx mp-skills validate
npx mp-skills setup
详细指引请查看 快速开始。
价值与适用场景
接入小程序 AI 开发模式后，用户可以在小程序中通过对话完成各类操作，无需逐级浏览菜单页面。这对开发者的核心价值在于：
- 降低交互成本：将多步操作（搜索 → 筛选 → 查看详情 → 确认 → 支付）压缩为一句自然语言指令
- 提升转化率：对话式交互更符合用户直觉，减少操作中途流失
- 覆盖长尾场景：复杂的组合操作（如"周六晚上 6 点找一家川菜馆，4 个人，预算 300"）可通过 SKILL 轻松实现
- 渐进式接入：既可安装开箱即用的业务 SKILL，也可将现有功能封装为自定义 SKILL
底层技术
mp-skills 工具套件基于微信小程序的 AI 开发模式 构建。该模式下，开发者将小程序功能封装为 SKILL（包含业务说明、原子接口声明和实现），供小程序 AI 在对话中调用。
一个 SKILL 包含以下组成部分：
| 组件 | 说明 |
|---|---|
| SKILL.md | 业务说明文档，描述 SKILL 的使用场景和调用条件 |
| mcp.json | 原子接口声明，定义 API 名称、输入输出参数 |
| apis/ | 原子接口实现，每个接口一个文件，处理业务逻辑 |
| components/ | 原子组件（UI 卡片），用于渲染接口返回数据 |
CloudBase 通过 mp-skills CLI 和 Skill 市场，让这一过程更简单 —— 你无需从零搭建，只需一条命令即可获得完整的 SKILL 实现。
开始使用
- 快速开始 — 5 分钟上手
- mp-skills CLI — 命令行工具完整文档
- 小程序 Skill — 浏览所有精选 Skill
- 工具 Skill — 为 AI 开发工具提供的辅助 Skill
教程
| # | 教程 | 适合谁 | 解决的问题 |
|---|---|---|---|
| 0 | 从头构建一个 AI 友好的小程序 | 新手 | 从零创建一个含 AI 模式的小程序项目 |
| 1 | 从已有代码自动生成 AI 技能 | 有现成项目 | 让 AI 扫描你的小程序源码，自动生成 SKILL |
| 2 | 手写第一个 AI 技能 | 想控制细节 | 从脚手架到完整 SKILL，走通全流程 |
| 3 | 封装文本生成 | 有文本需求 | 接入 AI 写作、翻译、总结能力 |
| 4 | 封装图片生成 | 有图片需求 | 接入文生图能力 |
| 9 | 上线前质量检测 | 准备上线 | 用 validate + eval 确保 SKILL 质量 |