查找 Skill

查找 Skill

Overview

用于主动判断当前 agent 是否需要额外 skill：先检查内置能力是否足够，再检查本地 agent 是否已有合适 skill，最后从 LeapSkills 公开市场发现、筛选、推荐和安装新 skill。

默认 API base URL：

https://leapskills.leapinfra.cn

可用环境变量覆盖：

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，例如：

node skills/find-skills/scripts/leapskills-find-install.mjs local "PPT slides presentation"

1. 如果本地已有高相关 skill，优先按本地 skill 继续执行或向用户确认。
2. 如果内置能力和本地 skill 都没有合适结果，优先拉取 LeapSkills 全量已审核目录，让 agent 根据名称、slug、摘要、标签和分类判断是否相关。
3. 全量目录接口不要带 `query`、`page`、`pageSize` 或 `limit`：

GET /api/skills?sort=hot&reviewed=true

1. 如果全量目录太大、接口失败，或 agent 判断后仍不确定，再从用户目标中提取 1-3 组关键词补充搜索，优先使用中文原词，必要时补英文同义词：

GET /api/skills?query={query}&sort=hot&reviewed=true&pageSize=10

1. 根据名称、slug、摘要、标签、分类、安全状态和风险等级筛选候选项。
2. 推荐 3-5 个候选 skill，并说明适用理由。
3. 用户明确选择 slug 后，再下载、校验并安装。

Script

本 skill 自带一个无 npm 依赖的辅助脚本：

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

默认安装目录：

$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 为准。