什麼是 Agent Skill？它與提示詞有何不同？
Agent Skill 是一個資料夾，裡面放着一個 SKILL.md 檔案，內含指示，並可選擇性附上範本與腳本。當你的請求與它的描述吻合時，AI 助理會自動載入它。提示詞只存在於一次對話之中；Skill 安裝一次，之後每次相關時都會自我套用。
這就是核心概念，也是 Skill 比又一個提示詞書籤更重要的原因。你不再需要當那個「記得要貼指示」的人。
Anthropic 的 Agent Skills 官方文件把它形容為「模組化能力」，由三件東西組成：指示、元資料，以及可選的資源。這份清單裡沒有任何一項需要你寫程式碼。
實際差別在第十次重複時才顯現。儲存好的提示詞，你依然要找出它、貼上它，還要記得哪個版本才是好的那個。Skill 只有一個正式位置，助理會自行讀取。
為何處理重複工作時 Skill 勝過儲存的提示詞？
因為漸進式披露（progressive disclosure）。Skill 分階段載入，而不是把所有內容一次塞進上下文視窗。任何時候常駐於上下文的只有名稱與描述，每個 Skill 約 100 個 token，所以你可以安裝大量 Skill，而在某一個真正被觸發之前，你都不用為它付上下文成本。
Anthropic 的文件列出三個載入層級。理解這三層，正是「寫出能用的 Skill 的人」與「寫出四千字巨型提示詞的人」之間的分野：
--- 第一層：元資料，永遠載入，開機時即載入。每個 Skill 約 100 token，只包含 YAML frontmatter 中的 name 與 description。
--- 第二層：指示，只在 Skill 被觸發時載入，目標為 5,000 token 以內，即 SKILL.md 的正文。
--- 第三層：資源與程式碼，只在被引用時載入，未存取前成本為零。可以是額外的 markdown 檔、範本、參考資料或腳本。
第三層的行為，是大多數人忽略的重點。你可以把一份四十頁的品牌指引、完整產品目錄、六個示範輸出全部打包進一個 Skill，而在助理真正需要其中某個檔案之前，這些內容都不佔用你的上下文。
腳本在這一點上更出色。當助理執行打包好的腳本時，腳本的程式碼永遠不會進入上下文視窗，只有輸出結果會。因此一個兩百行的格式化腳本，比要求模型即場生成同等邏輯更便宜，也更可靠，因為每次執行的都是同一段程式碼。
不寫程式碼，如何建立自訂 Skill？
寫一個名為 SKILL.md 的純文字檔，在頂部放上包含 name 與 description 的 YAML frontmatter，下面用普通 markdown 寫你的指示，然後把資料夾壓縮成 zip 上傳。在 claude.ai 上，上傳位置是 Settings > Features。不用終端機、不用程式庫、不用建置流程。
挑一件你每週都重複、而且你已經有明確意見的工作。客戶郵件回覆、每週報告格式、符合品牌語氣的社交媒體文案。最好的第一個 Skill，是一個你已經清楚知道「錯」是什麼樣子的流程，因為那份判斷正是你要編碼下來的東西。
以下是一個完整、可直接複製使用的起點。把方括號部分換成你自己的內容，就是一個可用的 Skill：
可直接使用的 SKILL.md 範本：
---
name: weekly-client-report
description: 以我們的固定格式撰寫每週客戶進度報告。當使用者要求每週報告、客戶更新、進度摘要，或提到要向客戶匯報時使用。
---
# 每週客戶報告
## 何時使用
當使用者要求每週客戶報告或進度更新時使用。
## 必須遵守的結構
1. 一句標題：本週最重要的一件事。
2.「本週已完成」：三至五點，每點以動詞開頭。
3.「進行中」：項目、負責人、預計日期。
4.「需要你決定」：最多兩項。若沒有，寫「沒有事項被阻塞」。
5. 以下次會議日期結尾。
## 語氣規則
直接、簡短。不要用形容詞讚美我們自己的工作。永不寫「我們很高興」或「我們一直努力」。
用數字取代形容詞：寫「載入時間由 4.1 秒降至 1.3 秒」，不要寫「效能大幅改善」。
## 絕對不要這樣做
不要編造數據。若缺少數字，寫「[需補數字]」讓人手填寫。
全文不得超過 350 字。
這就是一個真正的 Skill。它大約兩百字，完全沒有程式碼，而且它產出的報告，會比你每個星期五憑記憶重打一次的提示詞更一致。
留意它有效的原因：它定義了結構，用具體的前後對比定義了語氣，並且明確點出要避免的失敗模式。指示模糊，輸出就模糊，無論它是放在提示詞還是 Skill 裡。
自訂 Skill 可以在哪裡使用？需要什麼條件？
自訂 Skill 可在 claude.ai、Claude Code 以及 Claude API 上使用，但每個介面各有自己的上傳途徑與條件。在 claude.ai，你透過 Settings > Features 上傳 zip 檔，適用於 Pro、Max、Team 與 Enterprise 方案，並且必須先啟用程式碼執行功能。
根據 Anthropic 的文件，三條途徑如下：
--- claude.ai：於 Settings > Features 上傳 zip，需啟用程式碼執行。Skill 屬於個別使用者，不會在組織內共享。
--- Claude Code：基於檔案系統，完全不需上傳。把資料夾放進 ~/.claude/skills/（個人）或專案內的 .claude/skills/。
--- Claude API：透過 /v1/skills 端點上傳，需要程式碼執行工具與 skills-2025-10-02 beta header，Skill 於整個 workspace 共享。
另有四個預建 Skill 完全無需設定：PowerPoint（pptx）、Excel（xlsx）、Word（docx）與 PDF。如果你曾經好奇為何要求一份有格式的試算表，有時真的會得到可用檔案，那正是預建 Skill 在運作。
對實務工作者而言，claude.ai 那條路徑才是關鍵，而且值得在花一小時撰寫之前先確認你的方案。程式碼執行必須開啟，否則上傳選項的表現不會如你預期。
什麼決定 Skill 是否真的會被觸發？
是 description 欄位。它是助理在決定是否載入之前唯一看到的部分，因此它必須同時說明「這個 Skill 做什麼」與「什麼時候該用」。只寫了功能而沒寫使用時機的描述，會一直閒置，而你則在納悶為何毫無反應。
比較以下兩個版本。第一個是大多數人會寫的，第二個才是真正會觸發的：
--- 弱：description: 協助處理客戶報告。
--- 強：description: 以我們的固定格式撰寫每週客戶進度報告。當使用者要求每週報告、客戶更新、進度摘要，或提到要向客戶匯報時使用。
強的版本列出了你實際會輸入的字詞。這正是機制所在：你的請求是與描述進行比對，所以描述應該收錄你的用語，而不是一段整齊的抽象摘要。
在命名之前，有幾個硬性限制值得知道。name 欄位最多 64 個字元，只能使用小寫字母、數字與連字號，且不能包含保留字「anthropic」或「claude」。description 最多 1,024 個字元。兩個欄位都不得包含 XML 標籤。
把描述的字數用盡。1,024 個字元足以容納十多個觸發用語，而每多一個用語，就是多一個機會讓 Skill 接住你在某個星期二用了不同說法的請求。
有哪些沒人提醒你的陷阱？
自訂 Skill 不會跨介面同步。你上傳到 claude.ai 的 Skill 無法在 API 使用，透過 API 上傳的 Skill 不會出現在 claude.ai，而 Claude Code 的 Skill 與兩者都是獨立的。每個介面都要你自己維護，因此版本走樣是真實存在的風險。
另有三項限制會改變你規劃 Skill 的方式：
--- 在 claude.ai 上，自訂 Skill 以使用者為單位。每位團隊成員都要自行上傳一份，也沒有集中式的管理員派發功能。所謂「團隊標準」Skill，是一個你傳給大家的檔案，而不是某人一鍵開啟的設定。
--- 在 Claude API 上，Skill 運行於沙盒容器內，沒有網絡存取，也不能在執行時安裝套件。需要呼叫外部服務的 Skill 在這裡無法運作。
--- 在 Claude Code 中，Skill 擁有與你電腦上任何程式相同的網絡與檔案系統權限。這既強大，也正是下一點如此重要的原因。
把安裝 Skill 當作安裝軟件看待。Anthropic 的文件在這點上異常直白：只使用你自己建立、或由 Anthropic 提供的 Skill，因為惡意 Skill 可以引導助理以不符其宣稱用途的方式調用工具或執行程式碼。會從外部網址擷取資料的 Skill 風險特別高，因為擷取回來的內容本身可能夾帶指令。
審查其實不複雜。打開資料夾裡每一個檔案，包括腳本，找出任何與該 Skill 宣稱功能不符的內容。意料之外的網絡呼叫與奇怪的檔案存取，就是訊號。
關於這項技術本身，也有一個誠實的限制：Skill 救不了一個你尚未想清楚的流程。撰寫 Skill 會迫使你明確指定結構、語氣與失敗模式。如果你無法描述某項工作「做得好」是什麼樣子，那個 Skill 就會和你原本的提示詞一樣模糊，你只是白白多了一個檔案。
如何在接下來 20 分鐘內實測？
回想你最近三次把同一段指示貼進對話的情況。打開那些對話，複製你貼過的內容，用上面的範本整合成一個 SKILL.md。然後在不貼任何東西的情況下發出同樣的請求，再比較輸出。
把它拆成五個具體步驟執行：
--- 第 0 至 5 分鐘：找出你那三段重複的指示。記下你當時實際輸入的請求用語。
--- 第 5 至 12 分鐘：撰寫 SKILL.md。名稱、包含那些實際用語的描述、結構規則、語氣規則，以及一個「絕對不要這樣做」的段落。
--- 第 12 至 15 分鐘：把資料夾壓縮成 zip，在已啟用程式碼執行的情況下，透過 Settings > Features 上傳。
--- 第 15 至 18 分鐘：在全新對話中用你自然的說法提出請求，什麼都不要貼。
--- 第 18 至 20 分鐘：若沒有觸發，就在描述中再加三種說法。這幾乎總是問題所在。
第一次嘗試時應預期的失敗模式，是 Skill 完全不啟動。原因幾乎總是描述，而不是指示。先擴充觸發用語，再去動其他任何東西。
一旦第一個 Skill 成功，第二個只需十分鐘。複利效果才是重點：每一件被編碼下來的重複工作，都是一件你不再需要重新解釋的工作，而每次你察覺到不想要的輸出，指示都會變得更好。
如果你想再往前一步，Skill 與我們之前談過的兩件事天生互補：正確設定 AI 記憶，讓助理長期記住你的固定背景；以及連接 MCP 伺服器，讓它能觸及你工作真正所在的工具。Skill 告訴它怎樣做，記憶告訴它你是誰，MCP 告訴它資料在哪裡。
重點總結
Skill 把你的專業從腦袋裡、從剪貼板裡移出來，變成一個助理會自行讀取的檔案。技術門檻是一個 markdown 檔案；真正的門檻，是明確說出「做得好」是什麼樣子。
後者是沒有人能代你完成的工作，也正是槓桿所在。每一小時用來寫下你希望某件事怎樣被完成，都是你此後再也不用花時間解釋的一小時。
懂AI的冷，更懂你的難。UD 同行28年，讓科技成為有溫度的陪伴。
把一個 Skill 變成一套可運作的系統
一個 Skill 每週為你省下一小時；一組互相連接的 Skill，會改變整個團隊的工作方式。UD 幫你從單一個 SKILL.md 檔案，走到一套穩定運行的 AI 工作流程，手把手帶你完成每一步，從挑選該編碼哪些工作、工具配置，到在團隊內部署。
由 UD AI 團隊審閱。本文事實已於 2026 年 8 月 3 日對照 Anthropic 官方 Agent Skills 文件核實。產品行為與方案要求會變動，在依賴某項具體設定之前，請先查閱官方文件。
