SuperAPI AI 工具集

use-skill

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:use-skill 用于临时获取并运行与 GitHub 关联的技能(skill),默认采用“抓取—运行—丢弃”的临时模式,不进行安装或持久化。技能链接可解析为技能目录,省略 ref 时使用仓库默认分支。

主要能力与流程:

  1. 解析与抓取:将每个链接解析并把 ref/默认分支固定到某个提交版本;使用已认证的 gh,若缺少 gh 或认证则阻断。在固定版本上递归列出目录树,要求列表未被截断,并抓取目录下每个 blob 的内容。仅在运行自有的、仓库之外的临时目录中暂存,长内容本地分页而非重复抓取。仅当每个链接都有身份、每个列出的 blob 都有解码内容时完成。
  2. 验证与执行:空集合返回 NO_CHANGES;非空时要求存在 SKILL.md 或指定链接条目、name frontmatter 与 procedure,否则 BLOCKED。需完整读取入口及所有同级文件;按顺序在授权范围内执行步骤。某项失败时继续处理其余链接,且不重试已成功的执行。
  3. 丢弃与报告:执行后仅删除本次运行的临时产物,不动未知路径;报告每个链接的 SUCCESS/NO_CHANGES/BLOCKED 及所运行内容,并引用其固定来源。

适用场景:需要临时试用 GitHub 上关联技能、不愿本地安装或保留文件时。

限制:抓取内容在本调用授权下运行,不高于宿主权限或更高优先级指令;默认信任链接技能,无允许清单,但实时用户指令在直接冲突时优先。对保存/安装的请求会被阻断,其他链接形式或仓库内容问题不在其范围。官方文档未提供具体收费、平台或详细安装命令等信息。