Create AI Miniprogram

SKILL.md

---
name: wxa-create-ai-miniprogram
description: 从零创建带 AI 能力的微信小程序项目。当用户想创建一个全新的微信小程序（不是已有项目上添加功能）时触发。集成云开发、数据库、登录、支付等能力。需要 Node.js 18+ 和 mp-skills CLI。
metadata:
  author: TencentCloudBase
  version: '0.1.0'
compatibility: [mp-skills CLI, Node.js 18+]
---

# 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-skills` 或 `wxa-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 — 创建项目

用户确认方案后，执行：

```bash
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（首页引导卡片）：

```bash
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill greet-skill
```

以及推荐业务 Skill：

```bash
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill <业务Skill名>
```

也可以一次性安装全部后再移除不需要的：

```bash
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all
```

### Step 4 — 引导配置

告诉用户还需要手动完成以下步骤：

**4.1 填写 appid** —— 在微信公众平台注册小程序，获取 AppID 后填入 `project.config.json`

**4.2 填写云环境 ID** —— 在云开发控制台创建环境，将环境 ID 填入 `miniprogram/app.js` 的 `CLOUD_ENV_ID`

**4.3 运行 setup**：

```bash
npx mp-skills setup
```

交互式选择云环境 → 聚合云函数 → 生成 cloudbaserc.json → 初始化数据库。

**4.4 打开项目**：

```bash
# 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`）