載入中
載入中

Skills

Skills 是 Claude 為了在專門任務上提升效能而動態載入的指令、腳本與資源資料夾。每個 Skill 的核心都是一個 SKILL.md 檔案——這是一組打包好的指令,您只需上傳一次,之後即可附加到任何 messages.create 呼叫中。您正在教 Claude 如何依照您的方式做某件事:您的狀態報告格式、您的審查清單、您的發布說明。Claude 會讀取 Skill、遵循該流程,並以您所設定的形式產生輸出。

Skills 與工具

值得釐清兩者的差異,因為它們解決的是不同的問題:

  • 工具(Tools) 將 Claude 連接到資料與動作。「查詢這段程式碼」、「寄送這封電子郵件」——Claude 呼叫工具,由其他東西來執行。
  • Skills 教導 Claude 一套流程。「依照這個範本產生每日狀態報告」——這是一份 Claude 會讀取並遵循的操作手冊,有時也意味著 Claude 會自行執行隨附的腳本。

一個簡單的記憶方式是:工具關乎 Claude 能做什麼,而 Skills 則關乎您希望如何完成。

工具與 Skills 的並列比較:工具連接資料、執行動作並執行程式碼——即 Claude 能做什麼;Skills 僅以指令教導流程,不執行程式碼——即您希望如何完成

還有一件值得了解的事:Skills 在啟動時不會完整載入上下文。一開始只會載入名稱與描述。當您的代理程式判斷某個 Skill 相關時,才會將完整的 Skill 載入上下文。這讓即使有許多 Skills 可用,您的上下文仍能保持精簡。

上傳 Skill

Skills 只需上傳一次到您的工作區,之後即可透過 ID 參照。您可以直接在 Claude Platform 上傳,或以程式化方式進行:

python
import anthropic
from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

skill = client.skills.create(
    display_name="Status Report Generator",
    files=files_from_dir("status-report-skill"),  # folder containing SKILL.md
)

print(skill.id)  # reference this ID in future requests

在這個範例中,我想要一個狀態報告產生器。一份好的狀態報告所需的所有規則——章節、語氣、如何摘要、如何處理阻礙事項——都預先打包在一個 Skill 中。活動紀錄本身只是請求時傳入的一個字串。

將 Skill 附加到請求

Skills 透過容器設定附加到請求——容器內有一個 skills 陣列,其中每個項目都指定一個 skill_id 與 version。以下是狀態報告產生器的完整呼叫:

python
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": skill.id,
                "version": "latest",
            }
        ]
    },
    tools=[
        {
            "type": "code_execution_20250825",
            "name": "code_execution",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
        }
    ],
)

有幾點值得特別說明:

  • 我們呼叫的是標準的 client.messages.create,不需要 beta header。Skills 在 Claude API 上已正式發布(generally available),因此不再需要 skills-2025-10-02 這個 beta header;仍會傳送該標頭的請求會繼續照常運作。
  • container.skills 是 Skill 附加的位置。它是一個清單,因此您可以在單一呼叫中疊加多個 Skills。
  • 這裡也開啟了程式碼執行(Code execution)。這是必要的:在 API 上,Skills 會在程式碼執行工具的容器內執行,這正是讓 Skill 流程能夠實際執行工作的原因——例如在終端機中執行腳本。

執行結果

輸出結果是完全依照 Skill 所指定格式產生的狀態報告。章節、語氣、阻礙事項的處理方式——這一切都來自您上傳的 SKILL.md 檔案。使用者提示只有一行;流程則存放在 Skill 中。

由 Skill 格式化產生的每日狀態報告終端機輸出,包含「已完成」與「阻礙事項」章節以及摘要

在正式上線的應用程式中,團隊就是以這種方式,在整個功能範圍內標準化輸出內容。透過這個每日狀態報告端點,每位 PM 都能得到相同的結構、相同的語氣、相同的章節,且順序一致——不需要任何人把範本複製貼上到提示中。

一個專案管理應用程式的「每日報告」頁面,每個專案的活動紀錄都有一個由 Skill 支援、一鍵產生的「產生報告」按鈕

重點回顧

  • Skills 封裝您的流程。 一個 SKILL.md 檔案(加上任何腳本與資源)教導 Claude 如何依照您的方式完成某件事。
  • 工具 vs. Skills: 工具關乎 Claude 能做什麼;Skills 關乎您希望如何完成。
  • Skills 會漸進式載入。 啟動時只會載入名稱與描述;當代理程式決定使用時,完整的 Skill 才會載入上下文。
  • 使用 client.skills.create 上傳一次,然後在任何 messages.create 呼叫中透過 container.skills 附加——這是一個清單,因此您可以疊加多個 Skills。
  • 當 Skill 的流程需要實際執行工作時,搭配程式碼執行使用。
  • 當如何完成與做什麼一樣重要時,請選用 Skill。