在完成了任務拆解與流程自動化的架構後,實務上的下一個落地難關就是:當你手邊累積了幾十種不同功能的小型指令(SOP)後,你該如何把它們打包,並讓 AI 懂得在對的時間,自主且穩定地調用它們?
如果你把這幾十種工作規定一股腦全部塞進系統提示詞中,AI 的大腦(Context Window)會瞬間被塞滿,智商退化,並開始 Freestyle 亂改。
為了解決這個嚴重的痛點,現代 AI 協作環境(如 Cursor、Cline 或 Codex)採用了 Skills(技能)的模組化管理架構。這套架構背後依賴的,正是資訊管理的最高心法:漸進式揭露(Progressive Disclosure)。
Skill 資料夾結構
觸發條件、核心心法、主要流程。
長範例、格式模板、對照資料。
可重複的確定性動作。
實戰步驟一:理解 Skill 資料夾結構與「漸進式揭露」的三層載入
在實作之前,你必須先弄清楚一個標準的 Skill 在系統中是如何被拆分與封裝的。一個 Skill 本質上是一個獨立的資料夾,裡面通常包含以下三種核心檔案:
skill.md(主文件):這是 Skill 的心臟。最上面有一段用來定義技能身份的 front matter(Metadata 宣告),下面則放你傳授給 Agent 的核心方方法論與心法。
references/(參考資料夾):存放不會每次都用到的龐大範例文本、專有名詞表、或踩坑歷史紀錄,供 Agent 遇到特殊狀況時自行動態檢索。
scripts/(自動化腳本資料夾):存放可直接執行的 Bash/Python 腳本,用來處理格式轉換、資料擷取等完全確定性的死板工作。
這套檔案結構搭配系統底層的「漸進式揭露」機制,會在工作時實現以下三層精妙的動態加載:
第一層:啟動時。系統只會讀取每個 Skill 的主檔頭 name 與 description(簡介),通常只消耗極少的 Token(約 100 tokens)。
第二層:任務匹配時。只有當對話內容觸發了特定關鍵字,系統確認匹配成功,才會將該 Skill 的 skill.md 完整指令加載進大腦。
第三層:執行時。只有在 AI 真正動手要排版或執行腳本時,才會去讀取 references 與 scripts 中的資源。這確保了 Agent 身上可以掛載幾十種高階專業技能,大腦卻永遠不會超載!
實戰步驟二:撰寫符合 Agent 觸發邏輯的命名與 Description 簡介
配置好結構後,新手最常踩的坑,就是 Trigger Failure(觸發失敗)——你明明寫好了 Skill 放在資料夾,AI 遇到需求時卻直接當沒看見,繼續 freestyle 自顧自地寫。
要解決觸發失敗,你必須嚴格遵守以下兩大黃金命名與簡介撰寫規範:
使用「小寫字母配減號」的動名詞命名規範:
正確範例:weekly-report-drafting、analyzing-spreadsheets 或 pdf-processing。這種結構清晰、動名詞結合的命名,不論是人類還是 AI,都能在讀到的第一秒,就精準判定這個 Skill 是用來解決什麼任務。
撰寫包含「做什麼、何時用、第三人稱」的 Description:description 簡介是 AI 判斷是否要加載該 Skill 的唯一根據。你必須在簡介中提供足夠的觸發線索。請確保你的 description 滿足以下三要素:
要素一:用第三人稱撰寫。不要用「I can help you...」這類第一人稱,會跟 AI 自主系統視角產生衝突導致混亂。
要素二:明確指明「做什麼」與「何時用」。
要素三:包含使用者日常會講出的「口語觸發詞」。不要使用生硬的技術名詞,要用你平常對對話框說的白話文。
實戰簡介寫法:"drafts weekly status updates for managers, aggregating data from Google Drive and GitHub. Use when user mentions weekly reports, team updates, status summaries, or weekly reviews."
行動總結
一個寫得好的 Skill,就像是一顆已經打包好的「專業外掛晶片」。平常安靜地躺在硬碟裡,只有當你提到關鍵字時,AI 才會迅速插上晶片,瞬間化身為特定領域的特種兵。現在就動手,把你最討厭、最重複的日常工作(如周報整理、專案檢核),打包成你的第一個專屬 Skill 吧!