Awesome WeChat Mini Program Skills

[!NOTE]
本项目处于 Alpha 阶段，API 仍在快速迭代，可能发生不兼容变更。
欢迎下载体验、提交 Issue 反馈问题，或通过 PR 贡献代码。

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

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

💡 推荐使用 mp-skills CLI 工具发现并安装本仓库的 Skill 到你的小程序项目中。

快速开始

# 查看本仓库有哪些 Skill
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --list

# 安装某个 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。

order-skill 外卖点餐 · 4 API
hospital-skill 医院挂号 · 4 API	taxi-skill 出行打车 · 4 API
travel-skill 旅行规划 · 4 API	shopping-skill 潮玩购物 · 4 API
bill-skill 生活缴费 · 3 API	party-skill 聚会安排 · 4 API
queue-skill 门店排队 · 4 API	todolist-skill 简单待办 · 4 API
water-tracker 喝水记录 · 2 API	payment-skill 微信支付 · 2 API
text-gen-skill AI 文本生成 · 1 API	image-gen-skill AI 图片生成 · 1 API
image-edit-skill AI 图片编辑 · 1 API

项目架构

├── 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 Skill 和 MCP 工具 完成云资源部署和调试：

• 在 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