SkillHub 技能搜索

概述

SkillHub 技能查找（find-skill-skillhub）

通过公开接口 GET https://api.skillhub.cn/api/skills 查找平台 Skill（无需鉴权，关键词为分词搜索，不要用 /api/v1/search）。

接口参数 / 返回字段 / 更多示例 / 安装命令见 [references/api.md](references/api.md)。

适用与不适用

• 适用：用户想找人帮忙做某类事、先看看平台上有没有现成技能；按分类浏览技能库；选定技能后一键安装到当前 Agent。
• 不适用：从零新建一个技能（改用 create-skill 类技能）；修改、卸载、管理已安装技能；查询 SkillHub 以外的技能市场。

前置（零配置）

本技能零配置、无需鉴权：不依赖任何连接器、密钥或个人账号。唯一前置是网络可达 api.skillhub.cn；执行一键安装（Step 5）时需要当前机器有 Bash/curl，且沙箱环境需允许联网权限。

执行流程（核心五步）

关键词分词召回有限，必须走完五步，不要拿用户原话搜一次就结束。

Step 1 · 理解场景

从用户自然语言中提取：任务意图 + 领域标签（映射到 category）+ 中英文关键词（同义/上位词扩展，2~4 个）。

• 例："帮我自动写周报发给老板" → office-efficiency；周报/工作汇报/日报/weekly report

Step 2 · 多次搜索

每个候选词调 GET /api/skills?keyword=..&sortBy=score（必要时叠加 category/labels），合并结果并按 slug 去重。

curl -s "https://api.skillhub.cn/api/skills?keyword=周报&sortBy=score&pageSize=5" 
  | jq '.data.skills[] | {name, slug, downloads, installs, desc: .description_zh}'

Step 3 · 意图匹配排序

不要把原始列表直接丢给用户。结合 name+description 判断契合度，过滤不相关项，挑出最契合的 3~5 个：契合度优先，同档按热度（downloads/installs）降序。命中过多→category/labels 收窄；为空→去掉 category、换同义/上位词放宽。

Step 4 · 输出推荐

统一格式，每条必须给匹配理由，并请用户选择。只能输出下列字段，⛔ 严禁在推荐列表里出现安装命令 / curl / skillhub install / sh -c 等任何命令行或代码块——这是给用户看的，命令属于 Step 5 且由你执行而非展示：

🔍 为你找到 {N} 个相关技能：

1. {name} — {一句话用途（description_zh 优先）}
   匹配理由：{为什么适合这个场景}
   分类：{category 中文名} | 下载：{downloads} | 安装：{installs}
   主页：https://skillhub.cn/skills/{slug}

需要我帮你安装第几个？（回复"安装第N个"即可；都不合适我再换词搜）

Step 5 · 一键安装

用户选定后才进入本步，且命令由你直接执行（不要把命令行贴给用户看）：command -v skillhub 检查 → 未装则 install.sh --cli-only 仅装 CLI → skillhub install <slug> --dir <当前 Agent 的 skills 目录>（必须带 --dir，否则不被识别）。装完只回一句「✅ {name} 已安装」。各 Agent 目录与备用 zip 方式见 [references/api.md](references/api.md#一键安装用户选定后)。

一级标签（category）

12 个一级标签（?category=<key>），映射意图时按需打开对应详情文件（渐进式披露）。完整索引与说明见 [references/categories.md](references/categories.md)：

office-efficiency 办公效率 · content-creation 内容创作 · dev-programming 开发编程 · data-analysis 数据分析 · design-media 设计多媒体 · ai-agent AI Agent · knowledge-management 知识管理 · business-ops 商业运营 · education 教育学习 · professional 行业专业 · it-ops-security IT 运维与安全 · life-service 生活服务

Pitfalls（实测沉淀）

• 搜索接口只有 GET /api/skills 支持关键词分词搜索；误用 /api/v1/search 会查不到结果——单次原话搜索召回有限，必须多候选词多次搜索后合并去重。
• skillhub install 不带 --dir 会装到 ./skills/，Agent 不识别，技能装了等于没装。
• 首次安装 CLI 走 curl | bash，在沙箱/限网环境会失败，需以允许联网权限执行；仅需装技能时用 --cli-only，避免顺带装入默认 Skill。
• 接口返回的 homepage 字段是 api.skillhub.cn/<owner>/<slug> 格式，不是给人看的主页；拼主页一律用 https://skillhub.cn/skills/<slug>。
• 推荐列表里严禁出现命令行/代码块（用户会误粘贴执行），命令只属于 Step 5 且由 Agent 执行。
• 命中过多说明 category/labels 太宽，先收窄再推荐；命中为空先换同义/上位词放宽，不要直接回复"没有"。

Verification

• Step 2 每次搜索回读响应 code:0 且 data.skills 非空才算命中；全部候选词为空时换词放宽后再判"无结果"。
• Step 5 安装完成后，回读目标 skills 目录确认 <slug>/SKILL.md 已存在，再向用户回报「✅ {name} 已安装」。
• CLI 可用性以 skillhub --version 输出版本号为准。