[AI 分享] 打造好用的 Skill 方法

 [AI 分享] 打造好用的 Skill 方法

摘要 : 重點不在規則多，而是寫清觸發場景、任務邊界、輸出格式與示例，才能做出真正好用的 Skill。

內容:

cloud 官方文件指出很多人寫 Skill 效果不好，不是因為不夠努力，而是沒有抓到設計重點。真正好用的 Skill，不是靠堆疊大量規則，而是要讓系統清楚知道「什麼時候該被呼叫」、「被呼叫後要完成什麼」、「最後要如何輸出」。

先介紹 Skill 的基本結構。標準的 skill.md 分成兩部分：上方是 YAML 配置區，包含名稱、觸發時機與是否需要額外權限；下方是 Markdown 內容區，負責描述 Skill 被調用後的具體執行方式。示範案例是一個名為「meeting to action」的 Skill，功能是把會議記錄轉換成結構化的行動項清單。

其中，配置區最重要的欄位是 description。這一段文字會被系統拿來做語意匹配，判斷目前對話是否需要自動載入這個 Skill。若 description 只寫「會議記錄整理工具」這種模糊描述，系統無法理解具體用途與觸發時機；但若寫成「把會議記錄或會議內容整理成結構化的行動項清單，當使用者提供會議逐字稿、錄音轉文字，或要求整理會議與提取行動項時觸發」，就能明確提供場景、關鍵詞與觸發條件。作者也提醒，description 有字數顯示限制，因此最重要的觸發詞要盡量放在前面。

接著內容區的寫法。第一步不是急著列規則，而是先定義任務本身，也就是一句話講清楚這個 Skill 的核心工作。這樣系統才知道執行的終點與邊界，例如這個案例的重點不是做全面摘要，而是只聚焦在行動項、決策與待澄清問題。

第二步是定義輸出格式，而且越具體越好。作者示範的輸出包含三部分：第一是行動項清單，每一條都要有負責人、任務、截止時間與優先順序；第二是本次會議的核心決策，列出兩到四條；第三是待澄清問題，用來標記責任不清或尚未解決的事項，若沒有則可省略。明確的格式設計，能讓每次輸出維持穩定一致，不會忽長忽短、忽散忽亂。

在規則設計上，作者特別強調「少而有力」。很多人習慣寫出一長串像是「保持客觀」、「語言簡潔」、「注意格式」這類看似專業、實際卻缺乏約束力的規則。真正有效的規則，應該要能落地執行，例如：只提取明確任務、負責人不清楚就標示待定、截止時間未說明就寫未定、不要自行猜測內容、行動項要用動詞開頭等。這些規則能直接限制模型最容易出錯的地方。

示例是最常被忽略、卻極其重要的一部分。相較單純描述，完整的輸入輸出示例更能讓系統理解你想要的格式、資訊密度與判斷方式。像是如何區分行動項與決策、如何標記待定、如何處理未解決問題，透過一個涵蓋多種情況的示例，往往比十條抽象規則更有效。

最後，整理出三條 Skill 寫作原則。第一，先寫 description，再寫內容，因為先釐清觸發場景，後續設計才有方向。第二，一個 Skill 只解決一件事，不要同時想讓它整理會議、寫週報又寄信，否則容易失焦。第三，Skill 與 cloud.md 不能混用，cloud.md 適合放每次對話都要載入的固定規則與背景，而 Skill 則適合做按需載入的場景化指引。

整體來說，核心觀點很明確：Skill 不是越長越好，也不是提示詞的堆砌，而是一份精準的操作手冊。只要把觸發條件、任務邊界與示範方式設計清楚，就能寫出真正實用、穩定又高效的 Skill。