OpenAI Skills
安装固定版本的 OpenAI 技能：目标目录、回退路径与部分成功
阅读旧安装器的真实行为：明确修订和目标目录、整库压缩包与稀疏 Git、已有目录拒绝，以及多技能安装不是原子事务。
你将学会
- 安装是文件变更，不是服务部署
- 理解可能执行哪条获取分支
- 复制多个目录之前先考虑恢复
开始前需要
- 基础 Git、Python 与命令行知识
- 明确的仓库检查与修改权限边界
解释本章源码行为，应用验收清单，并区分目录与宿主。
先看结论
- 明确提交、所选路径和待审目标目录。
- auto 只覆盖特定 HTTP 回退，不是任意错误重试。
- 多技能安装可能出现部分成功。
安装是文件变更，不是服务部署
所查安装器把选定技能目录复制到目标位置。默认位置根据 CODEX_HOME 推导，否则使用用户的 .codex 目录；--dest 可以指定另一处。下面示例故意使用审查目录。复制到那里只是暂存待审材料，不能证明当前宿主会发现或启用它。
应固定完整提交，并将仓库内路径独立传入。URL 解析器只把 tree 或 blob 后的一个路径片段视为 ref，因此含斜杠的分支名称在这种输入形式下有歧义。使用 --repo、--ref 与 --path 可以避免这一特定拆分问题。示例是操作参考，不表示本次已安装技能。
理解可能执行哪条获取分支
下载模式从 codeload 获取仓库压缩包，先读入内存，再写入临时文件并解压。auto 模式先尝试这条路径，但只有安装器错误包含 HTTP 401、403 或 404 时才进入其回退分支。普通超时或无效压缩包不是该分支的通用重试信号，不能将 auto 描述成任何失败都能靠 Git 恢复。
Git 路径请求浅克隆、对象过滤和稀疏检出，并在其捕获到的失败路径上从 HTTPS 尝试 SSH。这些方式依赖机器已有的凭据和信任设置。出现错误时应定位真正失败的分支，而不是为了让教程看起来成功就关闭证书或主机密钥检查。
复制多个目录之前先考虑恢复
对于每个选择路径，安装器检查目标名称，拒绝已有目标，确认源目录中存在 SKILL.md，再复制目录。它没有完成全面的结构、脚本或依赖审计。另外，--name 只在选择一个路径时生效，不是对多路径中的每个条目统一重命名。
复制循环逐项执行。如果后面的目录冲突或源文件不合格，前面成功复制的内容不会由批量事务回滚。临时仓库清理与已安装目录回滚是两件事。失败后应盘点实际目标并保留旧内容，经过明确的发布流程再启用新目录，不要不断删除目录直到命令不报错。
实施步骤
- 1
记录提交，检查对应许可证。
- 2
在隔离目标审查压缩包和脚本内容。
- 3
保留已有技能，明确处理目录冲突。
- 4
启用前验证宿主发现和任务行为。
可复制示例
python /path/to/reviewed/install-skill-from-github.py --repo openai/skills --ref 49f948faa9258a0c61caceaf225e179651397431 --path skills/.curated/gh-fix-ci --dest ./skill-review --method download常见问题
示例会写入当前启用的 Codex 技能目录吗？
示例显式选择 ./skill-review，而不是默认位置。它用于暂存审查，宿主启用需要单独确认。
批量命令失败后可能已经复制了一部分吗？
可能。所查主循环逐项复制，后续失败不会回滚此前成功的条目。
资料来源
- README.md来源核查 2026-09-08
- skills/.system/skill-installer/SKILL.md来源核查 2026-09-08
- skills/.system/skill-installer/LICENSE.txt来源核查 2026-09-08
- skills/.system/skill-installer/scripts/install-skill-from-github.py来源核查 2026-09-08
- skills/.system/skill-installer/scripts/github_utils.py来源核查 2026-09-08
- skills/.system/skill-installer/scripts/list-skills.py来源核查 2026-09-08
- skills/.system/skill-creator/scripts/quick_validate.py来源核查 2026-09-08
- skills/.system/skill-creator/references/openai_yaml.md来源核查 2026-09-08
- skills/.curated/gh-fix-ci/SKILL.md来源核查 2026-09-08
- skills/.curated/gh-fix-ci/scripts/inspect_pr_checks.py来源核查 2026-09-08
- skills/.curated/gh-fix-ci/agents/openai.yaml来源核查 2026-09-08
- skills/.system/plugin-creator/SKILL.md来源核查 2026-09-08
- 当前官方技能指南来源核查 2026-09-08