Awesome WeChat Mini Program Skills Awesome

[!NOTE] 推荐使用 mp-skills CLI 工具快速接入微信 AI 开发模式——小程序 Skill 开发工具,支持快速创建新的 AI 小程序和 Skill,或将现有小程序改造为支持 AI 开发模式,并内置 AI 评测校验工具,保障 Skill 执行质量和稳定性。

npx mp-skills --help

微信小程序 AI 开发模式 的 Skill 集合。

把小程序业务封装成 AI 可调用的 Skill —— 用户通过自然语言就能完成点单、排队、查天气等操作。

https://github.com/user-attachments/assets/393072ce-96c2-47dd-9286-7ef0e88c13a4


快速开始

# 查看/搜索本仓库有哪些 Skill
npx mp-skills find

# 安装某个 Skill 到你的项目
cd your-project
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills -s order-skill

# 或克隆本仓库预览
git clone https://github.com/TencentCloudBase/awesome-miniprogram-skills.git
cd awesome-miniprogram-skills
/Applications/wechatwebdevtools.app/Contents/MacOS/cli open --project .

Skills 一览

每个 Skill 的详细说明见各自目录下的 README.md

项目架构

├── app.json / app.js / app.wxss         # 小程序入口与全局配置
├── pages/home/home                       # 首页(AI Agent 对话入口)
├── page-meta.json                        # 页面元数据(AI 路由)
├── skills/                               # Skill 独立分包(每个自包含)

│   ├── order-skill/                      # 外卖点餐
│   ├── hospital-skill/                   # 医院挂号
│   ├── taxi-skill/                       # 出行打车
│   ├── travel-skill/                     # 旅行规划
│   ├── shopping-skill/                   # 潮玩购物
│   ├── bill-skill/                       # 生活缴费
│   ├── party-skill/                      # 聚会安排
│   ├── queue-skill/                      # 门店排队取号
│   ├── todolist-skill/                   # 简单待办
│   ├── water-tracker/                    # 喝水记录
│   ├── payment-skill/                    # 微信支付
│   ├── text-gen-skill/                   # AI 文本生成
│   ├── image-gen-skill/                  # AI 图片生成
│   └── image-edit-skill/                 # AI 图片编辑
├── cli/                                  # mp-skills CLI 工具
└── assets/screenshots/                   # 组件渲染截图

每个 Skill 是自包含的功能单元,包含前端代码(API + 组件)和可选的云函数、数据库集合定义。

数据流

用户输入 → AI 路由(SKILL.md 匹配)
  → 原子接口(预览模式走 seed mock / 正式模式走云函数)
  → 原子组件(卡片 UI + tap 上行 api/call)

所有 Skill 支持双模式运行:

  • 预览模式(默认):mp_skills_preview_mode = true,走本地 seed/mock 数据,无需云开发环境
  • 正式模式mp_skills_preview_mode = false,调用独立云函数,连接云数据库

Skill 开发范式

详细说明见 SKILL-DEV-GUIDE.md

贡献

欢迎贡献新的 Skill!请参考 CONTRIBUTING.md

部署与调试

本项目推荐配合 CloudBase SkillMCP 工具 完成云资源部署和调试:

  • 在 CodeBuddy 中安装 CloudBase Skill,自动识别环境并部署云函数与数据库
  • 使用 MCP 工具管理云函数、数据库集合和数据模型
  • 所有接口支持双模式运行:默认预览模式走本地 seed/mock 数据;切换到正式模式后调用独立云函数。无需云开发环境也能通过 seed 数据体验完整流程

开发

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

# 静态校验
node <validate-path>/scripts/validate.mjs <project-path>

# 原子接口执行
node <validate-path>/scripts/execute.mjs --project <project-path> --name <api-name> --auto-port 9420

# 原子组件渲染
node <validate-path>/scripts/render.mjs --project <project-path> --from-execute <execute-result.json> --auto-port 9420

许可证

MIT