Claude Code Skills 教學：把重複工作變成一個 / 指令

上一篇的 CLAUDE.md，讓 Claude Code 每次開新對話都讀到你的規矩。這篇處理另一種麻煩：同一類工作你會一直做，每次都要交代一大段。例如幫遊戲換配色，每次都要說「顏色要分得清楚、不要改到遊戲邏輯、改完列測試步驟」。把這段做法寫成一個 skill，之後只要打 /new-skin 海洋。

快速回答 Skill 是一份寫好做法的說明檔，放在專案的 .claude/skills/名稱/SKILL.md，名稱就是指令：打 /名稱 就會照做。最省事的做法是直接請 Claude Code 幫你寫。第一次建立 skills 資料夾後輸入 /reload-skills，之後就能用 /new-skin 海洋 這種「指令＋參數」的方式重複使用。

做完這篇，你會有

• 一個自己的指令 /new-skin，給主題名稱就幫遊戲加一套配色
• 遊戲裡三套可以切換的配色：摩卡、海洋、萬聖節
• 看得懂 SKILL.md 的基本長相，之後會自己改

開始之前要準備：前幾篇的 snake-game 資料夾，最好已經照上一篇寫好 CLAUDE.md。

步驟 1：請 Claude Code 幫你寫 skill

在遊戲資料夾啟動 Claude Code，輸入：

幫我建一個 skill 叫 new-skin：給一個主題名稱，就幫遊戲加一套對應的配色，玩家可以在遊戲裡切換。只要建 skill，先不要改遊戲

「先不要改遊戲」很重要，不然它可能順手就把配色做下去了。實測時它自己決定用 T 鍵和按鈕切換配色，你的版本可能不同；想指定切換方式，就寫進這句話裡。

步驟 2：看懂 SKILL.md

打開 snake-game/.claude/skills/new-skin/SKILL.md，最上面這幾行最重要：

---
name: new-skin
description: 給一個主題名稱（例如「海洋」「萬聖節」「Game Boy」），為貪食蛇遊戲加一套對應的配色……
argument-hint: <主題名稱>
---

主題名稱：`$ARGUMENTS`

下面其餘的內容，就是你以前每次都要交代的那一大段做法。想改做法，直接改這個檔案。

步驟 3：重新載入 skill

輸入 /reload-skills，畫面會顯示多了 1 個 skill。接著打 /new-sk，選單就會出現 /new-skin。

只有第一次建立 skills 資料夾時需要這一步，之後新增或修改 skill 會自動生效。

步驟 4：用一次，再換主題用一次

輸入：

/new-skin 海洋

第一次它會先把遊戲改成可以換配色，再加上海洋配色。跑完之後，再用一次：

/new-skin 萬聖節

兩次你都只打了一行，配色要分得清楚、不能動到遊戲邏輯、最後列測試步驟，全都照 SKILL.md 做了。

步驟 5：打開遊戲，按 T 換配色

打開 index.html，按 T 或點下方的配色按鈕，三套配色輪流切換，重新整理也會記得你選的那套。

想要新主題，再打一次 /new-skin 主題名稱 就好。

常見卡關

• 打 /new-skin 選單裡找不到：skills 資料夾是這次對話中途才建的，輸入 /reload-skills，或重開 Claude Code。
• 它寫的 SKILL.md 很長，看不懂：只要看懂最上面的 name、description 兩行就能用。實測它寫了 97 行，下面都是給它自己看的做法。
• 沒打指令，它也自動用了 skill：這是正常的，Claude 會看 description 判斷。不想讓它自己用，在 SKILL.md 開頭兩條 --- 之間，和 name、description 放在一起，加一行 disable-model-invocation: true。
• 同一個主題跑兩次：好的 skill 會先檢查有沒有重複。實測這份 skill 有寫「同名主題先問使用者」。

你做到了

• 請 Claude Code 寫好一個 skill，看懂 SKILL.md 的幾個欄位
• 用 /reload-skills 讓新指令出現
• 用 /new-skin 加了海洋、萬聖節兩套配色

skill 讓它會做事，下一篇處理另一件事：哪些動作讓它自動做、哪些一定要先問你。

常見問題

skill 和 CLAUDE.md 差在哪？

CLAUDE.md 是每次都會讀的規矩，例如「用中文回覆」；skill 是某一類工作的做法，用到才載入，例如「加一套配色」。

可以讓 skill 在所有專案都能用嗎？

可以。放在 ~/.claude/skills/名稱/SKILL.md，你所有專案都看得到；放在專案裡的 .claude/skills/，只有這個專案能用，也能跟團隊共用。

SKILL.md 一定要有 name 和 description 嗎？

都不是必填。沒寫 name 就用資料夾名稱當指令；官方建議至少寫 description，Claude 才知道什麼時候該用。

參數有好幾個怎麼辦？

用 $0、$1 分別拿第一個、第二個參數。參數有空格時用引號包起來，例如 /new-skin "Game Boy" 亮色。

下一步

• Claude Code 權限設定懶人包：該自動的自動、該問的一定問：下一篇，設定哪些動作要先問你。
• CLAUDE.md 是什麼？寫一次，Claude Code 每次開工都先讀你的規矩：還沒寫 CLAUDE.md，先看這篇。

參考資料

• Anthropic, Extend Claude with skills（Claude Code 文件，位置、欄位、參數、自動重新載入、/reload-skills） https://code.claude.com/docs/en/skills
• Anthropic, Commands（Claude Code 文件，/skills、/reload-skills） https://code.claude.com/docs/en/commands