技能发现与推荐

技能文档

---
name: jeongsk-finding-skills
title: 技能发现与推荐
category: 开发工具
description: 按功能与目的检索并推荐合适的技能和插件，本地精选数据库优先、SkillsMP 社区接口实时补充，输出含功能、来源、热度与安装方式的推荐报告。当用户想找某类功能的技能、搜索插件、获取 PDF/Git/代码评审/前端等场景的工具推荐时使用。当用户说「有没有 XX 功能的技能」「推荐个处理 XX 的插件」「找个自动化工具」时触发。触发词：找技能、技能推荐、插件搜索、工具发现、技能检索。
---

# 技能发现与推荐

按用户想要的功能或目的，推荐合适技能与插件的对话式助手。

## 资源

- **本地技能数据库**：`references/external-skills-database.json`，收录精选官方与社区技能
- **联机检索脚本**：`scripts/search_skills.py`，实时检索社区技能

## 技能工作流

### 步骤1：理解用户意图

用户以下述方式提出请求时本技能激活：

- 「有能处理 PDF 的技能吗？」
- 「帮我找辅助 Git 提交的插件」
- 「推荐代码评审自动化工具」
- 「前端开发有什么好用的技能？」
- 其他按功能或目的找技能的请求

先从请求中提取核心功能关键词；中文关键词同时准备对应的英文版本（如「PDF 处理」→ `pdf`、「代码评审」→ `code review`）。

### 步骤2：检索本地精选数据库

读取 `references/external-skills-database.json`：

1. 用关键词在 `searchIndex.keywords` 中定位相关技能 ID
2. 按类别浏览 `categories`，补充同领域的候选
3. 官方与精选技能优先匹配

### 步骤3：联机检索社区技能（本地结果不足时）

本地库结果不够或需要更多社区选择时，运行检索脚本：

```bash
python3 scripts/search_skills.py "英文搜索词" --limit 5
```

脚本选项：

- `--limit N`：返回条数（默认 10，建议 5）
- `--page N`：页码（默认 1）
- `--sort stars|recent|name`：排序（默认 stars）
- `--format json|text`：输出格式（默认 json）

响应为统一 JSON 结构：`skills` 数组含 `name`/`author`/`description`/`stars`/`githubUrl`/`hasMarketplace`，用 `stars` 判断热度，`githubUrl` 提供来源仓库。

### 步骤4：合并去重并筛选

- 合并本地数据库结果（精选）与脚本结果（社区、最新）
- 去重后按相关性与热度排序
- 最终精选 3-5 个最相关技能，兼顾官方与社区选项

### 步骤5：输出推荐报告

对每个推荐技能给出：

```text
## 推荐技能：[名称]

**简介**：[技能说明]
**来源**：[官方 / 社区 / 作者]
**热度**：⭐ [stars 数]（联机结果时）
**标签**：[相关标签]

### 主要功能
**[类别 1]**
- 功能 1
**[类别 2]**
- 功能 2

### 安装方式
[参考来源仓库 README，按目标 Agent 平台的技能安装方式引入]

### 适用场景
- 场景 1
- 场景 2
```

多个技能相关时，先介绍最合适的，再简要列出其余选项，交由用户选择。

## 检索策略

- 中文检索词先转英文再查（脚本对英文支持最好）
- 多关键词时逐个检索后合并，或用空格分隔直接检索
- 优先级：本地库官方技能 → 本地库精选插件 → 社区热门（stars 排序）→ 社区资源

## 异常处理

| 场景 | 处理方式 |
|------|----------|
| 本地库文件缺失 | 提示用户检查技能安装完整性，改用联机检索 |
| 本地库 JSON 损坏 | 跳过本地库，仅用联机结果 |
| 脚本执行失败 | 仅展示本地数据库结果 |
| 响应 `success: false` | 读取 error 信息，忽略后继续 |
| 检索超时 | 提示「联机检索无响应，仅展示本地结果」 |
| 两边都无结果 | 建议换英文关键词重试，或到技能社区直接浏览 |

## 附注

- 本地数据库会定期更新，参考其中 `lastUpdated` 字段判断新鲜度
- 官方技能由各 AI 公司维护，社区技能由个人开发者维护，安装前建议先做安全审查

使用说明

# 技能发现与推荐

按功能与目的检索推荐技能：本地精选数据库优先，社区接口实时补充，输出结构化推荐报告。

## 使用

```text
有没有能处理 PDF 的技能？帮我推荐几个
```

```text
找个辅助 Git 提交的插件
```

联机检索社区技能：

```bash
python3 scripts/search_skills.py "pdf" --limit 5
python3 scripts/search_skills.py "git commit" --sort recent
```

## 工作原理

按「理解意图 → 本地库检索 → 联机补充 → 合并筛选 → 推荐报告」五步工作：先从请求提取关键词查 `references/external-skills-database.json` 精选库，不足时用 `scripts/search_skills.py` 调 SkillsMP 接口实时检索社区技能，合并去重后精选 3-5 个，给出功能、来源、热度与安装方式。

如何安装此技能？

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