SuperAPI AI 工具集

soia-meta-find-skill

智能体与模型

查看项目

更新于 10-16 08:40

技能介绍

用途:按客户目标在 SOIA 技能生态中检索并定位最匹配的技能,再指引宿主按需把该技能的 SKILL.md 读入上下文。它本身是路由技能,不替代目标技能。

主要能力:优先检索本机已安装、可立即加载的技能;本机无匹配时,从随技能发布的全生态目录定位未安装技能并给出精确安装命令;候选超过一个时列出相关性最高的 3 个,由当前模型结合原始需求选择。

使用方式:客户说明目标后,Agent 提取 1–3 个高区分度关键词,可选追加领域,运行: python3 scripts/find_skill.py --query <关键词> [--domain <领域>] 从仓库源码调用时使用: python3 skills/soia-meta-find-skill/scripts/find_skill.py --query <关键词> [--domain <领域>] 脚本向 stdout 输出 JSON 数组,最多 3 项;已安装项含 path,未安装项含 install_cmd。已安装候选需完整读取其 SKILL.md 才算加载。

安装:运行时只依赖 Python 3 标准库。插件路线: claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-meta@soia 单技能 npx 路线: npx skills add soia-team/soia-open-skills -g -a '' -s soia-meta-find-skill -y 注意技能会落进共享真源 ~/.agents/skills,若同时装插件会出现两份索引且各自漂移,建议二选一。WorkBuddy 装载单位是角色化专家,npx skills add -a '' 覆盖不到,需单独安装。安装会改变本机状态,应先展示命令并取得授权,安装后重新检索。

限制与边界:本机扫描范围仅为 ~/.agents/skills/*/SKILL.md,不读取技能私有配置、凭据或客户文件;查询与结果只输出到终端,不写缓存或日志。全生态目录为公开生成产物,不含账号、token、私有技能或本机路径。未命中时返回空列表,不猜造技能名。目录由元仓脚本从只读路由清单生成,普通运行不刷新目录。验证命令: python3 skills/soia-meta-find-skill/scripts/find_skill.py --query 剪藏 python3 scripts/generate_router_index.py --check