Codex Skills 是 Codex 拓展任務(wù)能力的核心機制，遵循開源標準，以文件夾形式封裝指令、腳本與資源。依托漸進式加載機制，它可節(jié)約 Token、提升運行效率。本文完整講解 Skills 定義、核心優(yōu)勢，手把手演示內(nèi)置工具創(chuàng)建與手動搭建兩種方式，同時介紹技能調(diào)用方法，并搭配創(chuàng)建文件夾實戰(zhàn)案例，幫助開發(fā)者快速掌握 Codex 技能拓展。

一、Skills

什么是 Codex Skill?

Skills 是任務(wù)特定的能力包，本質(zhì)上就是一個文件夾，包含指令、腳本和資源。它遵循開源標準 http://agentskills.io。

一個 Skill 的核心是 SKILL.md 文件，用 Markdown 格式編寫，包含元數(shù)據(jù)和詳細指令。

Skills 的設(shè)計非常聰明：采用“漸進式加載”（progressive disclosure）機制。Codex 在初始上下文只加載 Skill 的名稱和簡短描述（避免浪費 token），只有當真正需要時，才讀取完整指令。這讓 Codex 在處理長任務(wù)時保持高效。

Skills 的主要優(yōu)勢

• 可靠執(zhí)行特定工作流：如自動修復 CI 失敗、集成任務(wù)管理工具等。
• 易共享：團隊或社區(qū)可以輕松分發(fā) Skill，支持跨平臺（如從 Claude 遷移到 Codex）。
• 上下文高效：不污染主提示，只在需要時激活。
• 可擴展：支持可選腳本、參考文檔和資源文件。

Codex 自帶幾個系統(tǒng) Skill，如 plan（規(guī)劃復雜任務(wù)）、skill-creator（創(chuàng)建新 Skill）和 skill-installer（安裝 Skill）。

二、如何創(chuàng)建 Skills

2.1 使用內(nèi)置 skill-creator

在 Codex 中直接調(diào)用 $skill-creator，然后描述你想要的 Skill 功能。

例如：“創(chuàng)建一個 Skill，用于處理 PDF 文件提取文本和表格，使用 pdfplumber 庫。”

Codex 會自動生成文件夾結(jié)構(gòu)和 SKILL.md 模板。

你還可以先用 $plan Skill 規(guī)劃，再結(jié)合 skill-creator 完善。

2.2 手動創(chuàng)建

在合適的目錄下創(chuàng)建一個文件夾（文件夾名即 Skill 名），然后添加 SKILL.md 文件?；靖袷饺缦拢?/p>

---
name: your-skill-name
description: 當用戶提到 XXX 時使用這個 Skill，幫助完成 YYY。
metadata:
    short-description: 可選的簡短用戶可見描述
---
# Skill 標題
這里寫詳細指令：一步步指導 Codex 如何執(zhí)行任務(wù)。
- 使用哪些工具或庫
- 處理邊緣情況
- 輸出格式要求
- 示例等

可選添加子文件夾：

• scripts/：存放可執(zhí)行腳本。
• references/：參考文檔。
• assets/：模板或其他資源。

Skill 存放位置（優(yōu)先級從高到低）：

• 項目當前目錄：.codex/skills/（適合當前 repo 專用）。
• 項目根目錄：repo_root/.codex/skills/（團隊共享）。
• 個人全局：~/.codex/skills/（默認位置）。
• 系統(tǒng)內(nèi)置：Codex 自帶，無法覆蓋。

更高優(yōu)先級的 Skill 會覆蓋同名低優(yōu)先級 Skill，便于自定義覆蓋。

三、如何使用 Skills

使用 Skills 有兩種方式：

顯式調(diào)用（推薦精確控制）：

• 在提示中直接寫 $.skill-name（例如 $.linear）。
• 或在 CLI/IDE 中使用 /skills 命令選擇。

自動選擇（更自然）：Codex 會根據(jù)你的任務(wù)描述，智能判斷并加載匹配的 Skill（依賴 description 字段寫得準確）。

輸入 codex 啟動，然后打一個斜杠，就可以看到 Skills 了。

輸入 /skills 進入技能菜單，然后輸入 skill-creator。也可以直接通過 $ 觸發(fā)功能菜單。

四、實戰(zhàn)案例

4.1 輸入命令

$skill-creator firstskill

4.2 輸出內(nèi)容

我將使用 skill-creator，因為你明確要創(chuàng)建一個新技能 firstskill。

先進入第 1 步：明確用途與觸發(fā)場景。請用簡短中文回答：

1. 這個 skill 要解決什么具體任務(wù)？
2. 給 2–3 句“用戶會怎么提問”的例子（觸發(fā)語句）。
3. 需要固定流程/腳本/參考資料嗎？如果有，是什么類型（scripts / references / assets）？
4. 預期輸出是什么樣（文字說明、命令、模板文件等）？

確認后我會給出技能命名、目錄結(jié)構(gòu)與最小 SKILL.md 草案。

輸入內(nèi)容：

收到。將按 skill-creator 繼續(xù)。

先確認觸發(fā)與命名（簡短回復即可）：

1. 觸發(fā)示例：給 2–3 條用戶可能的提問句子（中文即可）。
2. 技能名稱：建議 make-folder 或 create-folder，你更偏好哪一個？
3. 是否需要腳本？如果只用命令行創(chuàng)建目錄也可以不加 scripts/。你希望包含腳本嗎？

輸入內(nèi)容：

觸發(fā)演示例子：請幫我創(chuàng)建文件夾test，我要創(chuàng)建一個文件夾，創(chuàng)建文件夾等；名字就叫makefolder；我希望包含腳本。

4.3 輸出內(nèi)容

已按 skill-creator 建好 makefolder 技能骨架與腳本，保持精簡可用。

變更說明

• 新增 skills/makefolder/SKILL.md，包含觸發(fā)描述與使用規(guī)則
• 新增 skills/makefolder/scripts/make_folder.ps1，用于在當前項目創(chuàng)建單一文件夾

文件位置

• skills/makefolder/SKILL.md
• skills/makefolder/scripts/make_folder.ps1

下一步建議

試用腳本：./skills/makefolder/scripts/make_folder.ps1 test

如果你想改成中文說明或加入更多校驗規(guī)則，告訴我偏好。

然后項目目錄下，就會有一個 Skills 了。

Skills 下面有一個子文件夾叫 makefolder。

具體目錄結(jié)構(gòu)如下：

skills/
└── makefolder/
    ├── SKILL.md
    └── scripts/
        └── make_folder.ps1

總結(jié)

本文系統(tǒng)介紹 Codex Skills 相關(guān)知識，先闡明技能的定義、規(guī)范與低耗加載等核心優(yōu)勢，自帶規(guī)劃、創(chuàng)建、安裝等系統(tǒng)技能。文章講解內(nèi)置指令生成、手動編寫配置兩種創(chuàng)建方案，說明多優(yōu)先級存放目錄，介紹顯式調(diào)用與自動匹配兩種使用方式，并以新建文件夾為例完整實操演示，幫助讀者靈活拓展 Codex 自動化工作流。

以上就是Codex Skills是什么?Codex Skills高效拓展自動化任務(wù)的完整教程的詳細內(nèi)容，更多關(guān)于Codex Skills教學的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論