SkillHub 技能检索与推荐

要解决什么问题

SkillHub 平台提供了一个公开检索接口 GET https://api.skillhub.cn/api/skills，关键词参数走的是分词搜索。这带来一个常见陷阱：用户用一句自然语言表达需求，比如「帮我自动写周报发给老板」，直接把这句话丢给接口，召回结果往往很稀疏——口语化的表达、中英混杂的措辞，很难命中技能库里的标准命名。

结果是，一次搜索、直接展示原始列表的做法，要么漏掉真正能用的技能，要么把一堆不相关的结果推到用户面前。

它是怎么工作的

这个技能把「找技能」拆成五个必须走完的步骤，不允许拿原话搜一次就结束：

• 理解场景：从用户输入中提取任务意图、领域标签（映射到 12 个一级 category，如 office-efficiency、data-analysis）以及 2~4 个中英文同义/上位关键词。
• 多次搜索：每个候选词各调一次接口，可叠加 category 或 labels 收窄范围，结果合并后按 slug 去重。
• 意图匹配排序：结合 name 和 description 判断契合度，过滤无关项，选出最契合的 3~5 个；同档位按下载与安装量降序。命中过多则收窄标签，结果为空则放宽同义词。
• 输出推荐：统一格式，每条附匹配理由，由用户选择，列表里不出现任何命令行或代码块。
• 一键安装：用户选定后才触发，命令由 Agent 直接执行并检查目录，装完只做一句确认。

适用边界与注意点

• 一级标签共 12 个，映射意图时需要按需加载对应的详情文件做渐进式披露，而不是一次性读全量索引。
• 接口无需鉴权，但关键词召回能力有限，搜索次数是硬约束——漏掉一次候选词扩展，就可能错过结果。
• 平台另有 /api/v1/search 路径，本技能明确不使用它，这一点在接入时要注意区分。