技能安裝器
協助安裝技能。預設來源為 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. skill-1
2. skill-2(已安裝)
3. ...
您想安裝哪些?
安裝技能後,告知使用者在下次對話時即可使用。
腳本
所有這些腳本都會使用網路,因此在沙箱中執行時,請請求提升權限。
scripts/list-skills.py(列出技能清單並標註已安裝狀態)scripts/list-skills.py --format json- 範例(實驗性清單):
scripts/list-skills.py --path skills/.experimental scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>- 範例(實驗性技能):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>
行為與選項
- 公開 GitHub 倉庫預設使用直接下載。
- 若下載因驗證/權限錯誤失敗,則切換至 Git sparse checkout。
- 若目標技能目錄已存在,則中止安裝。
- 安裝至
$CODEX_HOME/skills/<skill-name>(預設為~/.codex/skills)。 - 多個
--path值可在一次執行中安裝多個技能,除非提供--name,否則每個技能以路徑的基名稱命名。 - 選項:
--ref <ref>(預設main)、--dest <path>、--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。