Finder 技能检索器

它解决什么问题

当你想在一堆已发布的技能里找到某个能完成任务的 SKILL，手工翻 SkillHub 页面并不现实——关键词匹配常常漏掉语义相近但命名不同的技能，而且你拿到的链接未必对应最新发布版本。Finder 把这件事拆成两步自动化：先在 RagFlow 技能知识库里做向量检索拿到候选清单，再通过 SkillHub API 逐个取真实版本号，最终拼出可直接访问的 SKILL.md 文件链接。

核心能力与工作流程

检索阶段——调用 RagFlow 的向量检索接口，传入 query 文本，返回与 query 语义相近的技能条目。检索需要 RAGFLOW_API_KEY，优先级为环境变量 RAGFLOW_API_KEY > 内置混淆 Key，可用 $env:RAGFLOW_API_KEY = "your-key" 设置。

解析阶段——拿到候选技能后，向 SkillHub API 请求版本列表，Public 技能无需认证即可获取。用返回的真实版本号拼接出 skillhub_url，这个链接可以直接下载 SKILL.md 原文。

输出结构——统一 JSON 格式，success 标记是否成功，message 给出结果描述，skills 数组里每条包含 id、name、namespace、slug 和 skillhub_url。

Registry 集成——SkillHub 暴露了标准 Discovery Endpoint（/.well-known/clawhub.json），可以直接走 SkillHub Registry API 搜索技能，也可以配置 ClawHub CLI 把 SkillHub 作为 registry 源。

坐标规则与可见性

SkillHub 支持两种命名格式：@global/my-skill 对应 ClawHub 规范的 my-skill，@team-name/my-skill 对应 team-name--my-skill。-- 是兼容层中的命名空间分隔符，没有 -- 的技能被视为 @global/...，latest 仅解析为最新发布版本。

命名空间可见性分三层：@global 命名空间 PUBLIC 可见，可匿名搜索、查看、下载；Team 命名空间虽 PUBLIC 可见，但下载需要认证；NAMESPACE_ONLY 仅命名空间成员可访问，PRIVATE 仅所有者或授权用户可访问。

适用边界

向量检索的质量取决于 RagFlow 知识库的覆盖范围，如果知识库里没有收录某个技能，检索阶段就找不到它。内置混淆 Key 仅作为兜底，不建议用于正式环境，生产场景下应显式配置 RAGFLOW_API_KEY。SkillHub API 和 RagFlow 服务地址在 SKILL.md 里写的是 integ 环境的内网地址，实际使用时可能需要替换为可用的 endpoint。