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

一、Skills

什么是 Codex Skill?

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

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

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

Skills 的主要優(yōu)勢(shì)：

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

Codex 自帶幾個(gè)系統(tǒng) Skill，如 plan（規(guī)劃復(fù)雜任務(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)建一個(gè) Skill，用于處理 PDF 文件提取文本和表格，使用 pdfplumber 庫(kù)。”

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

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

2.2 手動(dòng)創(chuàng)建

在合適的目錄下創(chuàng)建一個(gè)文件夾（文件夾名即 Skill 名），然后添加 SKILL.md 文件。基本格式如下：

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

可選添加子文件夾：

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

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

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

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

三、如何使用 Skills?

使用 Skills 有兩種方式：

• 顯式調(diào)用（推薦精確控制）：
  • 在提示中直接寫 $.skill-name（例如 $.linear）。
  • 或在 CLI/IDE 中使用 /skills 命令選擇。
• 自動(dòng)選擇（更自然）：
  • Codex 會(huì)根據(jù)你的任務(wù)描述，智能判斷并加載匹配的 Skill（依賴 description 字段寫得準(zhǔn)確）。

輸入 codex 啟動(dòng)，然后打一個(gè)斜杠，就可以看到 Skills 了。

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

四、實(shí)戰(zhàn)案例

4.1 輸入命令：

$skill-creator firstskill

4.2 輸出內(nèi)容：

我將使用 skill-creator，因?yàn)槟忝鞔_要?jiǎng)?chuàng)建一個(gè)新技能 firstskill。
先進(jìn)入第 1 步：明確用途與觸發(fā)場(chǎng)景。請(qǐng)用簡(jiǎn)短中文回答：

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

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

輸入內(nèi)容：

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

先確認(rèn)觸發(fā)與命名（簡(jiǎn)短回復(fù)即可）：

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

輸入內(nèi)容：

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

4.3 輸出內(nèi)容：

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

變更說(shuō)明

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

文件位置

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

下一步建議

1. 試用腳本：./skills/makefolder/scripts/make_folder.ps1 test
2. 如果你想改成中文說(shuō)明或加入更多校驗(yàn)規(guī)則，告訴我偏好。

然后項(xiàng)目目錄下，就會(huì)有一個(gè) Skills 了。
Skills 下面有一個(gè)子文件夾叫 makefolder。
具體目錄結(jié)構(gòu)如下：

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

總結(jié)

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

到此這篇關(guān)于掌握 Codex 漸進(jìn)加載 Skills,高效拓展自動(dòng)化工作流的文章就介紹到這了,更多相關(guān)Codex Skills自動(dòng)化工作流內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論