SuperAPI AI 工具集

skill-installer

编程与开发

查看项目

更新于 11-02 23:20

技能介绍

Skill Installer 用于帮助用户安装 Codex 技能,默认来源为 OpenAI 官方技能仓库的精选目录,也允许用户提供其他位置(包括私有仓库)。

用途:

  • 列出可安装技能:当用户询问有哪些可用技能,或未指定操作时,默认列出精选(.curated)技能;用户询问实验性技能时,可传入 --path skills/.experimental 列出实验目录,并标注来源。
  • 从精选列表安装:用户提供技能名称时,从精选列表安装。
  • 从其他仓库安装:用户提供 GitHub 仓库/路径(含私有仓库)时,从该位置安装。

主要能力与脚本:

  • scripts/list-skills.py:打印技能列表并标注已安装项;可用 --format json 输出 JSON;可用 --path 指定列表来源,例如 scripts/list-skills.py --path skills/.experimental。
  • scripts/install-skill-from-github.py:支持 --repo <owner>/<repo> --path <path/to/skill> [更多路径],也支持 --url https://github.com/<owner>/<repo>/tree/<ref>/<path>。示例:scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>。多个 --path 可一次安装多个技能,默认以路径基名命名,可用 --name 指定名称。

行为与选项:

  • 公开 GitHub 仓库默认直接下载;若因认证/权限错误失败,回退到 git 稀疏检出(先试 HTTPS,再试 SSH)。
  • 目标技能目录已存在时中止。
  • 安装到 $CODEX_HOME/skills/<skill-name>,默认 ~/.codex/skills。
  • 选项包括:--ref <ref>(默认 main)、--dest <path>、--method auto|download|git。
  • 私有 GitHub 仓库可通过现有 git 凭据或可选的 GITHUB_TOKEN/GH_TOKEN 访问。

使用方式:

  • 所有脚本使用网络,在沙箱中运行时需申请提权。
  • 精选列表通过 GitHub API 从官方仓库获取;若不可用,应说明错误并退出。
  • 安装完成后告知用户技能将在下一轮对话中可用。
  • 官方 .system 目录中的技能为预装,无需安装;如用户坚持,可下载并覆盖。
  • 已安装标注来自 $CODEX_HOME/skills。

适用场景:

  • 查询可安装的 Codex 技能清单。
  • 按名称安装官方精选技能。
  • 从指定 GitHub 仓库或路径安装自定义或实验性技能。

限制:

  • 依赖网络访问与 GitHub API 可用性。
  • 目标目录已存在时会中止安装。
  • 私有仓库访问依赖已有凭据或令牌。