# 影片筆記：Codex Skills 完整教學｜把 SOP 打包成 AI 專屬技能，新手必看


<!-- VIDEONOTE_PUBLICATION_WARNINGS_BEGIN -->
## ⚠️ 全文快速校讀發現待確認修正

本筆記已完成可閱讀的逐字稿與時間跳轉；下列為待處理問題，建議播放原片確認。

- 待修正：⚠️ 全文快速校讀：已套用暫定修正，請確認（segment=32 已先套用暫定修正：第二，搞懂他跟其他工具的差異與適用時機，第三，教你怎麼安裝，第四 → 第二，搞懂他跟其他工具的差異與適用時機，第三，教你怎麼安裝，第四，動手打造你的專屬技能，最後帶你避開新手最常踩的地雷；segment=94 已先套用暫定修正：叫做漸進式揭露，這名詞聽 → 叫做漸進式揭露，這名詞聽起來很酷炫）
- 待修正：逐字稿可先使用，但有待校正清單（segment=123 rapid_semantic_review: 上下文對比：全域（Global）vs 專案（Project）。講者將「全域」比喻為「個人習慣」的可能性較低，通常全域設定是針對用戶帳號的。）

<!-- VIDEONOTE_PUBLICATION_WARNINGS_END -->

## 一句話總結
本影片介紹如何將重複性的標準作業流程（SOP）打包為 **Codex Skills**，透過建立 `SKILL.md` 檔案與「漸進式揭露」機制，讓 AI 自動識別並執行特定任務，解決新手需不斷複製貼上提示詞的低效率問題，並提醒存放位置與編碼等新手常見地雷。

## 核心重點
1.  **痛點解決**：針對新手需手動複製貼上長篇 SOP 提示詞導致效率低落的問題，提出將工作流程打包為「工作手冊」的解決方案。
2.  **技術結構**：Codex Skills 本質為資料夾，核心為 `SKILL.md` 檔案（定義觸發時機與步驟），並可輔以腳本、參考資料或素材。
3.  **適用場景差異**：
    *   普通 Prompt：臨時、單一小忙。
    *   AGENTS.md：團隊專案中的鐵律或規範。
    *   Codex Skills：固定、需不斷重複的工作流程（如每週例行報告、固定 QA 檢查）。
4.  **核心原理：漸進式揭露（Progressive Disclosure）**：AI 不會一次性背下所有手冊，僅掃描名稱與簡介；僅在判斷任務需要時，才翻開手冊仔細閱讀。因此，`SKILL.md` 中的簡短描述決定了 AI 是否會調用該技能。
5.  **撰寫黃金法則**：核心任務開門見山寫在第一句；使用日常口語作為觸發詞；清楚交代「什麼時候絕對不要用這招」；避免模糊廢話。
6.  **新手地雷**：
    *   **對話框未重置**：技能建立後，必須開啟「全新對話」，AI 才會重新掃描並認識新技能。
    *   **描述模糊**：導致技能失靈。
    *   **編碼問題**：儲存 `SKILL.md` 時需確保文字編輯器未加上 `UTF-8 BOM`，否則 Codex 無法解析。

## 詳細大綱

### 一、 痛點與解決方案：為什麼需要 Codex Skills？
*   **現狀痛點**：新手常需手動複製貼上長篇標準作業流程（SOP）提示詞，導致工作流程無法系統化與重複利用，效率低落。
*   **核心概念**：Codex Skills 相當於發給 AI 助理的「精裝版 SOP 手冊」或「工作手冊」。
*   **價值主張**：將重複性規則、參考資料、腳本打包，只需呼叫手冊名稱，AI 即自動執行，告別無止境的複製貼上。

### 二、 技術結構：Codex Skills 長什麼樣子？
*   **檔案結構**：本質上是一個資料夾。
*   **核心檔案**：`SKILL.md` 檔案，被稱為技能的大腦，負責定義觸發時機與具體操作步驟。
*   **輔助檔案**：可自由添加 `scripts`（腳本）、`references`（參考資料）、`assets`（圖片素材等）。

### 三、 工具差異與適用時機
*   **普通 Prompt（提示詞）**：適用於臨時、單一的小忙。
*   **AGENTS.md**：適用於整個團隊在專案中需遵守的鐵律或規範。
*   **Codex Skills**：適用於固定、需不斷重複的工作流程（如每週例行報告、固定 QA 檢查流程）。

### 四、 技能獲取與安裝方式
*   **三種獲取途徑**：
    1.  介面左側外掛分頁：瀏覽市集並點擊安裝。
    2.  指令呼叫：對 AI 輸入 `skill installer` 呼叫安裝工具。
    3.  GitHub 下載：Clone 神人寫好的技能。
*   **套件補齊**：安裝時若缺套件，Codex 通常會跳出提示主動補齊。

### 五、 打造專屬技能：核心原理與實戰
*   **快速打造方法**：使用內建助手指令 `skill Creator`。
*   **參考資料利用**：可將過去完美的聊天記錄餵給 AI，自動萃取精華生成 `SKILL.md`。
*   **核心原理：漸進式揭露（Progressive Disclosure）**
    *   **機制**：AI 不會一次性背下所有手冊，僅掃描名稱與簡介。僅在判斷任務需要時，才翻開手冊仔細閱讀。
    *   **關鍵影響**：`SKILL.md` 中的簡短描述決定了 AI 是否會調用該技能。
*   **撰寫黃金法則**：
    1.  核心任務開門見山寫在第一句。
    2.  使用日常口語作為觸發詞。
    3.  清楚交代「什麼時候絕對不要用這招」。
    4.  避免模糊廢話（如「這是一個幫助提高效率的技能」），以免誤判或無視。

### 六、 存放位置與新手地雷
*   **存放位置選擇**：
    *   **全域儲存（個人習慣）**：希望跨專案隨時呼叫的技能。
    *   **專案儲存（特定專案資料夾）**：專為單一專案量身定做，或需與團隊共享的技能。
*   **三大新手地雷**：
    1.  **對話框未重置**：技能建立後，必須開啟「全新對話」，AI 才會重新掃描並認識新技能；在原本對話框呼叫無效。
    2.  **描述模糊**：`SKILL.md` 描述寫得太模糊會導致技能失靈。
    3.  **編碼問題**：儲存 `SKILL.md` 時，需確保文字編輯器未加上 `UTF-8 BOM`，否則 Codex 無法解析，技能報銷。

## 工具 / 模型 / 名詞整理
*   **Codex**：主要討論的 AI 工具/模型。
*   **Codex Skills**：Codex 中的技能功能模組。
*   **SKILL.md**：技能的核心定義檔案。
*   **AGENTS.md**：用於團隊專案規範的檔案。
*   **skill installer**：用於安裝技能的指令/工具。
*   **skill Creator**：用於建立技能的內建助手指令。
*   **GitHub**：技能來源平台之一。
*   **UTF-8 BOM**：文字編碼格式，需避免加入。

## 操作流程整理
1.  **獲取技能**：
    *   透過介面左側外掛分頁瀏覽市集安裝。
    *   對 AI 輸入 `skill installer` 呼叫安裝工具。
    *   從 GitHub Clone 現成技能。
2.  **建立專屬技能**：
    *   使用內建助手指令 `skill Creator`。
    *   將過去完美的聊天記錄餵給 AI，自動萃取精華生成 `SKILL.md`。
3.  **撰寫 SKILL.md**：
    *   第一句寫明核心任務。
    *   使用日常口語作為觸發詞。
    *   明確標註「什麼時候絕對不要用這招」。
    *   避免模糊廢話。
    *   確保儲存格式為 UTF-8 且無 BOM。
4.  **部署與使用**：
    *   將技能存放於「全域儲存」或「專案儲存」資料夾。
    *   **關鍵步驟**：建立或安裝技能後，必須開啟「全新對話」，讓 AI 重新掃描並認識新技能。
    *   在對話中呼叫手冊名稱，AI 將自動識別並執行。

## 值得注意的限制或風險
*   **對話重置必要性**：技能建立或安裝後，若不在全新對話中使用，AI 可能無法識別新技能，導致呼叫無效。
*   **描述模糊風險**：若 `SKILL.md` 描述不夠精確，AI 可能誤判任務需求或完全忽略該技能。
*   **編碼相容性**：若文字編輯器自動加上 `UTF-8 BOM`，Codex 將無法解析檔案，導致技能失效。
*   **漸進式揭露的誤判**：由於 AI 僅掃描名稱與簡介，若觸發詞與日常口語不符，可能導致技能無法被正確調用。

## 逐字稿辨識疑點
*   **Codex Skills**：逐字稿中多次出現此名稱，若指代特定功能模組則保留原樣；若為聽寫錯誤需查證。
*   **skill installer**：逐字稿提及「對著AI輸入skill installer來呼叫安裝工具」，需查證是否為標準指令或口語化描述。
*   **skill Creator**：逐字稿提及「呼叫skill Creator這個像造物主一樣的指令」，需查證是否為標準指令名稱。
*   **全域儲存 / 專案儲存**：逐字稿提及「全域儲存這個抽屜」與「專案儲存資料夾」，需查證是否為 Codex 介面中的正式術語或功能名稱。
*   **UTF-8 BOM**：逐字稿提及「UTF-8 BOM」，需查證是否為正確技術術語（通常指 Byte Order Mark）。

## 可延伸追問
*   如何具體撰寫 `SKILL.md` 中的「什麼時候絕對不要用這招」範例？
*   若使用 `skill Creator` 時，AI 萃取的精華與預期不符，該如何手動修正？
*   在全域與專案儲存之間切換時，是否有優先級衝突的處理機制？
*   除了 `UTF-8 BOM`，還有其他常見的檔案格式或編碼問題會導致 Codex 無法解析技能嗎？