一、Codex Skills 是什么

Codex Skills 是 OpenAI Codex（CLI/IDE 代理）的可復(fù)用工作流技能包，把「任務(wù)指令 + 腳本 + 參考資料」打包成標(biāo)準(zhǔn)化模塊，讓 AI 穩(wěn)定執(zhí)行特定開發(fā)任務(wù)，相當(dāng)于給 Codex 寫好的SOP 作業(yè)流程。

• 本質(zhì)：可復(fù)用、可共享、可版本化的自動化任務(wù)單元
• 核心價值：一次定義，隨處調(diào)用；減少重復(fù)提示詞，降低 token 消耗，提升結(jié)果一致性

二、Skill 結(jié)構(gòu)（標(biāo)準(zhǔn)格式）

每個 Skill 是一個文件夾，必須包含 SKILL.md，可選腳本 / 引用 / 資源：

my-skill/
├── SKILL.md       # 必選：名稱、描述、觸發(fā)條件、步驟、輸入輸出
├── scripts/       # 可選：輔助腳本（bash/python 等）
├── references/    # 可選：文檔、示例、規(guī)范
└── assets/        # 可選：配置文件、模板

SKILL.md 示例（YAML 頭信息 + 正文）（當(dāng)前為markdown格式示例，粘貼即可）

---
name: systematic-debugging
description: 系統(tǒng)化調(diào)試：復(fù)現(xiàn)問題→縮小范圍→定位根因→驗(yàn)證修復(fù)
---

## 觸發(fā)條件
用戶提到 bug、報錯、異常、調(diào)試、定位問題時自動調(diào)用

## 執(zhí)行步驟
1. 確認(rèn)復(fù)現(xiàn)步驟與環(huán)境
2. 二分法縮小問題范圍
3. 定位根因（日志/堆棧/依賴）
4. 給出修復(fù)方案并驗(yàn)證

三、調(diào)用方式（3 種）

1. 顯式調(diào)用（手動）
   • 前綴 $：$.systematic-debugging
   • 命令 /skills：列出所有可用技能，直接選擇
2. 隱式調(diào)用（自動）
   • 當(dāng)你的需求和 Skill 的 description/ 觸發(fā)條件匹配時，Codex 自動識別并調(diào)用，無需手動指定
3. 手動配置（搭配下面五中的手動創(chuàng)建skill）
   • 找到系統(tǒng)中的.codex目錄
     • mac通常在：/Users/賬戶名/.codex
     • Windows通常在：C:\Users\你的用戶名\.codex
   • 找到目錄下的skills目錄，cd進(jìn)去
   • 創(chuàng)建工程目錄，工程目錄可以和SKILL.md的name不一樣**（推薦一樣）**
   • 創(chuàng)建或者把現(xiàn)有的SKILL.md放在創(chuàng)建的工程目錄下
   • codex中創(chuàng)建新的對話框，這個很重要，舊的對話框一般猶豫緩存等原因是讀取不到新添加的SKILL的
   • 新對話框中可以直接對話觸發(fā)生效：后續(xù)在 project 項(xiàng)目中默認(rèn)使用 project-sensitive-guard skill。

四、常用內(nèi)置 / 推薦 Skill（2026）

• systematic-debugging：系統(tǒng)化調(diào)試（最優(yōu)先安裝，減少無效修改）
• deep-research：深度調(diào)研（權(quán)威源→比對時間→整理結(jié)論）
• coding-agent：并行協(xié)作（主線 + 旁路任務(wù)拆分，提升效率）
• create-plan：任務(wù)拆解（大需求拆成可執(zhí)行小步驟）
• find-skills：技能發(fā)現(xiàn)（自動匹配當(dāng)前任務(wù)所需技能）

五、創(chuàng)建 Skill（3 種方法）

1. Prompt-to-Skill（快速）

   直接對 Codex 說：

   請創(chuàng)建一個 Skill，以后我給你網(wǎng)頁項(xiàng)目時，先檢查移動端排版、按鈕樣式、文字層級、顏色規(guī)范，最后輸出修改文件和結(jié)果。

2. 固化流程（推薦）

   先手動跑通一次完整流程→滿意后說：

   把剛才的流程固化成一個 Skill，命名為 xxx，按標(biāo)準(zhǔn)格式生成 SKILL.md 和文件夾結(jié)構(gòu)。

3. 手動創(chuàng)建（看情況）

   手動創(chuàng)建SKILL.md文檔，比如

   ---
   name: project-sensitive-guard
   description: 在 project 項(xiàng)目中保護(hù)敏感配置和憑據(jù)文件。
   
   ---
   
   # project 敏感信息保護(hù)
   
   在 `project` 項(xiàng)目中工作時，嚴(yán)格遵守以下規(guī)則：
   
   - 不讀取 `project/env/**`
   - 不讀取 `.env` 或 `.env.*`
   - 搜索倉庫時排除敏感路徑
   

六、核心特性

• 漸進(jìn)式加載：啟動只加載名稱 / 描述，調(diào)用時才加載完整內(nèi)容，省 token、響應(yīng)快
• 多范圍存儲：
  • System：系統(tǒng)內(nèi)置
  • User：個人全局
  • Repo：項(xiàng)目共享（團(tuán)隊協(xié)作）
• 沙盒執(zhí)行：獨(dú)立環(huán)境運(yùn)行，支持多技能并行，互不干擾
• 生態(tài)兼容：遵循 Open Agent Skills 標(biāo)準(zhǔn)，可在 Claude、Copilot 等工具間復(fù)用

七、和 Custom Prompts 的區(qū)別

• Custom Prompt：一次性 / 會話級，上下文丟失就失效，長提示詞消耗大量 token
• Skill：持久化 / 模塊化，可版本控制、共享、復(fù)用，按需加載更高效

到此這篇關(guān)于Codex配置Skill的實(shí)現(xiàn)步驟的文章就介紹到這了,更多相關(guān)Codex配置Skill內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論