← 回找觀念
觀念總論|AI 協作方法

第 18 篇|製作專屬 Skill:精準命名、觸發與漸進式揭露實戰

累積幾十個工作技能後,靠資料夾結構與精準命名,讓 AI 在對的時間自主觸發對的 Skill。

2026-07-26 · 作者整理:Lucas · 資安審稿後整理
資安審稿註記:本文已把「保證安全」「最強防線」等過度承諾改成保守表述;凡涉及金鑰、權限、刪除、提交、外部發送與自動化執行,均保留人工確認、沙盒或測試環境前提。

在完成了任務拆解與流程自動化的架構後,實務上的下一個落地難關就是:當你手邊累積了幾十種不同功能的小型指令(SOP)後,你該如何把它們打包,並讓 AI 懂得在對的時間,自主且穩定地調用它們?

如果你把這幾十種工作規定一股腦全部塞進系統提示詞中,AI 的大腦(Context Window)會瞬間被塞滿,智商退化,並開始 Freestyle 亂改。

為了解決這個嚴重的痛點,現代 AI 協作環境(如 Cursor、Cline 或 Codex)採用了 Skills(技能)的模組化管理架構。這套架構背後依賴的,正是資訊管理的最高心法:漸進式揭露(Progressive Disclosure)。

Skill 資料夾結構

SKILL.md

觸發條件、核心心法、主要流程。

references/

長範例、格式模板、對照資料。

scripts/

可重複的確定性動作。

實戰步驟一:理解 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 吧!

← 看更多觀念總論
取得 AI 實戰工具與更新

之後會不定期整理:新方法、指令包(Prompt Pack)、Checklist 與模板。免費、無廣告;正式寄送前會先寄確認信,隨時可來信要求刪除。