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）

参考资料索引

| 来源 | 用途 | 加载时机 | |------|------|---------| | npx mp-skills --help | mp-skills 所有命令的帮助 | 执行前确认命令参数 | | npx mp-skills find <keyword> | 搜索远程仓库中的 Skill | Step 2 搜索 | | npx mp-skills list | 列出已安装 Skill（避免重复安装） | Step 4 安装前 | | npx mp-skills add <repo> --skill <name> | 安装指定 Skill | Step 4 安装 | | npx mp-skills add <repo> --all | 安装全部 Skill | Step 2 无结果时后备 | | npx mp-skills remove <name> | 移除不需要的 Skill | 用户要求移除时 | | npx mp-skills setup | 安装后初始化环境 | Step 5 引导 | | npx mp-skills validate <project-dir> | 校验已安装的 Skill 是否有问题 | 用户要求检查时 | | npx mp-skills eval | 端到端评测 | 用户要求评测时 |

可用仓库：

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

硬性约束

A. 项目检查

| 条件 | 说明 | |------|------| | 目标项目存在 project.config.json 和 app.json | 否则无法安装，提示用户确认项目路径 | | 安装后必须执行 npx mp-skills setup | 聚合云函数、创建数据库、写入环境配置 |

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

| 阻断情况 | 处理方式 | |---------|---------| | 用户未指定搜索关键词 | 先问清楚功能需求，不要用空关键词搜索 | | 搜索无结果 | 提示换关键词重试，或推荐 --all 查看全部可用 Skill | | 用户想安装的 Skill 已存在 | 提示已安装，询问是否覆盖 |

工作流

Step 1 — 理解需求

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

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

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

Step 2 — 搜索 Skill

执行搜索命令：

npx mp-skills find <keyword>

输出类似：

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 <skill-name>

安装完成后输出类似：

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

Step 5 — 引导后续

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

cd <项目目录>
npx mp-skills setup

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