SkillHub 技能检索

要解决什么问题

用户在对话里用自然语言描述需求时，Agent 往往不知道 SkillHub 上是否已有对应技能，也容易用一句原话调一次搜索接口就结束。公开接口 GET https://api.skillhub.cn/api/skills 支持分词关键词检索，但召回有限；若误用 /api/v1/search 或不做意图收窄，推荐列表会噪音很大。

技能如何工作

本技能规定一套固定流程，让 Agent 在平台内「找技能」而不是随便猜 slug：

• Step 1 · 理解场景：从用户话里抽出任务意图、可映射的 category、以及 2～4 个中英文同义/上位关键词。
• Step 2 · 多次搜索：对每个候选词调用 ?keyword=...&sortBy=score，必要时叠加 category / labels，合并结果并按 slug 去重。
• Step 3 · 意图匹配排序：结合 name 与 description 过滤无关项，保留最契合的 3～5 条；命中过多则收窄标签，为空则放宽关键词。
• Step 4 · 输出推荐：统一格式，每条写明匹配理由，请用户选择；此步不得展示安装命令或代码块。
• Step 5 · 一键安装：仅在用户选定后由 Agent 自行检查 skillhub CLI 并执行 skillhub install --dir（细节见 references/api.md）。

一级 category 共 12 类（如 office-efficiency、ai-agent 等），需要时再查 references/categories.md 做渐进式披露。

适用边界

• 依赖 SkillHub 公开 API 与平台目录结构；参数与字段以 references/api.md 为准。
• 分词搜索不能保证一次命中，必须走完多词搜索与人工（模型）层面的意图筛选，不能把原始 API 列表直接丢给用户。
• 安装属于 Agent 执行动作，与用户可见的推荐文案应严格分离。