Claude · Skill 架構入門

Claude 的 Skill 怎麼跟著我跑、
又在每個專案都自動可用？

用一個簡單的「捷徑」設計，讓你在電腦任何地方打開 Claude，都能用到同一份 Skill。這篇給完全沒寫過程式的朋友看，每個技術名詞都有白話解釋，沒裝過 Git 也能看懂。

純新手友善每個名詞都解釋不會 Git 也能看懂

⚡ 30 秒看重點

用 symlink 捷徑設計、讓同一份 Skill 在每台電腦、每個專案、任何 Claude session 都自動可用。真實檔案放雲端資料夾（Dropbox / iCloud / Git）、捷徑放 ~/.claude/commands/。換電腦只要搬資料夾 + 重建捷徑、不會 Git 也有 3 種替代方案。

📖 讀這篇前你需要知道

這篇講的是「Claude 的 Skill 檔案放在哪、怎麼讓電腦每個地方都用得到」。 你不需要會寫程式、也不需要先裝任何工具，看完才決定要不要動手。文章裡看到技術名詞第一次出現都會有白話解釋，括號裡也都有比喻。

The Problem · 一開始的困擾

Claude 的 Skill 是什麼？為什麼要「跨專案共用」？

Skill 就是「我預先寫好的指令包」。比如我寫一個叫 /meeting-notes 的 Skill，內容是「幫我把會議錄音逐字稿整理成 5 段：重點、決議、待辦、疑問、下次行動」，之後我在 Claude 對話框打 /meeting-notes、貼上逐字稿，Claude 就會照那份指令包做事。

📖 什麼是 Skill？
Skill 是一份寫好的文字檔（Markdown 格式），告訴 Claude「遇到這種情況、請這樣做」。Anthropic 官方有正式規格，檔名一定叫 SKILL.md。比喻：像你預先寫好的「SOP 操作手冊」，老闆說「跑 SOP A」，員工就照手冊執行。

📖 什麼是 Markdown / .md 檔？
Markdown 是一種簡單的文字格式，用幾個符號（# * - 等）就能寫出有層次的文章，副檔名是 .md。比喻：像 Word 但純文字，沒有複雜按鈕，工程師都用這個寫筆記。

問題來了：我電腦上有很多不同資料夾（工作、副業、個人筆記⋯），希望所有專案都能共用同一份 Skill。但 Claude Code 預設只認一個地方（一個叫 ~/.claude/commands/ 的隱藏資料夾），怎麼讓我寫一份就到處生效？

The Gist · 解法一句話

答案：真實檔案放一個地方、其他地方放「捷徑」

核心原則

把 Skill 的真實檔案放在一個你看得到、能備份的資料夾（比如 ~/Documents/my-skills/），然後在 Claude 讀取的位置放捷徑指過去。不管 Claude 從哪個專案打開，最後都讀到同一份真實檔案。

📖 什麼是「捷徑」（Symlink，符號連結）？
Symlink 看起來像一個檔案、實際上指向另一個檔案。打開它，其實打開的是它指向的真實檔案。比喻：跟 Mac 桌面上的「替身（Alias）」、Windows 的「捷徑」一樣 — 桌面那個圖示不是真的程式，只是指向「應用程式」資料夾裡的真檔。

📖 ~/ 開頭代表什麼？
~/ 是「家目錄」的縮寫，Mac 上就是 /Users/你的名字/。~/Documents/ 就是「文件」資料夾、~/.claude/ 是「家目錄裡的 .claude 隱藏資料夾」（開頭有點代表隱藏）。比喻：~/ 就像「我的文件」、家目錄是你電腦的「私人空間」。

Architecture · 怎麼接的

一張圖看清楚捷徑怎麼接

真實檔案放在你選的資料夾、Claude 讀取的位置只放捷徑。改一邊、兩邊都生效。

📦 你選的真實檔案位置

寫 Skill 的地方

~/Documents/
my-skills/
meeting-notes.md

→ 捷徑 symlink

⚡ Claude 讀取的位置

只是個捷徑、指過去

~/.claude/
commands/
meeting-notes.md

在任何專案打 /meeting-notes → Claude 讀右邊那個捷徑 → 實際載入左邊真實檔案

完整檔案結構長這樣

左邊那欄是真實檔案位置、右邊綠色字代表「這個檔案其實是指過去的捷徑」：

~/Documents/my-skills/ # 真實檔案在這（你自己選位置） ├── meeting-notes.md # 整理會議記錄 Skill ├── daily-reflection.md # 每日反思引導 Skill ├── translate-email.md # 翻譯 Email 並整理重點 Skill └── ... ~/.claude/ # Claude Code 讀取位置（全是捷徑） └── commands/ ├── meeting-notes.md ───→ my-skills/meeting-notes.md ├── daily-reflection.md ───→ my-skills/daily-reflection.md ├── translate-email.md ───→ my-skills/translate-email.md └── ...

📖 真實檔案放哪都可以
不一定要叫 my-skills、也不一定要放在 Documents。你可以放在 ~/Desktop/、~/Dropbox/、~/iCloud Drive/ 任何位置 — 重點是你自己看得到、好備份。放 Dropbox / iCloud 的好處：自動雲端備份，換電腦時新電腦的 Dropbox 同步好就有了。

Why · 為什麼這樣設計

這樣做有 4 個好處

看得到、改得方便

真實檔案在你常用的資料夾（不是隱藏的 .claude），用 Finder、文字編輯器隨時都能打開改。

放雲端就跨電腦

資料夾放 Dropbox / iCloud / Google Drive，多台電腦自動同步，改一台、其他台跟著更新。

不會被誤刪

把 Skill 放你自己的工作資料夾，習慣性備份就會涵蓋；隱藏資料夾常被人忘記備份。

所有 Claude session 共用

改一次 Skill，新對話、舊對話、任何專案都看到最新版（因為都讀同一份真實檔）。

Two Triggers · 兩種觸發方式

Skill 怎麼被叫出來？兩種方法

除了你主動打指令、Claude 自己看到對話符合條件也會自動叫出 Skill。

方式 1 · 你主動

打 `/skill-name` 指令

在 Claude 對話框打斜線 / + Skill 名稱，明確指定要 Claude 跑這個 SOP。

/meeting-notes（接著貼會議逐字稿）

→ Claude 載入 meeting-notes Skill、自動切 5 段整理

方式 2 · Claude 自動

Claude 偵測你想做什麼、自動叫

Skill 檔案開頭可以寫「當 user 說 X 時觸發」，Claude 對話中聽到關鍵詞、自己呼叫該 Skill。

幫我把這份會議錄音整理一下

→ Claude 偵測到「整理」「會議」、主動啟動 meeting-notes Skill

📖 怎麼讓 Claude 自動觸發？
Skill 檔案最上面有一段「設定區」（技術名詞叫 frontmatter，用三條短橫線包住），寫成這個格式：

---
name: meeting-notes
description: 把會議逐字稿整理成「重點、決議、待辦、疑問、下次行動」5 段。
  當用戶說「整理會議記錄」「meeting notes」時觸發。
---

# 接下來就是 Skill 的正文內容...
## 工作流程
1. 把逐字稿讀過一遍...
2. 切成 5 段 section...

description 那行寫得越具體（「當 X 說 Y 時觸發」），Claude 越能精準幫你叫對 Skill、不會亂跳。

Automation · 自動化（進階、可跳過）

新建一個 Skill 時、捷徑怎麼自動建好？

手動建捷徑只要打 1 行指令。但如果你常常新增 Skill、可以設一個自動腳本。

方法 A：手動建捷徑（新手建議用這個）

每次新增 Skill 後、在「終端機」（Terminal）打 1 行指令：

ln -s ~/Documents/my-skills/new-skill.md ~/.claude/commands/new-skill.md

ln -s 就是「建立 symlink 捷徑」的指令，後面接「真實檔案位置」跟「捷徑要放的位置」。

方法 B：用 Hook 自動建（進階）

Claude Code 內建「Hook」機制 — 每次 Claude 用 Write 工具寫新檔，就自動跑你預先寫好的腳本：

📖 什麼是 Hook？
Hook 就是「特定事件發生時自動跑的腳本」。比如「Claude 寫完檔案後」這個事件、自動跑你預先寫好的處理腳本。比喻：像 IFTTT、Zapier 的「當 X 發生時就 Y」自動觸發。

觸發點：我或 Claude 在 my-skills/ 寫一個新的 .md 檔

Hook 啟動：Claude Code 偵測到「Write」事件、自動跑一支腳本

腳本做事：檢查這個檔案在 ~/.claude/commands/ 還沒有對應的捷徑

建捷徑：自動跑 ln -s 建立捷徑

立即可用：下一秒就能在 Claude 對話框打 /新-skill-名稱 觸發

⚠️ 一個踩過的雷

反向建捷徑會讓檔案永久消失。如果不小心把真實檔案那邊也變成捷徑、兩邊互指，再執行刪除指令，實體檔案就被刪掉、救不回來。腳本裡有檢查：「如果這個檔案本身已經是捷徑就跳過」，避免悲劇。

Bonus · 進階話題（用 Git 管理）

如果你會 Git、可以再多一層好處

這段純屬加分項。不會 Git 完全不影響前面講的捷徑設計運作，你可以跳過、需要時再回來看。

📖 什麼是 Git？
Git 是「程式碼版本管理工具」，可以記錄資料夾每次修改、看誰改了什麼、回到舊版本。不是必要、但用了會多很多好處。比喻：像 Google Docs 的「版本記錄」功能、但用在整個資料夾上。改錯了可以一鍵回到上次正確的樣子。

為什麼加上 Git 更好？

改錯了能還原：Skill 改壞了一鍵回上次正確版
跨電腦更穩：透過 GitHub 等服務同步，比 Dropbox 更可靠（適合多人協作）
看修改歷史：知道兩週前的 Skill 長什麼樣
可以分享：把資料夾推到 GitHub 公開、別人能 fork 用你的 Skill

不會 Git 也沒關係，3 個替代方案

1. Dropbox / iCloud Drive / Google Drive 同步

把 my-skills/ 資料夾放在雲端硬碟資料夾下、自動跨電腦同步。換電腦只要等同步完成就有 Skill 檔，再執行建捷徑指令。

2. 用 Mac 的「時光機」（Time Machine）備份

習慣性插外接硬碟備份、改錯了從 Time Machine 還原到前一版。

3. 手動複製備份到另一個資料夾

每次改大版本前、整個資料夾複製一份起來叫 my-skills-2026-05-18-backup 之類。粗暴但有效。

📖 想學 Git？
Mac 有些版本內建 Git、可以打開「終端機」打 git --version 看看。沒裝會跳安裝提示。入門教學推薦官方互動教學 Learn Git Branching（中文版、瀏覽器互動）。

Portability · 換電腦

換電腦怎麼搬？依你選的同步方式 3 種做法

不管你用 Dropbox、Git、還是手動複製，重點是「先把真實檔搬過去、再重建捷徑」。

📋 通用流程（3 步）
1. 把 my-skills/ 資料夾的真實檔案搬到新電腦（看你怎麼同步）
2. 確認新電腦有 ~/.claude/commands/ 資料夾（如果沒裝過 Claude Code、先裝）
3. 對每個 Skill 檔執行建捷徑指令

情況 A：用 Dropbox / iCloud（最簡單）

# 等 Dropbox 同步完 my-skills/ 後，跑這個迴圈一次建好所有捷徑：
for f in ~/Documents/my-skills/*.md; do
  ln -s "$f" ~/.claude/commands/
done

情況 B：用 Git（要先裝 Git）

# 在新電腦上：
git clone git@github.com:你的帳號/你的-skills-repo.git ~/Documents/my-skills
cd ~/Documents/my-skills

# 然後同樣跑建捷徑迴圈（或預先寫好一支 setup script）：
for f in *.md; do
  ln -s "$PWD/$f" ~/.claude/commands/
done

📖 git clone 是什麼？
把線上 Git 倉庫的完整內容下載到電腦上。所有檔案、所有歷史修改都會一起下來。新電腦上要先裝 Git 才能用， Mac 安裝方式：開「終端機」、打 git --version、會跳安裝提示按確認。比喻：像下載 Google Drive 整個資料夾、但同時下載所有舊版本歷史。

情況 C：手動複製（最沒技術門檻）

# 1. 用隨身碟 / AirDrop / 雲端 把 my-skills/ 整個複製到新電腦的 ~/Documents/
# 2. 打開「終端機」（Terminal），跑同樣的建捷徑迴圈：
for f in ~/Documents/my-skills/*.md; do
  ln -s "$f" ~/.claude/commands/
done

Take Away · 一句話帶走

你不用真的會寫程式，但要知道這個設計

重點不是技術多複雜，是「真實檔案只能有一份、其他地方都是它的鏡子」這個原則。只要懂這個，你就懂為什麼 Skill 改一次到處生效、為什麼跨電腦搬只要搬資料夾 + 重建捷徑就完成。

延伸閱讀 👉 Workflow vs Skill 差在哪？