Universal Skill Search(统一多源技能搜索路由器)
何时用
用户想要"找 / 搜一个能做 X 的 skill / agent 技能"。触发词示例:
"搜一下能做 X 的 skill"、"有没有能 X 的技能"、"find a skill for X"、"what skills can do X"、"帮我找找 X 相关的技能"、"全面市场检索"(= 对本技能已配置的全部市场并行检索)。
核心原则
- 只搜索、不安装。本技能只汇总候选;任何安装都需用户单独明确授权,且第三方源(ClawHub / GitHub)安装前必须过安全审计。绝不自动写盘安装。
- 四路并行搜索,最后合并、去重成一张统一表。
- 每条结果标注:来源 + 可信度(1-10) + 是否 WorkBuddy 可直接装。ClawHub / GitHub 结果默认标"需人工审计 / 格式未必适配 WorkBuddy"。
搜索路线(四条,互相独立可并行)
1) 官方 WorkBuddy 市场(BuiltinMarket)—— 可信度最高
调用 workbuddy_marketplace_skill 工具(deferred tool,需先 ToolSearch 取 schema):
- action = "search"
- keyword = 用户需求(中文 / 英文 / 片段均可)
- limit = 10(默认 5,上限 20)
返回官方审核技能,可直接用同一工具 action="install" 安装,格式天然适配 WorkBuddy。
2) SkillHub 商店(已装 CLI)—— 中可信度
用 Bash 执行(优先绝对路径,规避 PATH 遮蔽):
~/.local/bin/skillhub search "<query>"
若 ~/.local/bin/skillhub 不存在,回退:python3 ~/.skillhub/skills_store_cli.py search "<query>"。
装到 WorkBuddy 须:skillhub install <slug> --namespace <ns> --dir ~/.workbuddy/skills/(需用户授权)。
3) ClawHub(无 CLI,纯 WebSearch 检索)—— 低~中可信度
直接用 WebSearch(ClawHub CLI 上游 API schema 不兼容,已移除,统一走 WebSearch):
site:clawhub.ai "<query>" skill
site:clawhub.ai "<query>" agent
- ClawHub 技能多为 OpenClaw 格式;2026-02 发生过 ClawHavoc 事件(341+ 恶意 skill)。结果必须标"需审计、未必适配 WorkBuddy、安装前必过安全审计"。
- 安装(若用户后续要求):
git clone对应仓库,产物默认进./skills,需手动挪到~/.workbuddy/skills/并适配格式,且必过安全审计。
4) GitHub(本机无 gh / 无 token,用 WebSearch)—— 中可信度、噪声大
用 WebSearch:
site:github.com "SKILL.md" "<query>" agent skill
GitHub code-search API 需鉴权,本机无 token,故走 WebSearch。结果多为含 SKILL.md 的社区仓库,质量参差、未必是成品 skill,须标"社区仓库、需评估"。
输出格式(合并表)
搜完后输出一张 Markdown 表,按可信度降序:
| 来源 | 名称/标识 | 简介 | 获取方式 | 可信度 | 能否直接装 WorkBuddy |
|---|---|---|---|---|---|
| 官方市场 | ... | ... | marketplace 工具 install <id> | 9 | ✅ 直接 |
| SkillHub | ... | ... | skillhub install ... --dir ~/.workbuddy/skills/ |
6 | ⚠️ 需适配 |
| ClawHub | ... | ... | 需审计 | 5 | ❌ 需审计+适配 |
| GitHub | ... | ... | git clone 到 ~/.workbuddy/skills/ | 6 | ⚠️ 需评估 |
表前加一行状态说明:四路是否都成功、哪路失败回退了。
安装边界(重要,绝不自动)
本技能不调用任何安装命令。若用户看完表要装某个:
- 官方市场:用 workbuddy_marketplace_skill action="install";
- SkillHub:走 skillhub install --dir;
- ClawHub / GitHub:先单独做安全审计(读 SKILL.md、查作者/下载量/更新时间、扫恶意),获用户明确授权后再装,并需检查 WorkBuddy SKILL.md 格式兼容性。
已知坑(实现者注意)
- SkillHub 包装器在 Windows/Git-Bash 下存在 PATH 遮蔽:裸
skillhub可能指向系统 PyPI 同名旧包(0.1.0),务必用绝对路径~/.local/bin/skillhub。 - ClawHub 无 CLI(上游 API schema 不兼容,已移除),统一走 WebSearch;结果噪声偏大需人工筛选。
- 四路结果可能重复(同一技能多处出现),合并时去重,重复项在"来源"列合并。
- WebSearch 对 GitHub / ClawHub 回退会产生噪声,需在合并表里人工筛选掉明显无关的仓库。