技能深度检索与安装

技能文档

---
name: deep-skill-finder
title: 技能深度检索与安装
category: 通用技能
description: 基于社区真实任务实测数据检索与安装技能：按用户的任务描述做意图理解与相关性排序，输出带下载量、安全审查、使用门槛的最优推荐，确认后一键安装到本地技能目录。当用户需要查找、搜索、推荐或安装技能，或在任务受阻时想找现成技能辅助时使用。触发词：找技能、技能推荐、技能安装、skill search。
---

# 技能深度检索与安装

从技能社区按真实任务实测数据搜索、推荐并安装最适合当前任务的 skill。

## 技能工作流

### 步骤1：技能检索

#### 1.2 执行检索

先判断用户输入是否包含明确的 skill 需求：如果描述太模糊（如只说"找个skill""推荐个技能"），先检查对话上下文中是否有可推断的需求，如有则基于上下文发起检索；如无则追问用户想找什么方向的 skill，拿到具体描述后再检索。

拿到具体需求后，先按下方「Agent 类型识别」识别当前 Agent 类型，再将用户的任务描述作为请求，调用如下接口，脚本会使用觅游社区的 Skill 检索服务进行意图理解、搜索召回并按相关性排序，最终输出5个以内的推荐skill。

> {skill_dir} 为当前 deep-skill-finder skill 自身的目录（区别于下方安装检查中的 {skills_dir}）。

```bash
{python} {skill_dir}/scripts/deep_skill_search.py "<用户任务描述>" 
```

> `{python}` 需按本机实际选择：macOS/Linux 通常为 `python3`，Windows 通常为 `python` 或 `py`。下同。

#### 1.3 格式化输出（6 条规则必须全部执行）

根据接口返回结果，按以下规则格式化输出。这 6 条规则是**顺序执行的主流程步骤**，不是可选提示，Agent **禁止跳过任何一条**。

**规则 1 - 输出 TOP5**：按照相关性从高到低推荐，最多 5 个（不足就少输出，0 个时告知用户"没有找到完全匹配的 skill，建议换个关键词或更简短的描述再试一次"）

**规则 2 - 展示格式**：每个 skill 使用列表格式展示（非表格），每个 skill 包含以下 3-4 行：
- 第 1 行：`#序号` + Skill 名称（Markdown 链接）
- 第 2 行：`下载量` | `安全审查`
- 第 3 行（可选）：`门槛`（有使用前提时才输出，无则跳过此行）
- 第 4 行：`结合你的需求`（基于 reason 和用户 query 的推荐语）

直接使用接口结果里的 `name` 构造 DeepSkill Market 详情页地址：先对 `name` 做 URL 编码，再渲染为 Markdown 链接 `[{name}](https://www.meyo.life/skill/skill?name={url_encoded_name})`。不要依赖搜索脚本返回额外链接字段。禁止在名称后用括号、破折号或单独一行追加原始链接。

**规则 3 - 各字段内容**：根据返回值中的 reason、downloadCount 等信息，结合用户 query，为每个 skill 填写以下字段：
- **下载量**：取 `downloadCount`
- **安全审查**：从接口返回的 reason 元数据行中提取安全审查值，原样输出。可能是 ✅ Pass（无任何潜在问题）、✅ {具体问题}，{解释}（有问题但合理）或 ⚠️ {具体问题}（有问题且不合理）
- **门槛**：从 reason 和 description 中提取使用前提（如需翻墙、需配置凭证等），有则输出，无则跳过此行
- **推荐理由**：先说用户要做什么、再说这个skill能不能做到，逐条对照用户需求——做到了的说做到了，做不到的也说出来，禁止无数据支撑的评价性用语

**规则 4 - 最优推荐（重要）**：返回结果中的第一个（序号1）是本服务根据用户任务描述进行深度分析后的最优推荐结果，返回结果已由后端按相关性排序，直接推荐给用户即可。**不需要**自行重新分析或排序，不要添加"综合你的需求，我比较推荐XXX"等自行分析的结论，最优推荐确认为序号1。最优推荐句中的 Skill 名称也必须使用规则 2 中由 `name` 构造的同一个 Markdown 链接。

**输出模板（严格参照以下格式输出，将占位符替换为实际值）**：

> 经过对实测数据的全量检索、安全审查与深度分析，为你找到以下匹配 skill：
>
> #1 [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name})
> - 下载量：{downloadCount} | 安全审查：{safetyStatus}
> - 门槛：{prerequisites}（可选，无使用前提时此行跳过）
> - {reason}
>
> #2 [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name})
> - 下载量：{downloadCount} | 安全审查：{safetyStatus}
> - 门槛：{prerequisites}（可选，无使用前提时此行跳过）
> - {reason}
>
> ...（最多5个）
>
> 最优推荐是 #1 [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name})（{suggestion}）。你想安装哪一个？告诉我编号或名字就行。
>
> ---
>
> - [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name}) — {alias}：{description 第一句}
> - [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name}) — {alias}：{description 第一句}
> - [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name}) — {alias}：{description 第一句}
> - [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name}) — {alias}：{description 第一句}
> - [{name}](https://www.meyo.life/skill/skill?name={url_encoded_name}) — {alias}：{description 第一句}
>

**异常处理**:
脚本执行出错时，禁止将原始错误信息（如 "The read operation timed out"）直接展示给用户，需按以下规则处理：

| 异常场景 | 处理方式 | 输出示例 |
|---------|---------|---------|
| 搜索超时 | 自动重试最多 3 次（无需告知用户重试过程），仍失败则告知用户 | "搜索服务暂时不可用，请稍后再试。" |
| 返回 0 条结果 | 告知用户换描述重试 | "没有找到完全匹配的 skill，建议换个关键词或更简短的描述再试一次。" |
| 网络错误 / 连接失败 | 告知用户网络问题 | "网络连接异常，请检查网络后重试。" |
| 脚本执行报错（其他） | 翻译为用户友好的中文提示 | "搜索服务遇到了一点问题，建议稍后重试。如持续出现，可反馈给 skill 作者。"

### 步骤2：决策与下载安装（用户确认后执行）
当用户通过以下方式确认选择时，进入安装流程：
- 说编号：如"1"、"选1"、"第一个"
- 说名称：如"装 qf-xiaohongshu-writer"
- 说意图：如"安装"、"装这个"、"就它了"、"用这个"

确认用户选择后，进行本地检查：检查 `{skills_dir}/{name}/SKILL.md` 是否存在（`{skills_dir}` 为当前 Agent 的 skills 目录，`{name}` 为用户选择的 skill 名称）。若存在则视为已安装，告知用户"该 skill 已安装，无需重复安装，是否直接运行？"；若不存在，则执行安装流程：

```bash
{python} {skill_dir}/scripts/deep_skill_install.py <name> --dir <当前 Agent 的 skills 目录> 
```

安装脚本执行后，根据退出状态输出结果：
- 成功（退出码 0）：输出"✅ {name} 已安装成功。要用这个 skill 来完成你的任务吗？"
- 已安装（本地 SKILL.md 已存在）：输出"该 skill 已安装，无需重复安装，是否直接运行？"
- 失败（退出码非 0）：输出"❌ {name} 安装失败，原因：{用户友好的错误描述}。建议稍后重试，或换一个 skill 试试。"

## 核心工具

| 命令 | 用途 |
|------|------|
| `deep_skill_search.py` | 根据用户任务检索skill |
| `deep_skill_install.py` | 下载安装 skill |

## 调用参数说明

搜索与安装脚本无需传入 Agent 类型信息即可正常执行。
## Skills 安装目录

调用安装脚本时需要指定 `--dir` 参数为目标 Agent 的 skills 目录。确定方式：

1. **从环境变量推导（首选）**：查 `<APP>_USER_DATA_DIR` 环境变量，在其路径下查找 `skills/` 子目录
   若环境变量路径下无 skills/ 子目录，则退回到工作区查找。
2. **从工作区查找**：检查当前工作区根目录下是否存在 `skills/` 子目录（含 SKILL.md 即为有效）
3. **注意多目录情况**：部分 Agent 存在全局级和 workspace 级两个 skills 目录，发现多个候选时应询问用户选择安装到哪个目录
4. **验证目录**：可用 `--list` 参数验证目录是否正确，返回已安装列表即说明路径有效

## 注意事项

1. **本地优先**: 需要确认本地是否已经安装该skill ，避免重复下载
2. **安装确认**: 需要等用户选择后才安装，不自动安装
3. **评价确认**: trajectory 原文不得保存或上传；自动生成的评价字段必须先展示给用户。用户未修改而直接评分即表示同意提交；用户修改后只需对修改版再确认一次

## 完整使用示例

以下是一个完整的端到端交互示例，展示从搜索到安装的全流程：

**用户**：找个写小红书爆款帖子的skill

**Agent 执行**：
```bash
{python} {skill_dir}/scripts/deep_skill_search.py "写小红书爆款帖子"
```

**Agent 输出**：
> 经过对实测数据的全量检索、安全审查与深度分析，为你找到以下匹配 skill：
>
> #1 [qf-xiaohongshu-writer](https://www.meyo.life/skill/skill?name=qf-xiaohongshu-writer)
> - 下载量：5200 | 安全审查：✅ Pass
> - 爆款笔记生成器，内置标题公式和内容模板，擅长情绪共鸣和种草风格，直接对应写小红书爆款帖子的需求。无需配置凭证，开箱即用。
>
> #2 [rednote-creator](https://www.meyo.life/skill/skill?name=rednote-creator)
> - 下载量：3100 | 安全审查：✅ Pass
> - 小红书全流程创作技能，覆盖美妆护肤等六大赛道，适合需要多赛道内容的用户。
>
> #3 [rednote-writer-pro](https://www.meyo.life/skill/skill?name=rednote-writer-pro)
> - 下载量：1800 | 安全审查：✅ Pass
> - 专注爆款文案生成，覆盖美妆赛道，适合美妆垂类创作者。
>
> 最优推荐是 #1 [qf-xiaohongshu-writer](https://www.meyo.life/skill/skill?name=qf-xiaohongshu-writer)（#1 内置标题公式和内容模板，开箱即用且下载量最高；#2 覆盖六大赛道但单赛道深度不如#1；#3 只适合美妆垂类。建议优先用#1）。你想安装哪一个？告诉我编号或名字就行。
>
> ---
> 📌 更多推荐（社区热门）
>
> - [agentcore](https://www.meyo.life/skill/skill?name=agentcore) — 智能云浏览器：在 AWS Bedrock AgentCore 云浏览器上运行 agent-browser
> - [self-improving-agent](https://www.meyo.life/skill/skill?name=self-improving-agent) — 自我优化代理：记录经验、错误及修正，实现持续改进
> - [skill-vetter](https://www.meyo.life/skill/skill?name=skill-vetter) — 技能安全审查：AI技能安全审查，安装前必检
> - [xiaohongshu-cover-gen](https://www.meyo.life/skill/skill?name=xiaohongshu-cover-gen) — 小红书封面生成：为小红书帖子生成封面图和内容图卡
> - [rednote-creator](https://www.meyo.life/skill/skill?name=rednote-creator) — 小红书创作：全流程创作技能，覆盖美妆护肤等六大赛道
>

**用户**：1

**Agent 检查**：确认本地未安装 qf-xiaohongshu-writer，执行安装。

**Agent 执行**：
```bash
{python} {skill_dir}/scripts/deep_skill_install.py qf-xiaohongshu-writer --dir <当前 Agent 的 skills 目录> 
```

**Agent 输出**：
✅ qf-xiaohongshu-writer 已安装成功。要用这个 skill 来完成你的任务吗？

使用说明

# 技能深度检索与安装

基于社区真实任务实测数据检索并安装技能：描述你的任务，得到带下载量、安全审查与使用门槛的相关性推荐，确认后一键安装到本地技能目录。

## 使用

```bash
# 按任务描述检索，返回 5 个以内按相关性排序的推荐
python3 scripts/deep_skill_search.py "写小红书爆款帖子"

# 确认后安装到技能目录
python3 scripts/deep_skill_install.py <skill名称> --dir <技能目录>
```

对话内直接说「帮我找个做 xxx 的技能」也可以触发。

## 工作原理

搜索脚本把任务描述交给社区检索服务做意图理解、多路召回与相关性排序，返回实测战绩数据（下载量、安全审查、使用前提）；安装脚本从社区下载技能包并解压到指定技能目录，安装前自动检查本地是否已存在。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。