wxa-find-skills

搜索和安装社区小程序 AI Skill。

职责边界

• ✅ 搜索远程仓库中的可用 Skill
• ✅ 查看 Skill 的详细描述和功能
• ✅ 将 Skill 安装到本地小程序项目
• ❌ 创建新的小程序项目（交给 wxa-create-ai-miniprogram）
• ❌ 在项目中创建新的自定义 Skill（交给 wxa-create-mp-skill）
• ❌ 修改已安装的 Skill 代码
• ❌ 上架 Skill 到社区仓库
• 📦 交付：已安装的 Skill 目录 + app.json 注册条目

术语约定

• Skill：完成特定场景任务的 AI 能力封装，包含原子接口 + 原子组件
• 原子接口：对外暴露给小程序 AI 的可调用 API
• 原子组件：渲染原子接口返回数据的 GUI 卡片
• 仓库：托管 Skill 源码的 GitHub 仓库，如 TencentCloudBase/awesome-miniprogram-skills

依赖

• Node.js 18+
• mp-skills CLI（npm install -g mp-skills）
• 目标小程序项目（含 project.config.json + app.json）

参考资料索引

可用仓库：

• TencentCloudBase/awesome-miniprogram-skills — 全栈 AI Skill 仓库（含数据库 / 登录 / 支付模板）

硬性约束

A. 项目检查

B. 阻断规则（立即停止）

工作流

Step 1 — 理解需求

和用户对话，了解他们想要什么功能。例如：

用户："我想给我的小程序加一个排队取号功能" → 关键词：queue，结果从 awesome-miniprogram-skills 来

如果用户需求比较模糊，追问一两个问题明确方向，但不要过度分析。

Step 2 — 搜索 Skill

执行搜索命令：

npx mp-skills find \x3Ckeyword>

输出类似：

queue-skill         门店排队取号 — 搜索门店、取号、查看排队进度
order-skill         外卖点餐 — 搜索餐厅、浏览菜单、下单
...

把搜索结果展示给用户，简要说明每个 Skill 的用途。

搜索无结果时：

1. 建议换关键词重试
2. 或执行 npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all 查看全部可用 Skill
3. 或转 wxa-create-mp-skill 创建自定义 Skill

Step 3 — 用户确认

让用户选择要安装的 Skill。如果用户不确定，根据需求推荐最合适的：

"queue-skill 支持搜索门店、取号、查看排队进度，和您说的排队取号功能匹配。"

Step 4 — 安装

先列出已安装的 Skill（避免重复安装）：

npx mp-skills list

然后安装：

npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --skill \x3Cskill-name>

安装完成后输出类似：

  ok  已安装 queue-skill
  ok  已记录版本

Step 5 — 引导后续

告知用户配置完成之前还需要执行：

cd \x3C项目目录>
npx mp-skills setup

这会交互式选择云环境、聚合云函数、生成 cloudbaserc.json、初始化数据库。 之后用微信开发者工具打开项目即可预览。