技能查找

它解决什么问题

SkillHub 上的技能持续增多，拿用户一句自然语言直接搜索，要么召回一堆无关项，要么漏掉换个说法就命中的技能。find-skill 的目标很明确：把「用户想做什么」翻译成可检索的查询，再从结果里挑出真正能用的几个，而不是把原始列表丢回去。

核心流程

五步缺一不可，不要拿用户原话只搜一次就结束：

1. 理解场景：从自然语言中拆出任务意图、领域标签（映射到 category），以及 2~4 个中英文关键词，做同义词与上位词扩展。
2. 多次搜索：每个候选词调用 GET /api/skills?keyword=..&sortBy=score，必要时叠加 category/labels，合并后按 slug 去重。
3. 意图匹配排序：结合 name 与 description 过滤无关项，选出最契合的 3~5 个；契合度优先，同档按热度降序。命中过多就用标签收窄，为空则去掉 category、换同义词放宽。
4. 输出推荐：统一格式，每条给出匹配理由，请用户选择。
5. 一键安装：用户选定后才进入，命令由 Agent 直接执行，不展示给用户。

接口与分类

• 使用公开接口 https://api.skillhub.cn/api/skills，无需鉴权，关键词走分词搜索；不要使用 /api/v1/search。
• 12 个一级标签（如 office-efficiency、ai-agent），按需打开详情文件做渐进式披露，完整索引见 references/categories.md。

注意点

• 推荐列表里严禁出现安装命令、curl、代码块等内容，命令属于执行阶段而非展示内容。
• 安装时必须带 --dir 参数，否则不会被识别。
• 接口参数、返回字段与更多示例见 references/api.md。