Claude Skills 解析：漸進式揭露的三個層級

Claude Skill 在實體上就是一個資料夾。它不是託管服務，不是二進位檔，也不是你貼在對話開頭的一段文字——而是一個包含 SKILL.md 檔案，以及工作所需其他內容的目錄。Skills 幾乎所有值得注意的地方，都源自這一個決定，因為資料夾是代理可以選擇性開啟的東西。提示詞則無法被選擇性開啟。它不是在對話裡，就是不在。

Anthropic 的說明文件將這種安排描述成類似你會為新團隊成員建立的新人導引手冊那樣組織，而這個類比比乍看之下更為貼切。沒有人會在開始工作前把新人導引手冊從頭讀到尾。他們會讀符合眼前問題的那一頁，並相信當自己需要時，其餘內容仍在那裡。一項技能也建立在同樣的賭注上：一套流程的大部分內容，在大多數時間裡都可以留在磁碟上。

檔案系統優先，能力其次

Claude 在具備檔案系統存取權限的虛擬機器中運作。這正是技能得以是一個目錄、而非一筆設定項目的先決條件，因為它讓代理能列出資料夾、讀取檔案，並以與人相同的方式，依循參照指向另一個檔案。在此基礎之上，技能會將指令、中繼資料，以及諸如腳本與範本等選用資源一併封裝起來。

結果形成的能力，大於資料夾裡的任何單一檔案。指示說明了如何執行任務。內附的腳本可以執行其中一部分，而不必以文字敘述說明。參考文件可以存放需要查閱而非記住的資料。讓這三樣東西成為一個系統而非一疊雜物的，是它們依序顯現的方式，而這正是 Anthropic 稱為「漸進式揭露」的部分——隨著需求分階段載入資訊，而不是預先耗用上下文。

第 1 級：總是會載入的兩個欄位

每個技能都以 YAML frontmatter 開頭，其中包含名稱與描述。Claude 會在啟動時載入這些中繼資料，並將其納入系統提示中。這是技能中唯一在任何請求出現之前就已存在的部分；而且在技能被觸發之前，只有其名稱與描述會佔用上下文。

描述同時承擔三項功能，而將它們分開來看，就能解釋為什麼有那麼多技能會被默默忽略。它是一個標籤，說明這個東西叫什麼。它是一筆索引項目，是 Claude 判斷該技能是否相關時，用來比對請求的文字。它也是一項範圍聲明，因此 Anthropic 的指引指出，它必須同時說明該技能做什麼，以及何時使用它。只做到第一項的描述，會讓比對器無從比對。

以同一項技能的兩個版本為例。其中一個版本被描述為「填寫並驗證 PDF 表單」，適用於請求涉及完成或檢查 PDF 表單時。另一個版本則被描述為「協助處理文件」。第一個版本點明了動作與情境；第二個版本兩者皆無。若一項技能的描述兩者皆未點明，它就會靜靜躺在磁碟上無人讀取，而代理則以曠日廢時的方式完成任務——這並非因為該技能失效，而是因為它從未被找到。

第 2 層：內文，當描述相符時閱讀

當請求符合描述時，第二層便會展開：SKILL.md 的正文。那就是流程——工作流程、最佳實務、指引——而且它是寫給已經判定這項技能正是處理該任務的合適工具的代理程式。團隊會在這裡寫下原本每次對話都得反覆重述的步驟，指向更深入素材的指引也存放在這裡。

這裡的順序安排，重要性不亞於第 1 層。主體內容不會在啟動時載入，也不會為了以防萬一而預先載入。它是在決定作出之後才送達的，這意味著這個決定必須單憑第 1 層就能作出。描述含糊的技能在第 2 層無從補救，因為第 2 層根本不會被讀到。

第 3 級：因為有某個東西指向它們而開啟的檔案

第三層是資料夾的其餘部分：從 SKILL.md 參照的其他檔案。Anthropic 的例子是一個 FORMS.md，裡面放著關於填寫表單的進階指引，刻意不放在主要指示中，讓那些指示保持簡短，只有在任務需要時才取用這些細節。腳本與範本也屬於這一層。

結構性效果是，技能可以承載大量素材，而不必一次全部承載。一個資料夾可能存放一份主指令檔、一份詳細參考資料、一組範本和一支腳本，而某個特定任務可能只會用到其中一項。凡是沒有任何東西指向的內容都會留在磁碟上，而在代理中，磁碟並不是稀缺資源。上下文才是。

這也是這種格式突破提示詞所遭遇上限的地方。提示詞必須短到值得貼上才行。技能所捆綁的素材，則受限於一個目錄所能容納的內容，因為真正送達模型的，只有任務實際觸及的那一部分。

為什麼順序就是設計本身，而不是細節

由此會產生三個後果；而正是這三者合在一起，才構成了這件事值得真正理解、而不只是單純知道的原因。

• 上下文是一項預算，而始終載入的內容是一筆固定成本。系統提示中的每一項內容，在每一次請求時都要付出代價，包括那些與該技能毫無關係的請求。漸進式揭露把固定成本轉為條件式成本：描述永遠載入，指示僅在相關時載入，參照則在被引用時才載入。

• 描述是一種介面。 它是技能中唯一保證會被看見的部分，因此作者必須在這裡思考觸發，而不只是內容。

• 一項技能有三種維護速度。當技能應以不同方式觸發時，中繼資料會變動；當工作流程改變時，主體會變動；而當底層素材改變時，參考資料會變動。將它們分開，可避免參考資料的更新演變成改寫指示。

成本是效益的鏡像。每一個層級邊界，都是模型必須正確做出決定的地方。描述得太窄，意味著這項技能永遠不會被觸發，資料夾就成了無用負擔。描述得太寬，則意味著它會在不適用的工作上被觸發，而其指示便成了無關任務的負擔。漸進式揭露讓描述成為關鍵支撐，而始終存在的長提示詞從來做不到這一點。

Anthropic 目前已推出哪些功能，以及你自己的技能從何而來

Anthropic 推出預先建置的 Skills，支援 PowerPoint、Excel、Word 與 PDF——涵蓋簡報、試算表、文件及格式化 PDF 輸出。這些 Skills 可在 claude.ai、Claude API、AWS 上的 Claude Platform 及 Microsoft Foundry 使用，但需留意：在 Foundry 上，它們需要採用 Hosted on Anthropic 部署模式。

那些是親眼看到機制運作最快的方法，而不只是閱讀相關說明。載入順序與你自己撰寫的任何內容完全相同；預先建置的技能與自訂技能之間的差別，在於資料夾是由誰撰寫的，而不在於它如何送達模型。

自訂技能可以在 Claude Code 中建立、透過 Claude API 上傳，或在 claude.ai 設定中新增。Anthropic 為這些技能列出的好處，正是任何可重複使用事物會帶來的那類好處：讓 Claude 專精於特定領域任務、一次建立指引而無須反覆重述，以及組合多項技能來處理多步驟工作。最後一項最直接源自其架構，因為如果每項技能都是一個隨需開啟的資料夾，那麼在實際工作需要它們之前，堆疊多項技能幾乎不會造成什麼成本。

一項技能不是提示詞，也不是連接器

有三件事在對話中常被混為一談，而載入順序讓這些區別容易掌握。

提示詞是對話層級的。它從第一輪就存在，會影響那段對話中的一切，並隨對話結束而消失。技能則是隨需取用：它在對話開始前就存在，其中大部分根本不會進入對話，而會進來的部分，是因為某個描述相符。這就是告訴代理該如何行事，與給它一個可自行取用的東西之間的差別。

連接器關乎觸及範圍。連接器是應用程式存取，這意味著它們決定代理程式能接觸什麼；技能則決定代理程式在能接觸之後該如何完成某件事。一個團隊可以擁有極佳的連接器，卻仍產出不一致的文件，因為存取不等於程序。它也可以擁有極佳的技能，卻仍看不到資料，因為程序不等於存取。

Anthropic 的文件將 Skills 與模型情境協定（Model Context Protocol）視為不同的層次，而三層機制說明了為何這樣的分隔如此乾淨。載入順序關乎資訊何時送達，而非資訊來自何處。

捐款適合放在哪裡，請用一段文字說明。

2026 年 10 月 22 日，Anthropic 將 Agent Skills 標準捐贈給 Linux Foundation 旗下的 Agentic AI Foundation——包括名稱、標誌、GitHub 組織與 agentskills.io 網域——並由 Anthropic、Google、OpenAI 及其他公司的工程師以個人身分維護。以上種種都不會改變上述機制。資料夾格式、YAML frontmatter、載入順序與預先建置的文件技能，都與前一天完全相同。改變的是名稱的擁有者；這對標準的長期穩定性至關重要，但對你今天下午如何撰寫技能毫無影響。

在安裝技能前先閱讀它

如果這三個層次就是架構，它們同時也構成一張簡短的審查清單。先讀描述，因為它決定後續是否還會發生任何事：描述應該用一項請求理當會使用的措辭，指出這項技能做什麼、以及何時該使用它。第二讀 SKILL.md，因為它是代理會遵循的流程，而它讀起來應該像寫給一位能幹同事的指示，而不是對你希望會發生什麼的摘要。第三讀它引用的內容。然後讀腳本。

最後那一項並不是偏執。這種格式允許技能在附帶可選資源的同時攜帶指示，而資源可以包含可執行程式碼。因此，你安裝的技能不只是塑造對話的文字；它是一個資料夾，有能力的代理會從中開啟檔案並據此行動。逐層模型確切告訴你該往哪裡看，這比大多數已安裝項目所提供的還多。

有一條界線值得向從我們自家頁面前來的讀者說明。OrcaRouter 負責路由模型呼叫，而我們不託管 Anthropic 的任何應用程式或其技能介面——技能是在代理的檔案系統所在之處執行，而那並不是我們這一層。我們所做的位於模型選擇之下：超過 200 個模型藏在同一把 OpenAI 相容金鑰之後，供應商牌價原樣傳遞、不加價，並在某個供應商無法使用時，在各供應商之間自動容錯切換。技能決定一項任務應該怎麼完成。路由器決定由哪個模型來完成，而這兩層都不需要對彼此知道太多。

漸進式揭露對它所解決的限制是誠實的。上下文是有限的，流程是冗長的，而任何一套流程的大部分內容，都與你眼前手上的任務無關。一個名稱、一個主體和一組檔案，並不是什麼複雜的設計；它是能讓代理承載大量知識、卻只需持有其中所需部分的最小設計。

這就是為什麼在一個建構完善的技能中，最關鍵的那一行也是最簡短的一行。資料夾裡的其他一切都是館藏。描述就是卡片目錄，而當目錄出錯時，館藏再豐富也形同不存在。