蓋你的第一個 Skill
規劃、撰寫、組織 SKILL.md 檔
⏱ 預估 ~7 分鐘
01 · 讀一讀
在寫一行之前，你要找出可重複的流程。
想你一直跟 Claude Code 講的：「用 functional component。」「先寫測試。」「用 conventional commit。」「顯而易見的程式碼不要加註解。」
每個都是 skill 候選。最好的 skill 抓住你每次遵守的流程 — 不是一次性請求。
問自己：「我每週至少打一次給 Claude Code 的指令是什麼？」 那就是你的第一個 skill。
重點整理
- 好 skill 抓住可重複的流程，不是一次性任務
- 想你每次 Claude Code session 都打的指令
- 從一個具體流程開始，不要一次全部
- Skill 應該有立場 — 清楚規則，不是含糊建議
02 · 看程式碼
每個 SKILL.md 從 --- 之間的 YAML frontmatter 開始。下面是三個主要欄位。
YAML Frontmatter
---
name: Code Reviewer
description: Reviews code for bugs, style, and best practices
instructions: Use this skill when reviewing pull requests or code changes
---
name 是 skill 在 /skill 清單裡顯示的名字。description 告訴 Claude(跟你)這個 skill 在做什麼。instructions 給 Claude 提示什麼時候啟用這個 skill。三個都可選，但強烈建議都填。
03 · 選擇題
你剛看到三個標準 YAML frontmatter 欄位。下面哪個不是?
- name
- description
- language
- instructions
04 · 步驟說明
我們一步一步蓋一個真實 skill。我們做一個「Code Reviewer」skill，執行你團隊的審查標準。
1. 建 skill 資料夾
在你專案裡建目錄結構。跑：mkdir -p .claude/skills/code-reviewer。-p 旗標在父目錄不存在時建立。這把 skill 放在你的專案裡，可以 commit 到 git。
2. 寫 YAML frontmatter
打開 .claude/skills/code-reviewer/SKILL.md，加 metadata 區塊。從一行 --- 開始，加 name、description、instructions 欄位，再用另一行 --- 結尾。
3. 加指令本體
在結尾的 --- 下面，用自然語言寫你的審查規則。用 markdown 標題組織區塊、用條列寫具體規則。明確 — 「檢查使用者輸入的 SQL injection」比「審查程式碼」好太多。
4. 用 /skill 測試
在 Claude Code 對話打 /skill，看你的新 skill 列在裡面。選它啟用。現在請 Claude 審一些程式碼 — 它應該遵守你的規則。沒有的話，精修再試。
05 · 看程式碼
下面是完成的「Code Reviewer」skill — 完整、production-ready 的 SKILL.md。
code-reviewer/SKILL.md
---
name: Code Reviewer
description: Reviews code changes for bugs, security, and style
instructions: Use when asked to review code, PRs, or diffs
---
## Review Checklist
When reviewing code, check for:
- **Security**: SQL injection, XSS, command injection, hardcoded secrets
- **Error handling**: Are errors caught? Are they logged? Do they fail gracefully?
- **Edge cases**: What happens with empty input? Null values? Very large data?
- **Naming**: Are variables and functions named clearly?
- **Tests**: Are there tests for the new code? Do existing tests still pass?
## Output Format
Structure your review as:
1. **Summary** — one sentence overview
2. **Issues** — bullet list, severity (high/medium/low)
3. **Suggestions** — optional improvements (not blockers)
本體用標準 markdown — 標題、粗體、條列。Claude 把它當指令照做。審查清單告訴 Claude 看什麼，輸出格式確保每次的審查都一致、有結構。
06 · 填空
SKILL.md 檔的 YAML frontmatter 用兩行 _____ 包起來
07 · 分類拖拉
SKILL.md 檔有特定結構。想 Claude 載入 skill 時最先讀什麼，把這些部分從上到下排序。
(本節為互動練習，請啟用 JavaScript 體驗)
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案，非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。