建置技能
建置技能
為 Codex 提供新的能力和專業知識
使用代理技能，以特定任務所需的能力擴充套件 ChatGPT 和 Codex。一個 技能會將說明、資源和可選指令碼打包在一起，使兩款產品都能 可靠地遵循工作流程。技能基於 開放代理技能標準建置。
技能是可複用工作流程的編寫格式。外掛通過 ChatGPT 和 Codex 共享的 通用外掛目錄分發可複用技能和連接器。外掛適用於網頁版、 桌面版和移動版 ChatGPT 中的 Chat 和 Work、ChatGPT 桌面應用中的 Codex，以及 Codex CLI。先用技能設計工作流程本身；如果希望 其他人安裝它，再將其打包為 外掛。
獨立技能可用於 ChatGPT 桌面應用、Codex CLI 和 IDE 擴充套件。外掛中捆綁的技能還可用於網頁版、桌面版和移動版 ChatGPT 中的 Chat 和 Work。
在 ChatGPT 桌面應用中，開啟側邊欄中的技能，檢視和探索 在各個專案中建立的技能。
在 Codex 中，初始列表還會包含每項技能的檔案路徑。為避免 擠佔提示詞其餘部分，此列表最多使用模型上下文 視窗的 2%；當上下文視窗大小未知時，最多使用 8,000 個字元。如果安裝了許多 技能，Codex 會先縮短技能描述。對於大型技能 集合，Codex 可能會從初始列表中省略部分技能並顯示警告。
此預算僅適用於初始技能列表。當 Codex 選擇某項技能時，仍會讀取該技能完整的 SKILL.md 說明。
技能是一個目錄，其中包含 SKILL.md 檔案，還可選擇包含指令碼和參考資料。SKILL.md 檔案必須包含 name 和 description。
ChatGPT 和 Codex 如何使用技能
ChatGPT 和 Codex 可以通過兩種方式啟用技能：
- **顯式呼叫：**在提示詞中直接包含技能。在
ChatGPT 中，輸入
@以選擇技能。在 Codex CLI 或 IDE 擴充套件中，執行/skills或輸入$以提及技能。 - **隱式呼叫：**當你的任務與技能的
description匹配時，ChatGPT 或 Codex 可以選擇該技能。
由於隱式匹配依賴 description，請編寫簡潔且範圍與邊界
清晰的描述。將關鍵用例和觸發詞放在開頭，
這樣即使描述被縮短，宿主仍能匹配技能。
建立技能
如果你已經明確工作流程，並且演示比描述更容易，請使用 錄製與重放。錄製器會捕獲 工作流程、檢查步驟，並根據演示起草一項可複用技能。
如果希望通過描述建立技能，請使用內建建立器。在 ChatGPT
Work 中，以 @skill-creator 呼叫它。在 Codex 中，按如下方式呼叫：
$skill-creator建立器會詢問技能的用途、觸發時機，以及它應僅包含說明還是也包含指令碼。預設僅包含說明。
你也可以建立一個包含 SKILL.md 檔案的資料夾，手動建立技能：
---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---
Skill instructions for ChatGPT or Codex to follow.Codex 會自動檢測技能更改。如果更新沒有出現，請重啟 Codex。
Codex 從何處載入本機技能
Codex 從儲存庫、使用者、管理員和系統位置讀取技能。對於儲存庫，Codex 會掃描從當前工作目錄到儲存庫根目錄之間每個目錄中的 .agents/skills。如果兩項技能具有相同的 name，Codex 不會合並它們；兩者都可能出現在技能選擇器中。
| 技能範圍 | 位置 | 建議用途 |
|---|---|---|
REPO |
$CWD/.agents/skills 當前工作目錄：啟動 Codex 的位置。 |
如果你位於儲存庫或程式碼環境中，團隊可以簽入與某個工作資料夾相關的技能。例如，僅與某個微服務或模組相關的技能。 |
REPO |
$CWD/../.agents/skills 在 Git 儲存庫中啟動 Codex 時，位於 CWD 上方的資料夾。 |
如果儲存庫包含巢狀資料夾，組織可以簽入與父資料夾中共享區域相關的技能。 |
REPO |
$REPO_ROOT/.agents/skills 在 Git 儲存庫中啟動 Codex 時最頂層的根資料夾。 |
如果儲存庫包含巢狀資料夾，組織可以簽入與儲存庫所有使用者相關的技能。這些技能作為根技能，可供儲存庫中的任何子資料夾使用。 |
USER |
$HOME/.agents/skills 簽入使用者個人資料夾的所有技能。 |
用於整理適用於使用者可能處理的任何儲存庫、且與該使用者相關的技能。 |
ADMIN |
/etc/codex/skills 簽入計算機或容器共享系統位置的所有技能。 |
用於 SDK 指令碼和自動化，以及簽入可供計算機上每位使用者使用的預設管理員技能。 |
SYSTEM |
由 OpenAI 與 Codex 捆綁提供。 | 面向廣泛使用者的實用技能，例如 skill-creator 和計劃技能。每個人啟動 Codex 時都可使用。 |
Codex 支援通過符號連結連結的技能資料夾，並在掃描這些位置時跟隨符號連結目標。
這些位置用於編寫和本機發現。如果希望 在單個儲存庫之外分發可複用技能，或者選擇將技能與 連接器捆綁，請使用外掛。
通過外掛分發技能
直接使用技能資料夾最適合本機編寫和儲存庫範圍的工作流程。如果 希望分發可複用技能、將兩項或更多技能捆綁在一起，或 將技能與連接器一同發布，請將它們打包為 外掛。
外掛可以包含一項或多項技能。它們還可以選擇將 已註冊的 MCP 伺服器連線、捆綁的 MCP 伺服器設定以及 展示資源整合到一個軟體包中。
安裝精選技能供本機使用
要在自己的本機 Codex 環境中新增內建技能以外的精選技能，請使用 $skill-installer。例如，要安裝 $linear 技能：
$skill-installer linear你還可以提示安裝器從其他儲存庫下載技能。 Codex 會自動檢測新安裝的技能；如果某項技能未出現， 請重啟 Codex。
此方式適合本機設定和實驗。如需分發你自己的 可複用技能，優先使用外掛。
啟用或停用本機 Codex 技能
使用 ~/.codex/config.toml 中的 [[skills.config]] 條目，可以停用技能而不將其刪除：
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false更改 ~/.codex/config.toml 後，請重啟 Codex。
可選後設資料
新增 agents/openai.yaml，可在 ChatGPT 桌面應用中設定 UI 後設資料、設定呼叫策略並宣告工具依賴項，從而獲得更順暢的技能使用體驗。
interface:
display_name: "Optional user-facing name"
short_description: "Optional user-facing description"
icon_small: "./assets/small-logo.svg"
icon_large: "./assets/large-logo.png"
brand_color: "#3B82F6"
default_prompt: "Optional surrounding prompt to use the skill with"
policy:
allow_implicit_invocation: false
dependencies:
tools:
- type: "mcp"
value: "openaiDeveloperDocs"
description: "OpenAI Docs MCP server"
transport: "streamable_http"
url: "https://developers.openai.com/mcp"allow_implicit_invocation（預設值：true）：當值為 false 時，Codex 不會根據使用者提示詞隱式呼叫該技能；顯式 $skill 呼叫仍然有效。
最佳實踐
- 讓每項技能專注於一項工作。
- 除非需要確定性行為或外部工具，否則優先使用說明而非指令碼。
- 使用祈使句編寫步驟，並明確輸入和輸出。
- 使用測試提示詞驗證技能描述，確認觸發行為正確。
有關更多範例，請參閱 GitHub CI 修復、 PDF、 Linear、 openai/skills和 代理技能規範。對於 可安裝的分發形式，優先使用外掛。