這篇文章是我自己學(xué)習(xí) Codex、Skill、Plugin、MCP 過程中的一次整理。剛開始我也以為 Skill 就是“提示詞模板”，后來發(fā)現(xiàn)它不只是提示詞：簡單 Skill 可以只寫說明，復(fù)雜 Skill 還可以帶 Python、Shell 腳本、模板文件，甚至配合 MCP 調(diào)外部系統(tǒng)。

一、先說結(jié)論

如果只用一句話解釋：

Codex 是一個能動手干活的 AI 智能體，Skill 是給 Codex 安裝的一套“做事方法和工具包”。

再通俗一點：

• Codex：像一個會看項目、會跑命令、會改文件、會看報錯再調(diào)整的 AI 技術(shù)同事。
• Skill：像給這個技術(shù)同事準(zhǔn)備的一份操作手冊，里面還可以帶腳本、模板、參考資料。
• Plugin 插件：像一個可安裝的大禮包，里面可以包含 Skill、App 集成、MCP 配置等。
• MCP：像連接外部系統(tǒng)的標(biāo)準(zhǔn)接口，比如連 GitHub、數(shù)據(jù)庫、Figma、公司內(nèi)部系統(tǒng)。

官方文檔里也說，Codex Skill 可以把說明、資源和可選腳本打包起來，讓 Codex 更穩(wěn)定地執(zhí)行某類重復(fù)工作；Plugin 是 Codex 里可安裝的分發(fā)單元，可以打包 Skill、App 集成和 MCP Server。

二、Codex 是什么？

Codex 不是普通聊天機器人。

普通聊天機器人一般是：

你問一句
↓
AI 回一句

Codex 更像：

你交代一個任務(wù)
↓
Codex 制定計劃
↓
讀文件 / 改文件 / 執(zhí)行命令 / 調(diào)用腳本
↓
觀察執(zhí)行結(jié)果
↓
如果失敗，就根據(jù)報錯繼續(xù)修正
↓
直到完成，或者遇到需要你確認(rèn)的問題

官方 Codex CLI 文檔也說明，Codex CLI 可以在終端里運行，并且能讀取、修改、運行你選定目錄里的代碼。

三、Codex 怎么安裝？

如果是 macOS / Linux，官方文檔給出的 Codex CLI 安裝方式是：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安裝后運行：

codex

第一次運行時，會提示登錄。登錄完成后，就可以在終端里使用 Codex。

如果你已經(jīng)安裝了 Codex，就不用重復(fù)安裝，直接進(jìn)入你的項目目錄執(zhí)行：

codex

注意：Codex 版本更新比較快，安裝命令和目錄規(guī)則可能會調(diào)整，實際以官方文檔和你本機 Codex 提示為準(zhǔn)。

四、Skill 到底是什么？

剛開始我理解 Skill，就是“固定提示詞”。這個理解對一半。

簡單 Skill 確實可以只是一個 SKILL.md 文件，里面寫規(guī)則，比如：

遇到日報時：
1. 語言自然，不要太官方。
2. 不要夸大工作量。
3. 按 1、2、3 分點輸出。
4. 適合發(fā)領(lǐng)導(dǎo)或客戶群。

這種 Skill 就像一個固定的系統(tǒng)提示詞。

但是復(fù)雜 Skill 還可以帶：

SKILL.md      說明書，告訴 Codex 什么時候用、怎么用
scripts/      Python、Shell 等腳本
references/   參考文檔
assets/       模板、圖片、示例文件
agents/       依賴配置，比如 MCP 等

所以更準(zhǔn)確地說：

Skill = 做事說明書 + 可選腳本 + 可選模板 + 可選參考資料。

官方文檔里也說明，一個 Skill 是一個目錄，里面必須有 SKILL.md，并且 SKILL.md 需要包含 name 和 description，同時可以帶可選腳本、參考資料和資源文件。

五、我本地 Skill 目錄長什么樣？

我一開始進(jìn)入本機的 Skill 目錄時，看到的是這樣：

可以看到，當(dāng)時目錄下只有一個：

codex-primary-runtime

這里要注意：自己新建的 Skill 不要放進(jìn) codex-primary-runtime 里面，而是和它平級。

也就是類似這樣：

~/.codex/skills/
├── codex-primary-runtime
└── daily-report-polisher
    └── SKILL.md

不過這里要補充一句：不同版本 Codex 的 Skill 路徑可能不一樣。新文檔里也提到過用戶級 Skill 路徑可以是：

$HOME/.agents/skills

我這里是按我本機當(dāng)時實際識別到的目錄 ~/.codex/skills 測試的。最穩(wěn)妥的方式是：看你本機 /skills 能不能識別到。

六、手動創(chuàng)建一個最簡單的 Skill

比如我想創(chuàng)建一個日報優(yōu)化 Skill，可以這樣操作：

cd ~/.codex/skills
mkdir -p daily-report-polisher
cat > daily-report-polisher/SKILL.md <<'EOF'
---
name: daily-report-polisher
description: 用于優(yōu)化中文日報、周報、客戶群回復(fù)、工作進(jìn)展說明。適合把粗糙工作內(nèi)容改成自然、簡潔、適合發(fā)領(lǐng)導(dǎo)或客戶群的表達(dá)。
---

# 日報和工作說明優(yōu)化 Skill

## 適用場景

當(dāng)用戶提供日報、周報、客戶溝通內(nèi)容、工作進(jìn)展說明、領(lǐng)導(dǎo)匯報草稿時，幫助用戶優(yōu)化表達(dá)。

## 輸出要求

1. 語言自然，不要太官方。
2. 不要寫得太復(fù)雜。
3. 不要夸大用戶沒有做過的工作。
4. 適合發(fā)領(lǐng)導(dǎo)、客戶群或工作群。
5. 優(yōu)先按 1、2、3 分點輸出。
6. 如果是客戶群回復(fù)，語氣要穩(wěn)妥，不要指定某一個人回復(fù)。
7. 如果涉及技術(shù)可實現(xiàn)但管理規(guī)則待確認(rèn)，要體現(xiàn)“需要業(yè)務(wù)/管理側(cè)確認(rèn)規(guī)則”。

## 輸出風(fēng)格

簡潔、穩(wěn)妥、像正常工作溝通，不要像宣傳稿。
EOF

然后啟動 Codex：

codex

進(jìn)入 Codex 后，可以輸入：

/skills

或者直接用 $ 調(diào)用：

$daily-report-polisher 今天看了AIP部署文檔，改了架構(gòu)圖，和測試環(huán)境升級，解決登錄問題。

我測試后，Codex 回復(fù)里出現(xiàn)了藍(lán)色的 Daily Report Polisher 標(biāo)簽，說明 Skill 已經(jīng)被調(diào)用到了：

這里就能直觀看到：安裝前只是普通對話；安裝后，Codex 可以識別并調(diào)用這個 Skill，用我們提前寫好的規(guī)則來整理日報。

七、帶 Python 的 Skill 是什么樣？

很多人會以為 Skill 就是提示詞，其實不是。

如果 Skill 里面有 Python，它就更像：

• SKILL.md：告訴 Codex 什么時候運行腳本、腳本是干什么的
• Python 腳本：真正做拆分、統(tǒng)計、讀取文件、生成初稿等機械活
• Codex：拿到腳本結(jié)果后，再進(jìn)行理解和潤色

比如一個工作記錄整理 Skill 可以這樣設(shè)計：

work-log-python-helper/
├── SKILL.md
└── tools/
    └── worklog_report.py

SKILL.md 里可以寫：

---
name: work-log-python-helper
description: 用 Python 拆分和分類中文工作記錄，適合把雜亂工作流水整理成日報初稿。
---

# 工作記錄整理 Skill

當(dāng)用戶提供一段雜亂工作記錄，并要求整理日報時，優(yōu)先運行：

python3 tools/worklog_report.py --text "用戶輸入內(nèi)容"

運行腳本后，根據(jù)腳本輸出繼續(xù)潤色成自然的日報。

Python 腳本可以簡單寫成：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import argparse
import re
DONE_KEYWORDS = ["完成", "處理", "解決", "整理", "更新", "修改", "測試", "驗證", "部署"]
ISSUE_KEYWORDS = ["問題", "報錯", "異常", "失敗", "無法"]
PLAN_KEYWORDS = ["后續(xù)", "計劃", "繼續(xù)", "明天", "下一步"]
def split_items(text: str):
    parts = re.split(r"[。；;\n]+", text)
    return [p.strip() for p in parts if p.strip()]
def classify(item: str):
    if any(k in item for k in PLAN_KEYWORDS):
        return "后續(xù)計劃"
    if any(k in item for k in ISSUE_KEYWORDS):
        return "問題處理"
    if any(k in item for k in DONE_KEYWORDS):
        return "今日完成"
    return "今日完成"
def main():
    parser = argparse.ArgumentParser(description="工作記錄整理工具")
    parser.add_argument("--text", required=True, help="需要整理的工作記錄文本")
    args = parser.parse_args()
    groups = {
        "今日完成": [],
        "問題處理": [],
        "后續(xù)計劃": [],
    }
    for item in split_items(args.text):
        groups[classify(item)].append(item)
    for title, items in groups.items():
        if not items:
            continue
        print(f"## {title}")
        for i, item in enumerate(items, 1):
            print(f"{i}. {item}")
        print()
if __name__ == "__main__":
    main()

這里有幾個小白要注意的點：

1. Python 不是必須有 main()，但建議有，這樣 Codex 更容易通過命令行調(diào)用。
2. Skill 被選中，不等于 Python 一定會自動執(zhí)行。
3. Codex 會先讀 SKILL.md，再判斷當(dāng)前任務(wù)是否需要運行 Python。
4. 如果你明確說“先運行這個 Skill 里的 Python 腳本”，Codex 執(zhí)行概率會更高。
5. Python 能不能跑，取決于當(dāng)前環(huán)境有沒有 python3 和相關(guān)依賴。

八、Codex 為什么能執(zhí)行 Python？是在本地執(zhí)行還是遠(yuǎn)端執(zhí)行？

Codex 能執(zhí)行 Python，不是因為大模型自己在腦子里運行代碼，而是因為 Codex 客戶端有執(zhí)行本地命令的能力。

簡單理解：

• 大模型：判斷應(yīng)該執(zhí)行什么命令
• Codex 客戶端：把命令交給當(dāng)前環(huán)境執(zhí)行
• Python 解釋器：真正運行 .py 文件
• Codex：讀取命令輸出，再決定下一步

如果你是在本機終端里運行 Codex CLI，那么 Python 通常就是在你的本機執(zhí)行。比如：

python3 ~/.codex/skills/work-log-python-helper/tools/worklog_report.py --text "今天處理AIP環(huán)境升級"

這條命令是在你當(dāng)前 Codex 所在的環(huán)境里執(zhí)行的。

但如果你用的是遠(yuǎn)程環(huán)境、服務(wù)器、Codex Cloud，那么執(zhí)行位置就可能是對應(yīng)的遠(yuǎn)程環(huán)境或云端容器。

更準(zhǔn)確地說：

Python 在 Codex Agent 當(dāng)前所在的運行環(huán)境執(zhí)行。

九、依賴包會不會沖突？磁盤會不會越來越大？

會有這個風(fēng)險。

因為如果 Codex 執(zhí)行了：

pip install pandas
pip install openpyxl

就可能把依賴裝到當(dāng)前 Python 環(huán)境里。

如果裝到系統(tǒng) Python，可能導(dǎo)致依賴沖突；如果每個項目都創(chuàng)建 .venv，不容易沖突，但磁盤可能慢慢變大。

所以建議在 Skill 里寫清楚：

## Python 依賴規(guī)則
1. 不允許使用 sudo pip install。
2. 不允許向系統(tǒng) Python 全局環(huán)境安裝依賴。
3. 如需安裝依賴，優(yōu)先使用當(dāng)前項目的 .venv。
4. 如果當(dāng)前項目沒有 .venv，先詢問用戶是否創(chuàng)建。
5. 優(yōu)先使用 Python 標(biāo)準(zhǔn)庫。
6. 不要重復(fù)創(chuàng)建多個虛擬環(huán)境。

對于簡單 Skill，盡量只用 Python 標(biāo)準(zhǔn)庫，比如：

argparse
re
pathlib
json

這樣最安全。

十、Codex 為什么會自動選擇不同 Skill？

Codex 啟動后，會掃描已安裝的 Skill。

但它不會一開始把所有 Skill 的完整內(nèi)容都塞進(jìn)上下文里，而是先看每個 Skill 的：

name
description
file path

官方文檔把這個叫做 progressive disclosure（漸進(jìn)式加載）。

也就是說：

先看 Skill 名稱和描述
↓
判斷任務(wù)是否匹配
↓
匹配后才讀取完整 SKILL.md
↓
需要時再讀取參考資料或運行腳本

所以 description 特別重要。

比如這個描述就比較容易觸發(fā)：

用于優(yōu)化中文日報、周報、客戶群回復(fù)、工作進(jìn)展說明。

如果只寫：

一個文本工具。

Codex 就很難判斷什么時候該用。

Codex 調(diào)用 Skill 有兩種方式：

1. 顯式調(diào)用：用戶直接輸入 $skill-name。
2. 隱式調(diào)用：用戶沒點名，但任務(wù)和 Skill 描述匹配，Codex 自己選擇。

十一、Codex 為什么能反復(fù)執(zhí)行直到成功？

這也是我最開始最困惑的地方。

后來我發(fā)現(xiàn)，Codex 的核心不是“特別能循環(huán)”，而是一個帶反饋的智能循環(huán)。

可以記成：

目標(biāo) → 計劃 → 執(zhí)行 → 觀察 → 修正 → 再執(zhí)行 → 停止

比如你讓 Codex 修復(fù)一個項目啟動問題：

第 1 輪：運行 npm run dev
結(jié)果：報錯，缺少 axios

第 2 輪：安裝 axios
結(jié)果：又報端口占用

第 3 輪：檢查端口
結(jié)果：發(fā)現(xiàn) 8080 被占用

第 4 輪：修改端口并重新啟動
結(jié)果：啟動成功

它不是死循環(huán)。

死循環(huán)是：

執(zhí)行
執(zhí)行
執(zhí)行
執(zhí)行

Codex 的循環(huán)是：

執(zhí)行
看結(jié)果
判斷哪里錯了
換辦法
再執(zhí)行

所以 Codex 能反復(fù)執(zhí)行，靠的是四件事：

1. 大模型：負(fù)責(zé)理解任務(wù)、判斷下一步。
2. 工具執(zhí)行能力：負(fù)責(zé)讀文件、改文件、跑命令、運行 Python。
3. 觀察結(jié)果：比如命令輸出、報錯日志、測試結(jié)果。
4. 停止條件：任務(wù)完成、測試通過、達(dá)到限制、需要用戶確認(rèn)。

官方文檔里也提到，Codex 使用沙箱和審批機制來控制它能做什么：在默認(rèn)權(quán)限下，它可以在當(dāng)前 workspace 里讀寫文件、運行常規(guī)命令；需要越界、聯(lián)網(wǎng)或高風(fēng)險操作時，會走審批流程。

十二、Skill、Plugin、MCP 到底有什么區(qū)別？

這個地方很容易混。

我現(xiàn)在的理解是：

舉例：

如果我要優(yōu)化日報，只需要 Skill：

日報 Skill：規(guī)定輸出風(fēng)格、格式、注意事項

如果我要根據(jù) GitHub 提交記錄生成日報，就可能需要 MCP 或 GitHub 插件：

GitHub MCP / 插件：拿到提交記錄
日報 Skill：把提交記錄整理成日報

所以最簡單的區(qū)分是：

Skill 解決“怎么做”，MCP 解決“連誰、查誰、調(diào)用誰”，Plugin 解決“把一套能力打包安裝”。

下面這個截圖就是 Codex 里的插件頁面，里面可以看到 GitHub、Google Drive、PDF、Spreadsheets 等能力：

十三、Dify 工作流能不能復(fù)刻 Codex Skill？

能實現(xiàn)一部分，但不是一回事。

Dify 工作流里也有：

LLM 節(jié)點：相當(dāng)于寫提示詞規(guī)則
Code 節(jié)點：可以執(zhí)行 Python / JavaScript
Tool 節(jié)點：可以調(diào)用外部工具或 API
Agent 節(jié)點：可以讓模型自主選擇工具
Loop 節(jié)點：可以做循環(huán)和多輪修正

Dify 官方文檔里也說明，Agent 節(jié)點可以讓 LLM 自主控制工具并迭代決定什么時候用工具；Code 節(jié)點可以執(zhí)行 Python 或 JavaScript；Loop 節(jié)點可以做多輪循環(huán)。

但是 Dify 和 Codex 的差別是：

Codex 天然支持 Skill 文件夾機制；Dify 更像可視化流程編排。

簡單 Skill 可以在 Dify 里用一個 LLM 節(jié)點復(fù)刻。

復(fù)雜 Skill 如果硬拆到 Dify，工作流可能會變得很大：

開始節(jié)點
↓
分類節(jié)點
↓
Code 節(jié)點
↓
工具節(jié)點
↓
LLM 潤色節(jié)點
↓
循環(huán)判斷節(jié)點
↓
結(jié)束節(jié)點

所以更合理的方式是：

簡單規(guī)則：放 Dify 提示詞節(jié)點
復(fù)雜處理：封裝成 API 或工具
Dify：負(fù)責(zé)調(diào)用和編排
Codex Skill：更適合本地、代碼、文件處理類自動化

十四、我現(xiàn)在對 Codex Skill 的理解

經(jīng)過這次測試，我覺得可以這樣總結(jié)：

1. Skill 不是神秘功能，本質(zhì)是把重復(fù)做事方法沉淀下來。

比如日報、客戶群回復(fù)、部署文檔整理、Excel 統(tǒng)計，都可以做成 Skill。

2. 簡單 Skill 像固定提示詞。

一個 SKILL.md 就能完成。

3. 復(fù)雜 Skill 像一個能力包。

可以帶 Python、Shell、模板、參考資料。

4. Codex 不是盲目執(zhí)行。

它會根據(jù) Skill 的 description 判斷是否使用，使用時才讀取完整內(nèi)容。

5. Python 不是自動 亂跑。

Skill 被選中后，Codex 會根據(jù) SKILL.md 和當(dāng)前任務(wù)判斷是否需要執(zhí)行 Python。

6. Codex 的核心是智能循環(huán)。

不是普通死循環(huán)，而是：計劃 → 執(zhí)行 → 看結(jié)果 → 修正 → 再執(zhí)行

7. 用 Codex 跑代碼要注意安全。

不要隨便讓它全局安裝依賴，不要輕易使用 sudo pip install，最好使用項目 .venv。

十五、最后一句話

如果你是小白，可以先不要想太復(fù)雜。

先記住這個版本：

Codex 是會動手干活的 AI 智能體；Skill 是給它安裝的做事方法；Python 腳本是 Skill 里的小工具；MCP 是連接外部系統(tǒng)的接口；Plugin 是把一整套能力打包安裝。

真正用起來以后，你會發(fā)現(xiàn) Skill 最適合沉淀那些每天都重復(fù)說的要求，比如：

幫我優(yōu)化日報
幫我改客戶群回復(fù)
幫我整理部署文檔
幫我檢查項目目錄
幫我把雜亂工作記錄生成周報

這些東西只要寫成 Skill，后面就不用每次重復(fù)交代了。

以上就是Codex Skill是什么?Codex Skill安裝與使用的新手教程的詳細(xì)內(nèi)容，更多關(guān)于Codex Skill使用教學(xué)的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論