名称: 技能安装器 描述: 将Codex技能安装到$CODEX_HOME/skills目录,从精选列表或GitHub仓库路径安装。当用户询问可安装技能列表、安装精选技能或从其他仓库(包括私有仓库)安装技能时使用。 元数据: 简短描述: 从openai/skills或其他仓库安装精选技能
技能安装器
帮助安装技能。默认情况下,这些技能来自https://github.com/openai/skills/tree/main/skills/.curated,但用户也可以提供其他位置。
根据任务使用辅助脚本:
- 当用户询问可用内容或用户在不指定操作时使用此技能时,列出精选技能。
- 当用户提供技能名称时,从精选列表安装。
- 当用户提供GitHub仓库/路径(包括私有仓库)时,从其他仓库安装。
使用辅助脚本安装技能。
通信
列出精选技能时,根据用户请求的上下文,输出大约如下: “”" 来自{repo}的技能:
- 技能-1
- 技能-2(已安装)
- … 您想安装哪些? “”"
安装技能后,告诉用户:“重启Codex以获取新技能。”
脚本
所有这些脚本都使用网络,因此在沙盒中运行时,运行时请求提升权限。
scripts/list-curated-skills.py(打印带已安装注释的精选列表)scripts/list-curated-skills.py --format jsonscripts/install-skill-from-github.py --repo <所有者>/<仓库> --path <路径/到/技能> [<路径/到/技能> ...]scripts/install-skill-from-github.py --url https://github.com/<所有者>/<仓库>/tree/<引用>/<路径>
行为和选项
- 默认对公共GitHub仓库使用直接下载。
- 如果下载因认证/权限错误失败,回退到git稀疏检出。
- 如果目标技能目录已存在,则中止。
- 安装到
$CODEX_HOME/skills/<技能名称>(默认为~/.codex/skills)。 - 多个
--path值在一次运行中安装多个技能,每个技能名称来自路径的基础名,除非提供--name选项。 - 选项:
--ref <引用>(默认main)、--dest <路径>、--method auto|download|git。
注意事项
- 精选列表通过GitHub API从
https://github.com/openai/skills/tree/main/skills/.curated获取。如果不可用,解释错误并退出。 - 私有GitHub仓库可以通过现有git凭据或可选的
GITHUB_TOKEN/GH_TOKEN访问下载。 - Git回退先尝试HTTPS,然后SSH。
- https://github.com/openai/skills/tree/main/skills/.system 上的技能已预安装,因此无需帮助用户安装这些。如果用户询问,只需解释此情况。如果坚持,可以下载并覆盖。
- 已安装注释来自
$CODEX_HOME/skills。