名称: 技能安装器 描述: 从精选列表或GitHub仓库路径安装Codex技能到$CODEX_HOME/skills。当用户询问可安装技能、安装精选技能或从其他仓库(包括私有仓库)安装技能时使用。 元数据: 简短描述: 从openai/skills或其他仓库安装精选技能
技能安装器
帮助安装技能。默认情况下,这些技能来自https://github.com/openai/skills/tree/main/skills/.curated,但用户也可以提供其他位置。实验性技能位于https://github.com/openai/skills/tree/main/skills/.experimental,可以用相同的方式安装。
根据任务使用辅助脚本:
- 当用户询问可用技能或未指定操作时列出技能。默认列出.curated,但如果用户询问实验性技能,可以传递–path skills/.experimental。
- 当用户提供技能名称时,从精选列表安装。
- 当用户提供GitHub仓库/路径(包括私有仓库)时,从其他仓库安装。
使用辅助脚本安装技能。
通信
列出技能时,根据用户请求的上下文输出大致如下。如果用户询问实验性技能,从.experimental而不是.curated列出,并相应标注来源: “”" 来自{repo}的技能:
- 技能-1
- 技能-2(已安装)
- … 您想安装哪些? “”"
安装技能后,告诉用户:“重启Codex以获取新技能。”
脚本
所有这些脚本使用网络,因此在沙盒中运行时,运行它们时请求升级。
scripts/list-skills.py(打印技能列表并标注已安装)scripts/list-skills.py --format json- 示例(实验性列表):
scripts/list-skills.py --path skills/.experimental scripts/install-skill-from-github.py --repo <所有者>/<仓库> --path <路径/到/技能> [<路径/到/技能> ...]scripts/install-skill-from-github.py --url https://github.com/<所有者>/<仓库>/tree/<引用>/<路径>- 示例(实验性技能):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<技能名称>
行为和选项
- 默认为公共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。