第一個 Skill：5 分鐘體驗

在學「怎麼寫」之前，先學「怎麼用」。看到效果，才有寫的動機。

課程目標

• 跑一個現成 skill，親眼看見「按下按鈕，事情自己跑完」
• 認識 Claude Code 的 skill 目錄結構（~/.claude/skills/）
• 學會用 _INDEX.md 快速找到該用哪個 skill

零、Pre-flight Check：先確認環境

開始之前先確認你的 Claude Code 環境裝好。在 terminal 跑：

預期看到：一堆 skill 資料夾名稱列出來。

如果看到「No such file or directory」：表示你還沒裝過 skill。先跑：

這會從部門 GitHub 拉一批基礎 skill 下來。

如果 sync-skill-lab 也沒反應：找部門 onboarding 文件 ~/GitHub/claude-team-skill-lab/setup/team-memhall-onboarding.md，裡面有完整環境設定步驟。

設定卡住不是你的問題，是 onboarding 文件的事——不要因為環境問題打擊自己學 skill 的信心。

一、你身上其實已經有一堆 skill

打開 terminal，跑：

如果你是部門同事，跑了之後應該會看到一堆——team-wrap-up / team-start / team-handoff 等。這些都是部門幫你裝好的 skill。

每一個資料夾就是一個 skill。打開來看：

裡面至少會有一份 SKILL.md。複雜一點的還會有 references/、scripts/、README.md。

_INDEX.md 是什麼？

跑：

_INDEX.md 是所有 skill 的目錄。當你忘記某個 skill 叫什麼名字，去翻這份 index 比 ls 更快——因為 index 會把功能描述一併列出。

二、實際跑一個 skill 看效果

我們挑一個簡單的：team-start（部門 session 開場）。

觸發 skill 的方式

Claude Code 接受三種觸發方式：

1. 直接打 / 命令：例如 /team-start
2. 用自然語言：例如「我今天接力」「team 開場」「看看部門最近做什麼」
3. 觸發詞：每個 skill 在 description 裡會宣告「我什麼時候該被觸發」

第 4 課我們會深入第 3 點——description 是 skill 的「觸發機制」，寫得好不好決定 skill 會不會被叫到。

看一下 team-start 的 description

你會看到一段 YAML（叫做 frontmatter），裡面 description 欄位寫著「部門 session 開場。從 team-memhall 拉部門最近 5 筆 session episode...當用戶說「team 開場」「team-start」「看部門最近做什麼」「部門 status」「我今天接力」時使用。」

這就是 skill 的「啟動引擎」——Claude 看到你說的話像不像這些觸發詞，來決定要不要跑這個 skill。

三、「為什麼這麼簡單還要包成 skill？」

新手最常問的問題。答案有三層：

第一層：省你的記憶力

你不需要記得「每次開場要做哪些動作」。你只要說「team 開場」，剩下的 skill 包辦：拉 memhall、看 git、做摘要、輸出格式對齊。

第二層：標準化部門流程

如果每個人開場 / 收尾的格式都不一樣，部門記憶會混亂。skill 把流程寫死——所有人寫進 memhall 的格式都一致，未來搜尋才有用。

第三層：跨 session 累積

skill 觸發後產出的東西（例如 wrap-up 寫進 memhall），會被未來的 session 讀到。一個人手做 = 一次性；包成 skill = 部門知識資產。

四、找出哪個 skill 該用——三步法

部門 skill 數量會越來越多。當你不確定該用哪個時，用這三步：

Step 1：先翻 _INDEX.md

例如你想找「跟報告有關的 skill」：

Step 2：查 description

找到候選 skill 之後，看它 SKILL.md 開頭的 description：

description 會告訴你「什麼時候該用、什麼時候不該用」。

Step 3：看 README（如果有）

複雜的 skill 會附 README.md 給人類看：

README 通常會有具體範例、限制、跟其他 skill 的差異。

五、心智模型：skill 就像 Excel 巨集

如果你用過 Excel 巨集，skill 的概念跟它幾乎一樣：

差別只在於：Excel 巨集操作的是儲存格，Claude skill 操作的是 AI 對話 + 工具呼叫。

六、推薦你先玩過的 5 個部門 skill

如果你還沒用過，依序試試：

1. /team-start — 看部門最近做了什麼（每天早上跑）
2. /team-wrap-up — 下班前把今天的決策寫進部門記憶（每天結束跑）
3. /skill-spotter — 從今天對話撈 skill 候選（這堂課第 5 課會深入）
4. /linkedin-post — 把專案 / 觀點轉成 LinkedIn 發文草稿
5. /sync-skill-lab — 從 GitHub 拉最新 skill 到本機

跑完這五個，你對 skill 的「感覺」就會出來了。

七、結論

• Skill 是 Claude 的「按鈕」，按下去事情就照你約好的方式跑
• 部門已經幫你裝了一些，先用過再說
• _INDEX.md + description 是你找 skill 的入口
• 心智模型：skill = Excel 巨集，但操作的是 AI 對話
• 下一課我們解剖一個 skill 的內部，看 SKILL.md 到底長什麼樣

AI 協作：學了這個，跟 AI 怎麼配合？

跑現成 skill 是「消費」AI；認識自己有哪些 skill 是「盤點」AI 工具箱。盤點才是寫 skill 的起點。

你的人類優勢：

• 你知道部門業務情境——哪個 skill 你會真的用，哪個只是裝飾
• 你看 description 能判斷它符不符合你的工作節奏，AI 沒有節奏感

可以這樣跟 AI 說：

我已經裝了以下 skill [ls ~/.claude/skills/ 結果]。請對每個 skill 的 description 做一句話摘要，並依照「最可能對業務 / PM 同事有用」排出推薦先試的前 5 個。

練習題