SKILL.md
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 — 创建项目
用户确认方案后，执行：
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（首页引导卡片）：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill greet-skill以及推荐业务 Skill：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill <业务Skill名>也可以一次性安装全部后再移除不需要的：
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --allStep 4 — 引导配置
告诉用户还需要手动完成以下步骤：
4.1 填写 appid —— 在微信公众平台注册小程序，获取 AppID 后填入 project.config.json
4.2 填写云环境 ID —— 在云开发控制台创建环境，将环境 ID 填入 miniprogram/app.js 的 CLOUDENVID
4.3 运行 setup：
npx mp-skills setup交互式选择云环境 → 聚合云函数 → 生成 cloudbaserc.json → 初始化数据库。
4.4 打开项目：
# 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）
ClawHub
https://clawhub.ai/binggg/wxa-create-ai-miniprogram
安装：npx skills add TencentCloudBase/mp-skills -s wxa-create-ai-miniprogram