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 --helpmp-skills 所有命令的帮助执行前确认命令参数npx mp-skills find <keyword>搜索远程仓库中的 SkillStep 2 搜索npx mp-skills list列出已安装 Skill（避免重复安装）Step 4 安装前npx mp-skills add <repo> --skill <name>安装指定 SkillStep 4 安装npx mp-skills add <repo> --all安装全部 SkillStep 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#

执行搜索命令：

bash

npx mp-skills find <keyword>

输出类似：

text

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（避免重复安装）：

bash

npx mp-skills list

然后安装：

bash

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

安装完成后输出类似：

text

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

Step 5 — 引导后续#

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

bash

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

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