| name | wxa-find-skills |
| description | 搜索和安装社区小程序 AI Skill。当用户想在现有小程序项目中添加 AI 能力，但不确定有什么可用的社区 Skill，或不想从头开发时触发。可以从 TencentCloudBase/awesome-miniprogram-skills 等仓库搜索、查看详情并安装。 |
| metadata | {"author":"TencentCloudBase"} |
| version | 0.2.0 |
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 的用途。
搜索无结果时：
- 建议换关键词重试
- 或执行
npx mp-skills add TencentCloudBase/awesome-miniprogram-skills --all 查看全部可用 Skill
- 或转
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、初始化数据库。
之后用微信开发者工具打开项目即可预览。
ClawHub
https://clawhub.ai/binggg/wxa-find-skills
安装：npx skills add TencentCloudBase/mp-skills -s wxa-find-skills
