使用 Claude Code 技能教導 AI 您的工作流程:完整指南

@ClaudeCode_UT
日語2 個月前 · 2026年4月25日
585K
825
65
1
2.5K

TL;DR

本指南說明如何使用 Claude Code 技能來自動化重複性任務,並透過將您的個人判斷編碼至可重複使用的 SKILL.md 檔案中,以維持工作的一致性。

「我擔心自己能不能用 AI,因為我完全沒有程式設計背景……」

「我怕看到黑色的終端機畫面,實在提不起勁。」

「但又好怕被 AI 的浪潮拋在後面 😱」

東大ClaudeCode研究所 - inline image

即使處在這樣的狀態,只要讓 Claude Code 學會我「自己的行動模式」,原本每次都要花 30 分鐘的工作,現在 5 分鐘就能搞定。

其實,機會正是降臨在非工程師身上。

關鍵就在「技能」(Skills)。

用寶可夢來比喻,就是「招式學習器」(TM)。

東大ClaudeCode研究所 - inline image

在使用 Claude Code 時,你是否曾有過這些想法?

  • 它確實很聰明,但每次我都得自己設定格式、判斷標準和背景資訊。
  • 即使用了 AI,還是要手動做很多事。「這不是跟我自己做一模一樣嗎?」
  • 別人是不是用得更有效率?
  • 我有在用,但沒有真正掌握。我不知道差別在哪裡。

等你讀完這篇文章,你就能 打造出一個環境:只要在 AI 裡設定一次你的工作流程,每次都能產出一樣品質的成果。

南美洲最大電商公司 MercadoLibre 的工程師 Santiago(@santtiagom_)發表了一篇西班牙文的完整技能指南,目前正以 超過 58 萬次觀看 的熱度爆紅。

他說他自己建立了超過 50 個技能,然後在兩天內刪掉了大部分。這份指南正是基於他留下的那些、真正改變他使用 Claude 方式的真實經驗。

在開始之前,我有兩個請求。

  1. 把這篇文章存下來,並在本週內騰出 20 分鐘。
  2. 如果你認識任何使用 Claude Code 的人,請分享給他們。

這次我會用簡單易懂的方式來說明內容。

以下是原文貼文。

https://x.com/santtiagom_/status/2030305647535751338

為什麼 Claude 每次都需要重新設定

東大ClaudeCode研究所 - inline image

首先,讓我先說明一個大前提。

Claude Code 非常聰明,但它不知道「你的工作方式」。

這不是效能問題,而是它的運作機制。

Claude 每次開啟新會話時,都是從空白狀態開始。除非你每次都告訴它,否則 Claude 不知道你偏好的格式、你老闆想要什麼樣的報告、或是你寫給客戶郵件時的語氣。這些都是「你獨有的判斷標準」。

這個機制會造成三個問題。

問題 1:缺乏一致性

即使同樣要求「製作週報」,今天可能是 2000 字的詳細版本,明天可能變成三個重點條列。由於沒有設定你想要的格式,Claude 每次都得自行決定。

問題 2:缺少你獨有的判斷標準

Claude 在一般情況下表現優異,但它不知道只有在你的環境下才適用的規則,例如「在公司裡必須先講結論」或「老闆不看超過 3 頁的文件」。

所以每次你都得從頭開始設定這些背景資訊。

問題 3:設定的負擔不斷累積

打出格式規範、解釋判斷標準、分享背景資訊。

你一天花了多少時間在這種「設定」上?即使用了 AI,光是準備工作就讓你感到疲憊。

東大ClaudeCode研究所 - inline image

santtiagom_ 寫道:

「如果你能寫一次指令,之後就不用再給指令,每次都能完美完成,那會怎樣?這就是技能(Skills)能做到的事。」

技能是一種機制:把你的工作流程寫在一個檔案裡,然後設定到 Claude 中。一旦設定好,從下次開始,Claude 就會自動按照這個流程運作,你完全不用再多說什麼。

接下來,我會依序說明技能的整體概念。

技能就是 Claude 的「招式學習器」

東大ClaudeCode研究所 - inline image

你玩過寶可夢裡的「招式學習器」(TM)嗎?

只要裝上一片學習光碟,那隻寶可夢就能學會新招式。學會之後,就可以在每一場戰鬥中無限次使用,直到你讓它忘記為止。

技能就跟這些「招式學習器」一模一樣。

你建立一個名為 SKILL.md 的檔案,然後設定到 Claude 中。

從此以後,Claude 每次開啟會話時,都會依照那些指令行動。你不再需要每次都重新設定。

簡單對應一下:

  • 一個 TM → 一個 SKILL.md 檔案
  • 學會招式的寶可夢在每場戰鬥中使用 → 設定了技能的 Claude 在每次會話中套用
  • 可替換(可以重新學習)→ 技能也可以自由新增/刪除/替換
  • 存在相容性(有些招式無法學習)→ 有些技能不適合特定專案

重點在於,你的工作中也有「可以變成 TM 的任務」。

例如,製作報告時:

「先寫結論。最多用 3 個數據點。採用老闆能在 5 秒內判斷的格式。」

如果你把這個設定為技能,Claude 下次開始就會自動遵守這個規則。

製作週報時:

「三個部分:上週成果 → 本週計畫 → 問題點。數字用週增減來比較。」你也可以把這個設定成技能。

寫郵件給客戶時:

「開頭表達感謝。重點在 3 行以內。明確寫出唯一的下一步行動。」這個也可以。

東大ClaudeCode研究所 - inline image

讓我們來比較一下有技能和沒有技能的世界。

【沒有技能】

你要求「製作週報」→ Claude 用自己的格式輸出 → 你修正:「不對,先講結論」「數據限 3 個」→ 下週又從零開始全部重打。

【有技能】

你要求「製作週報」→ Claude 依照技能輸出 → 從一開始就是「結論 → 3 個數據點 → 問題點」的格式 → 修正幾乎為零。

santtiagom_ 在他的文章中反覆強調這個思維:

「一個能運作的 5 行技能,比一個有 80 條規則的完美技能更有價值。」

你不需要建立完美的指令。即使只有兩行,例如「從結論開始寫。最多 3 個數據點」,只要設定為技能就會有效果。

而這是我個人最想傳達的部分。

技能的本質不是「工作自動化」。

它是「將你的判斷標準語言化,並設定到 AI 中的行為」。

「從結論開始寫」「數據限 3 個」。這些不是工作程序,而是你的判斷標準。要優先處理哪些資訊、按照什麼順序傳達、寫到多詳細。

你把這些判斷留存在一個檔案中。就像從 TM 學會的招式成為寶可夢的力量一樣,語言化的判斷標準也成了 Claude 的力量。

判斷的資產化。 如果要我用一句話來形容技能,就是這個。

你只需要一個檔案:SKILL.md

東大ClaudeCode研究所 - inline image

技能的機制遠比你想像的簡單。

你只需要一個名為 SKILL.md 的檔案。

這個檔案的內容分為兩部分。

第一部分:附有名稱與說明的「封面」

在檔案最上方,寫下技能的名稱以及「何時應該使用」的說明。

Claude 會看這個「封面」來判斷「這個技能是否適用於目前的任務」。如果這裡寫得模糊不清,Claude 就找不到你辛苦建立的技能。

例如,只寫名稱「報告製作」,Claude 會困惑:「哪種報告?何時使用?」

如果你寫「製作給田中經理的每週銷售報告。結構:結論 → 數字 → 問題點」,那麼當收到製作週報的要求時,Claude 就會自動選用這個技能。

用 TM 來比喻,這個封面對應的是「哪隻寶可夢可以學這個招式」的判斷。

第二部分:寫有具體指令的「主體」

這部分就是你實際的工作方式。

你寫下具體的程序和規則,例如「按這個順序寫」「遵循這個格式」「一定要檢查這個點」。

技能只需要這兩個部分就夠了。

直接看實際檔案會比較快,所以這裡提供一個範例。情境是銷售團隊每週要向老闆提交週報。

markdown
1---
2name: 每週銷售報告
3description: 每週一為銷售團隊製作週報時使用。供田中經理查閱。
4---
5
6# 每週銷售報告
7
8## 格式
9- 在第一頁寫下結論(本週預計達成的目標)
10- 數字一定要與上週比較(例如:較上週 +12%)
11- 將案件分為 A/B/C 三個等級
12- 問題點限一個,並附上一個針對下週的具體行動
13
14## 田中經理的規則
15- 他不看超過 3 頁的內容。請控制在 2 頁以內
16- 他偏好表格而非圖表
17- 不要寫「檢討中」。請一律改成「在何時之前要做什麼」

這就是 SKILL.md 的全貌。

看到「封面」說明中寫著「每週一……供田中經理查閱」,Claude 就會自動判斷:「哦,這是關於週報的。」

然後,依照「主體」中的指令,它每次都會以相同的格式,製作出從結論開始、不超過 2 頁的報告。

像「田中經理的規則」這種只有你的職場才適用的規則,正是技能真正的價值所在。不管 Claude 多聰明,除非你教它,否則它不可能知道田中經理的偏好。

有兩種啟動方式。

東大ClaudeCode研究所 - inline image

第一種是你自己直接呼叫,例如輸入「/report-creation」。當你想確保它啟動時使用。

第二種是讓 Claude 讀取封面說明後自動判斷「現在應該使用這個」。如果說明寫得好,你不需要下任何指令,它就會自動啟動。

如果要建立更大的技能,可以加入輔助資料夾來放參考資料和範本,但一開始只要一個 SKILL.md 就夠了。

即使有 50 個技能,Claude 也不會變慢

東大ClaudeCode研究所 - inline image

「如果我放了很多技能,Claude 的運作速度會不會變慢?」

我想這是大家一開始都會有的疑問。

答案是:不會變慢。

Claude 並不會一次載入所有技能;它的設計是依照階段只載入必要的部分。

用 TM 來比喻,一隻寶可夢不會一直想著自己所有的招式。它會根據戰鬥狀況選擇要使用的招式。Claude 也是一樣。

第一層:先快速掃過名稱

它會先輕輕檢查所有技能的「名稱和說明」。這時還沒有讀取檔案內容。

第二層:只讀取必要技能的全文

如果發現某個技能可能與目前的要求有關,它會只讀取那個技能的全文。其他的不會碰。

第三層:若有必要,再讀取附加的參考資料

如果技能指定「也請讀取這份參考資料」,它就會一併讀取那個檔案。

換句話說,即使有 50 個技能,實際上只會載入「與當前工作相關的那 1 到 2 個」。對效能幾乎沒有影響。

不過,有一點要注意。

如果封面上的「說明」寫得很馬虎,Claude 就無法找到必要的技能。

在第一層時,它可能就會誤判為「這個這次看來不相關」,而跳過。

所以我才說封面說明最重要。清楚地寫明「這個技能應該在何時、用於何種任務」,這一點至關重要。

以實務來說,只要所有技能的名稱和說明總字數在 15,000 字以內,完全沒有問題。正常使用下,你幾乎不可能達到這個上限。

你的第一個技能,6 個步驟就能完成

接下來是實作部分。

東大ClaudeCode研究所 - inline image

我將 santtiagom_ 介紹的「建立第一個技能的 6 個步驟」逐步拆解。

不過,首先請判斷何時該建立技能。只要符合以下三個條件中的任何一個,就是該建立技能的時候了:

  • 有背景資訊是你每次都要手動輸入的(格式、規則、語氣等)
  • 有某個任務你希望每次都能產出一致的品質
  • 有某個步驟你總是會忘記

相反地,一次性任務或每次條件都完全不同的工作,就不適合用技能。

我們來看看這 6 個步驟。

1️⃣ 技能的種子藏在重複中

東大ClaudeCode研究所 - inline image

「如果你把同樣的背景資訊打了 3 次以上,那就是技能的候選對象。」

santtiagom_ 如此斷言。

會議記錄的格式、報告的結構規則、郵件的語氣。如果你每次都要輸入這些背景資訊,那就表示你應該把它設定成技能。

從今天開始,花一週時間,記錄你手動輸入到 Claude 中的內容。你會發現那些重複了 3 次以上的東西。

2️⃣ 準備一個資料夾和一個檔案

在你的 Claude Code 專案中建立一個名為 .claude/skills/ 的資料夾,在其中再建立一個以技能名稱命名的資料夾,然後在裡面放 SKILL.md 檔案。

bash
1.claude/skills/
2 └── weekly-report/
3 └── SKILL.md

這樣就準備完成了。

3️⃣ 一開始 5 行就夠了

東大ClaudeCode研究所 - inline image

記住 santtiagom_ 的話:「一個能運作的 5 行技能,比一個有 80 條規則的完美技能更有價值。」

不要一開始就想追求完美。

即使是剛才的週報範例,一開始這樣就夠了:

markdown
1---
2name: 每週銷售報告
3description: 每週一為銷售團隊製作週報時使用
4---
5
6先寫結論。數字與上週比較。問題點限一個。控制在 2 頁以內。

完成了。主體只有一行。

如何?如果只是這樣,你從今天就可以開始了吧?

在使用的過程中,如果你發現「田中經理比較喜歡表格」、「如果寫檢討中,會被退回來」,再逐一加上去就好。

前面展示的完整版本,就是這樣慢慢長大的。

東大ClaudeCode研究所 - inline image

4️⃣ 透過比較測試確認效果

分別在開啟技能和關閉技能的情況下,嘗試相同的要求。

如果輸出結果有明顯差異,就代表技能有在運作。

如果沒有差異,可能是技能內容只包含了「Claude 已經知道」的東西。試著加入只有你才知道的判斷標準。

5️⃣ 技能在失敗中成長

如果在測試後覺得「這裡還是不對」,每次都把修正加入 SKILL.md。

借用 santtiagom_ 的話:「如果同樣的修正做了 3 次,就把它加入技能。」

完美的技能不是一開始就做出來的,而是在使用過程中逐漸成長的。這種「從失敗中學習而成長」的過程,就是讓你的判斷標準越來越精準的行為。

6️⃣ Claude 本身會給出改善建議

這部分很有趣。

使用 Anthropic 官方提供的 skill-creator 技能,Claude 自己會提出建議,例如「這樣做可以讓這個技能變得更好」。

一旦你把工作流程設定到 AI 中,AI 反過來會告訴你「用這個方式更有效率」。這種循環正是技能的樂趣與優勢所在。

培養有用技能的 3 個紅旗

東大ClaudeCode研究所 - inline image

建立好技能之後,你需要確認它是否正常運作。

santtiagom_ 只列出一個判斷方法。

如果你執行同樣的任務 3 次,每次都得到不同的結果,那麼這個技能需要改進。

具體來說,要注意以下三個紅旗:

紅旗 1:指令被忽略

這通常發生在技能的用詞不夠明確的時候。

例如,即使你寫了「寫得清楚」,但「清楚」的標準對 Claude 來說是模糊的。這種情況下,Claude 只能根據自己的判斷來寫。

「先寫結論。一句話控制在 40 字以內。不要使用專業術語。」

如果你寫得這麼具體,Claude 就不會猶豫。訣竅是使用數字和具體規則,而不是模糊的形容詞。

紅旗 2:技能沒有啟動

這通常是「封面」說明有問題的狀況。

還記得之前提到的階段式載入嗎?Claude 在第一層只會看「名稱和說明」來判斷。如果這裡的說明寫得太含糊,就會被跳過,認為「這個看起來這次不相關」。

請檢查說明是否讓人一眼就看出「應該在何時、用於何種任務」。

紅旗 3:輸出太普通,有技能和沒技能沒有差別

這表示技能中寫的內容只是「Claude 本來就知道」的事情。

Claude 很聰明,所以不需要教它,它自己就能判斷一般的事情。正確的做法是在技能中寫下 只有你才知道的判斷標準

「老闆習慣從結論開始讀」「數據超過 3 點他就跳過」「不是用週增減比較他會生氣」。正是因為你的環境,這些規則才顯得必要,它們決定了技能的價值。

東大ClaudeCode研究所 - inline image

從 santtiagom_ 的最佳實踐中,我選出 4 個特別重要的重點來介紹。

① Claude 很聰明,不需要教它已經知道的事。

像「以 JSON 格式輸出」這類一般性指令是不必要的。Claude 本來就會。請教你工作的判斷標準,例如「為什麼要這樣做」以及「按照什麼順序做」。

② 超過 500 行就拆開

他說 500 行,但實際上,skill.md 本身大約 100 行以內比較好。如果內容太多,Claude Code 的判斷品質會下降。

因此,如果一個技能變得太大,就把參考資料放到另一個資料夾裡。長久使用的訣竅是讓 SKILL.md 的主體只專注於核心指令。

③ 用實際案例測試,而不是理想情境

用虛構的要求來測試沒有意義。試著用你週一實際要做的工作來使用技能。在真實工作中,你才會發現缺少了哪些指令。

④ 在使用過程中成長,而不是追求完美

如果同樣的修正做了 3 次,就把它加入 SKILL.md。這個重複的過程,是培養專屬於你的技能的最短路徑。

給想更深入使用的人

這是進階部分。

不是每個人都需要立刻這麼做,但對於想「進一步活用」的人,我來介紹一下。

1️⃣ 有官方技能可以立即使用

Claude 的開發商 Anthropic 已經正式發布了 5 種技能。

Word 檔案處理、Excel 檔案分析、PDF 閱讀、PowerPoint 產生、以及前端設計。只要從 GitHub 安裝,就能立即使用。

東大ClaudeCode研究所 - inline image

另外還有一個網站叫 skills.sh,收集了社群製作的技能。不過,這些是由第三方製作的,建議在使用前先檢查內容。其中可能包含有風險的東西,請務必小心留意。

2️⃣ 有兩種存放位置:個人用與團隊用

技能有兩種存放位置。

僅限個人使用:

如果你把技能放在家目錄中的 .claude/skills/ 中,它就成為你專用的技能,無論開啟哪個專案都能使用。

團隊共用:

如果你把技能放在專案中的 .claude/skills/ 中,它會被納入版本控制,因此團隊中的每個人都能使用相同的技能。

我個人認為,這種團隊共用是技能隱藏的核心價值。

你的判斷標準變成了一個檔案,這意味著即使團隊成員換了人,工作的品質也能維持。判斷標準不再依賴於個人。這對組織來說是一個相當大的改變。

3️⃣ 技能也能與外部服務連結

透過將技能與 MCP(一種連接到外部工具的機制)結合,Claude 就能夠直接與外部服務互動。

santtiagom_ 將此描述為「變得能夠委託流程,而非指令」。

不過,這屬於工程師的進階用法。我建議先從前一節介紹的基本 6 個步驟開始。

總結

我將這篇文章的要點整理成 6 個項目。請把它存起來,方便日後回顧。

  • 技能是「用來將工作流程設定到 AI 中的檔案」。就像寶可夢的 TM,設定一次就會每次都啟動。
  • Claude 很聰明,但不知道「你的工作方式」。沒有技能,你就得每次都自己重新設定一切。
  • 你只需要一個檔案:SKILL.md。內容只要「名稱 + 說明 + 指令」。
  • 放 50 個也沒關係。Claude 會選擇並只載入必要的技能。
  • 從小開始、逐步成長是正確的方式。一個能運作的 5 行技能,勝過一個有 80 條規則的完美技能。
  • 技能的本質不是工作自動化,而是「判斷的資產化」。將你的判斷標準語言化並設定到 AI 中的行為。

給覺得這篇文章稍微有幫助的人。

東京大學 Claude Code 研究室(@ClaudeCode_UT)是一個每天發文的帳號,主要成員是瘋狂的 Claude Code 愛好者與現役東大學生。

我們每天提供「真正有用」的資訊與專門知識,專注於實際商業應用。

追蹤我們,你就能獲得像這樣 👇 的資訊

  • 關於「讓 AI 學習工作」的技巧(如技能和 CLAUDE.md)的實用指南
  • 為非工程師解說的最新海外 AI 應用話題
  • 這裡是唯一能免費獲得「真正有用」的 Claude Code 技能的地方

如果你有興趣,請追蹤並看看!👀

東大ClaudeCode研究所 - inline image

另外,我們已經開通了官方 LINE,如果想快速獲取限定資訊,歡迎加入!讓我們一起加速學習,共同克服 AI Agent 的時代!❗️

https://lin.ee/quYxNMc

存到 YouMind

使用 YouMind 深度閱讀爆款文章

保存原文、追問細節、總結觀點,並在一個 AI 工作空間裡把爆款文章沉澱成可複用筆記。

了解 YouMind
寫給創作者

把你的 Markdown 變成乾淨的 𝕏 文章

圖片上傳、表格、程式碼區塊,往 𝕏 上手動重排太痛苦。YouMind 把整篇 Markdown 一鍵轉成乾淨、可直接發佈的 𝕏 文章草稿。

試試 Markdown 轉 𝕏

更多可拆解樣本

近期爆款文章

探索更多爆款文章