Skip to content

建立 2026-09-19 更新 2026-09-19

Claude：Agent Skills（SKILL.md）

Anthropic 的 Claude（含 Claude Code、Claude 桌面版／網頁版）把「一直生效的專案說明」與「需要時才載入的技能」拆成兩種不同的檔案，也是本站介紹的五個工具中，最早把技能包規格獨立成開放標準（Agent Skills）的一個。

檔案放哪裡

  • CLAUDE.md（一直生效）：放在專案根目錄，每次對話一開始就會載入，適合寫專案架構、慣例、常用指令這類背景知識。本站專案自己的根目錄就有一份 CLAUDE.md，定義了這個文件網站的撰寫規範，是很好的實例。
  • 專案 Skills（需要時才載入、可版控）：.claude/skills/<skill-name>/SKILL.md，跟專案一起提交到 Git，team 每個人都會套用。Monorepo 也可以在子目錄再放一份 .claude/skills/，範圍只涵蓋該子目錄。
  • 個人 Skills（跨專案通用）：~/.claude/skills/<skill-name>/SKILL.md，放在你自己的家目錄，只在你的機器上生效，適合放個人習慣用的工作流程。
  • Plugin 提供的 Skills：安裝的外掛內建在 skills/ 目錄下的技能，會自動加上外掛名稱當命名空間，例如 /my-plugin:review。

新增、修改或刪除技能檔案後，Claude Code 會在目前 session 內立即感知變更，不需要重開。

撰寫格式

SKILL.md 的開頭必須是 YAML frontmatter（--- 一定要是檔案第一行），最重要的欄位是 description——Claude 就是靠這句話判斷「現在這個任務用不用得到這個技能」：

---
name: weekly-report
description: 產生本週工作週報。當使用者要求「寫週報」「整理這週做了什麼」時使用。
---

## 步驟

1. 讀取本週的 git log 與已關閉的 issue。
2. 依「完成事項」「進行中」「下週計畫」三段整理。
3. 用繁體中文輸出，語氣正式但簡潔。

其他常用（非必要）欄位：

欄位 用途
name 顯示名稱，預設用資料夾名稱
allowed-tools 這個技能執行時預先核准可用的工具，避免每次都跳確認視窗
disable-model-invocation 設為 true 表示只能由使用者手動 /技能名 呼叫，Claude 不會自動觸發
model／effort 這個技能執行時要不要換模型或調整思考強度

實際應用

技能資料夾可以放程式碼、參考文件等輔助檔案，不是只有一個 .md：

.claude/
└── skills/
    └── weekly-report/
        ├── SKILL.md          # 必要：frontmatter + 指示
        ├── reference.md      # 選用：更詳細的格式規則
        └── scripts/
            └── fetch-log.sh  # 選用：可執行腳本

SKILL.md 裡可以用 [reference.md](reference.md) 這種相對連結，引導 Claude 在需要時再去讀更細節的支援檔案，避免一次把所有內容塞進主檔案。

官方文件

完整規格與進階欄位：Claude Code Docs：Skills

推薦影音

Agent Skills 入門

簡述：說明什麼是 Agent Skills、跟一般「一直生效」的專案說明檔有什麼不同，並示範建立第一個技能資料夾的完整流程，適合第一次接觸的讀者。

完整 Claude Skills 指南

簡述：22 分鐘內涵蓋 frontmatter 欄位、觸發時機、資料夾結構與實際案例，適合想一次弄懂細節、不想東拼西湊查資料的讀者。

相關資料