查找 Skill
Overview
用于主动判断当前 agent 是否需要额外 skill：先检查内置能力是否足够，再检查本地 agent 是否已有合适 skill，最后从 LeapSkills 公开市场发现、筛选、推荐和安装新 skill。
默认 API base URL：
`text
https://leapskills.leapinfra.cn
`
可用环境变量覆盖：
`bash
export LEAPSKILLS_API_URL=https://leapskills.leapinfra.cn
`
When To Use
- 用户问“有没有能做 X 的 skill”
- 用户没有提 skill，但提出可能适合专门 skill 的任务，例如“我要做一个 PPT”“帮我处理 PDF”“整理会议纪要”“生成产品视频”；此时先判断 agent 内置能力是否能直接完成
- 用户想比较多个可用 skill
- 用户希望把某个 LeapSkills skill 下载并安装到本地 agent
- 用户想扩展 agent 能力但不确定该用什么
Workflow
1. 对专业任务先检查 agent 内置能力是否足够，例如生图、生视频、PPT/文档生成、网页/代码实现、数据分析和文件处理等。若内置能力足够且用户没有要求找或安装 skill，直接完成任务。
2. 如果内置能力不足，或用户明确要找/下载/安装 skill，再检查本地已安装 skill，例如：
`bash
node skills/find-skills/scripts/leapskills-find-install.mjs local "PPT slides presentation"
`
3. 如果本地已有高相关 skill，优先按本地 skill 继续执行或向用户确认。
4. 如果内置能力和本地 skill 都没有合适结果，优先拉取 LeapSkills 全量已审核目录，让 agent 根据名称、slug、摘要、标签和分类判断是否相关。
5. 全量目录接口不要带 query、page、pageSize 或 limit：
`text
GET /api/skills?sort=hot&reviewed=true
`
6. 如果全量目录太大、接口失败，或 agent 判断后仍不确定，再从用户目标中提取 1-3 组关键词补充搜索，优先使用中文原词，必要时补英文同义词：
`text
GET /api/skills?query={query}&sort=hot&reviewed=true&pageSize=10
`
7. 根据名称、slug、摘要、标签、分类、安全状态和风险等级筛选候选项。
8. 推荐 3-5 个候选 skill，并说明适用理由。
9. 用户明确选择 slug 后，再下载、校验并安装。
Script
本 skill 自带一个无 npm 依赖的辅助脚本：
`bash
node skills/find-skills/scripts/leapskills-find-install.mjs local "PPT slides"
node skills/find-skills/scripts/leapskills-find-install.mjs list --json
node skills/find-skills/scripts/leapskills-find-install.mjs search "会议纪要"
node skills/find-skills/scripts/leapskills-find-install.mjs info meeting-minutes
node skills/find-skills/scripts/leapskills-find-install.mjs install meeting-minutes --dest ~/.codex/skills
`
默认安装目录：
`text
$CODEX_HOME/skills
~/.codex/skills
`
也可以用 --dest <dir> 指定当前仓库 skills/ 或其他本地 agent 能读取的目录。若目标 {dest}/{slug} 已存在，脚本会拒绝覆盖；确认要覆盖时加 --force。
Install Safety
安装流程会：
- 调 `GET /api/skills/{slug}` 获取详情。
- 使用 `download_url` 或 `/api/skills/{slug}/download` 下载 ZIP。
- 校验 `file_size`。
- 校验 `file_hash` 的 SHA-256。
- 确认 ZIP 根目录包含 `SKILL.md`、`README.md`、`_meta.json`。
- 解压到 `{dest}/{slug}`。
校验失败时不会安装。
Included Files
- `SKILL.md`: 核心触发条件和工作流。
- `scripts/leapskills-find-install.mjs`: 本地检查、全量目录、搜索、详情、下载校验和安装脚本。
- `_meta.json`: LeapSkills 发布元数据。
- `README.md`: 中文概览与使用说明。
- `test-prompts.json`: 测试触发样例。
Notes
- frontmatter 中的 `name` 保留英文 slug，便于 skill 系统稳定识别。
- 拉取目录、搜索和推荐可以直接执行；安装必须先让用户确认具体 slug。
- 主动触发应轻量：先检查内置能力，再检查本地 skill，再拉取 LeapSkills 全量目录判断，必要时才关键词搜索补漏，不要把简单问题过度流程化。
- 公开市场接口返回字段以 LeapSkills 当前生产 API 为准。