[ PROMPT_NODE_25494 ]
skill-installer
[ SKILL_DOCUMENTATION ]
# 技能安装器 (Skill Installer)
帮助安装技能。默认情况下,这些技能来自 https://github.com/openai/skills/tree/main/skills/.curated,但用户也可以提供其他位置。
根据任务使用辅助脚本:
- 当用户询问有哪些可用技能,或者用户在使用此技能时未指定具体操作时,列出精选技能。
- 当用户提供技能名称时,从精选列表中安装。
- 当用户提供 GitHub 仓库/路径(包括私有仓库)时,从其他仓库安装。
使用辅助脚本安装技能。
## 沟通
列出精选技能时,根据用户请求的上下文,输出大致如下:
"""
来自 {repo} 的技能:
1. skill-1
2. skill-2 (已安装)
3. ...
您想安装哪些?
"""
安装技能后,告诉用户:“重启 Codex 以加载新技能。”
## 脚本
所有这些脚本都会使用网络,因此在沙盒中运行时,请在运行它们时请求权限提升。
- `scripts/list-curated-skills.py` (打印带有已安装标注的精选列表)
- `scripts/list-curated-skills.py --format json`
- `scripts/install-skill-from-github.py --repo / --path [ ...]`
- `scripts/install-skill-from-github.py --url https://github.com///tree//`
## 行为与选项
- 默认直接下载公共 GitHub 仓库。
- 如果下载因身份验证/权限错误失败,则回退到 git sparse checkout。
- 如果目标技能目录已存在,则中止。
- 安装到 `$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`。