影片筆記：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 檢查）。

1. 核心原理：漸進式揭露（Progressive Disclosure）：AI 不會一次性背下所有手冊，僅掃描名稱與簡介；僅在判斷任務需要時，才翻開手冊仔細閱讀。因此，SKILL.md 中的簡短描述決定了 AI 是否會調用該技能。
2. 撰寫黃金法則：核心任務開門見山寫在第一句；使用日常口語作為觸發詞；清楚交代「什麼時候絕對不要用這招」；避免模糊廢話。
3. 新手地雷：

• 對話框未重置：技能建立後，必須開啟「全新對話」，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 現成技能。

1. 建立專屬技能：

• 使用內建助手指令 skill Creator。
• 將過去完美的聊天記錄餵給 AI，自動萃取精華生成 SKILL.md。

1. 撰寫 SKILL.md：

• 第一句寫明核心任務。
• 使用日常口語作為觸發詞。
• 明確標註「什麼時候絕對不要用這招」。
• 避免模糊廢話。
• 確保儲存格式為 UTF-8 且無 BOM。

1. 部署與使用：

• 將技能存放於「全域儲存」或「專案儲存」資料夾。
• 關鍵步驟：建立或安裝技能後，必須開啟「全新對話」，讓 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 無法解析技能嗎？