生活分享

代理技能（Agent Skills）是什麼：可重用的工作方法包

Agent Skills 是把工作指示、參考資料與可選腳本放進資料夾的開放格式，讓相容代理在需要時載入特定做法。本文用社區月報整理的情境，說明 SKILL.md、名稱與描述、逐步載入及附屬資源的角色，分清技能、系統提示詞、MCP 和 A2A。附內容設計與驗收方法，幫你判斷技能是否真的可重用，而不是只把長提示詞換個檔名。

更新日期: 閱讀時間約 7 分鐘

一個打開的技能資料夾內有工作手冊、範本與工具腳本卡，代理只取出目前需要的一張。
圖片：Mokaair (© Mokaair)

代理技能（Agent Skills）是一種把專門工作方法包裝成資料夾的開放格式。核心是 SKILL.md，裡面包含名稱、描述與指示，也可附上腳本、參考資料或範本。相容的代理可以在任務需要時讀取，減少每次重新交代同一套工作方法的負擔。

這裡談的是 agentskills.io 所定義的格式，不是泛指模型會多少技能，也不是 A2A 能力卡裡的對外能力清單。以下用社區月報整理作原創示意，說明一份技能應如何描述用途、載入資料與驗證產物，以及哪些能力仍要由工具和程式提供。

技能包的是工作知識，不是新的模型權重

你可以把技能看成供代理閱讀與使用的工作手冊。月報技能可能規定先核對來源、再整理本月事件、最後依既定欄位輸出。代理讀取後依指示處理，並不代表模型因此永久更新，也不代表換到不相容產品就一定會自動生效。

官方規格要求 SKILL.md 包含基本中繼資料與正文；名稱與描述協助代理辨認什麼時候使用。VS Code 的官方文件則展示相容產品如何使用這種格式。標準化有助於移植，但工具權限、可執行語言和載入設定仍由各產品決定。

如果技能需要讀試算表、產生文件或執行腳本，執行環境必須實際提供那些能力。檔案裡寫「寄出月報」不會自動創造郵件工具，也不會自動取得對外寄送授權。工作指示和可執行能力要分開檢查，避免把技能說明誤當成已安裝完整應用。

代理先看技能名稱與描述，再讀主指示，最後依需求讀取月報範本、參考文件或腳本。
逐步載入是內容組織方式；工具執行與權限仍由實際產品控制。 · 圖片：Mokaair (© Mokaair)

名稱與描述決定是否能被正確找到

「報告高手」這種名稱容易理解成宣傳，但不清楚適用任務。較有用的描述是「整理社區月報，核對活動日期與來源，依固定欄位產生草稿」。它讓代理知道何時載入，也讓使用者知道這份技能能幫什麼忙。

描述還應指出重要邊界，例如只處理月報草稿，不負責對外發布；需要本月原始紀錄，不應依舊月報猜測新事件。這些內容能避免技能被誤用在不適合的任務，也能減少代理載入後才發現缺資料的情況。

不要把所有觸發條件都藏在很深的參考文件。代理往往先看到簡短中繼資料，再決定是否讀正文；若描述含糊，正文再完整也可能沒有被選中。相反地，描述過於寬泛又可能讓簡單問題也載入整套流程，增加上下文負擔。

逐步載入讓細節在需要時出現

官方格式採逐步揭露的思路：先提供名稱與描述，任務相關時讀主指示，需要更細內容時再讀附屬資源。這不是保證每個產品永遠以同一方式載入，而是技能內容應支持的一種組織方式。

月報技能的主檔可以保留工作順序與驗收標準，詳細日期格式放到參考文件，常用版面放到範本，必要的轉換程式放到腳本。代理只整理短段落時，不必把所有版面規格和工具原始碼都放進上下文。

但拆檔也不能拆到難以導航。主檔應清楚說明每份資源的用途與使用時機，路徑能正確找到。若「請看相關資料」沒有指出在哪裡，代理可能漏讀；若參考文件互相循環引用，則增加探索成本而沒有提供更多有效資訊。

用社區月報測試技能是否真的有用

以下是示意操作。準備一份虛構本月活動紀錄，包含已舉辦活動、延期活動與尚未確認的下月計畫。月報技能要求分開這些狀態，保留來源位置，輸出標題、摘要與待確認事項。預期產物是一份可編輯草稿，而不是直接發布的文章。

先用完整資料測試，再刻意移除一個活動日期，觀察代理是否缺漏。接著提供一份舊月報當版面參考，確認它只沿用結構，沒有把上月事件搬到本月。這些案例能檢查技能是否保留了真正的工作規則，而不只是要求語氣一致。

最後比較沒有技能和有技能的結果，觀察欄位完整度、事實狀態與返工情況。這裡沒有執行這項實驗，所以不宣稱效率提升。若技能讓格式更整齊卻引入過期事件，就應修正資料使用規則，不能只用外觀評估成功。

可重用還需要版本、依賴與信任

技能可能附帶可執行程式，應瞭解來源和實際動作，再交由合適環境執行。格式相容不等於內容安全；一份來源不明的技能也可能包含不必要的資料讀取或對外操作要求。必要權限應由使用者與系統控制，而不是因為文字放在 SKILL.md 就取得特權。

內容也會過期。社區月報欄位改版後，範本、正文說明與腳本都要同步檢查。保留版本與變更理由，能讓接手者知道哪些流程調整過，也方便回查某次產物使用了哪一版規則。

技能、系統提示詞、MCP 與 A2A 可以搭配。系統提示詞設定較固定的行為，技能提供特定工作方法，MCP 連接工具與資料，A2A 支援代理任務交流。它們不必全部出現在每個工作裡，應依實際需求選擇，而不是為了追逐名詞全部安裝。

好的技能應讓下一次相似任務更容易正確完成：用途明確、必要資料清楚、工具依賴可確認、產物可驗收。若只是把一段很長的提示詞存成檔案，卻沒有處理適用範圍與錯誤情況，可重用程度仍然有限。

最實用的起點，是挑一種你反覆做、又能清楚說出完成標準的工作。先把已知規則和常見錯例整理好，再決定是否需要腳本與附屬文件。技能的內容應來自可重複的方法，而不是對代理能力的空泛承諾。

概念與使用情境比較；查證於 2026 年 9 月。
元素作用月報示例
名稱與描述決定何時載入整理社區月報
主指示工作順序與驗收分清已完成與延期
參考與範本按需提供細節日期格式與版面
可選腳本執行具體處理轉換已確認資料

同主題延伸閱讀

  • 生活分享

    世界模型（World Model）是什麼：讓 AI 預測「接下來會怎樣」

    世界模型指 AI 內部用來預測「這樣做之後會怎樣」的模型，但這個詞至少有三種用法：強化學習代理在想像中練習用的環境模型、LeCun 主張預測抽象表示的架構路線，以及能隨操作即時生成畫面的互動環境。內容用示例說明怎麼在想像中規劃，並列出大型語言模型有沒有世界模型的正反研究，附讀新聞時的檢查問題。

  • 生活分享

    視覺語言模型（VLM）是什麼：讓 AI 讀圖片、再用文字回答

    視覺語言模型（VLM）能同時接收圖片與文字，再用文字回答。內容拆解視覺編碼器、連接層與語言模型三段結構，說明 CLIP、Flamingo、LLaVA 三篇論文各補上哪一塊，並和多模態 AI、文字生圖分清楚；也整理它常犯的錯：數錯數量、搞混位置、說出圖裡沒有的東西，附上讀收據時逐行核對的步驟。

  • 生活分享

    溫度（Temperature）是什麼：AI 回答變化程度的取樣參數

    溫度（temperature）是文字生成時調整取樣的參數，讓模型從下一個 token 的機率分布裡抽得更集中或更分散。用假想的台南早餐示例算出低溫與高溫的差別，說明 top-p 的來源和它與 top-k 的差別，並依官方文件與論文指出：調低溫度不代表更準，設成 0 也不保證每次相同，部分模型還不開放調整。

  • 生活分享

    合成資料（Synthetic Data）是什麼：兩種用途、品質控管與模型崩潰

    合成資料是由演算法或模型產生、模仿真實資料特徵的資料，常見用途有兩種：訓練模型，以及在隱私需求下替代真資料。內容依 Self-Instruct、模型崩潰研究（替換與累積資料的差別）與 NIST、ICO 的隱私文件，說明做法、抽查流程，以及它不能保證的事。

引用本文的文章

最新旅遊情報攻略

資料來源

生活分享