很多人問:「Agent Skill 到底要怎麼開始做?」
其實 Anthropic 官方有一個超好用的工具叫 skill-creator,可以幫你快速初始化 Skill 結構。今天這篇教學,我將直接分享從 0 到 1 的完整流程,讓你的 AI 不再只是聊天機器人,而是能執行任務的 Agent!
第一步:使用 skill-creator 初始化
Anthropic 官方提供的 skill-creator 是最佳起點。它會幫你生成標準的 Skill 目錄結構,讓你不用從頭造輪子:
📂 my-skill/
├── 📄 SKILL.md (核心指令文件)
├── ⚙️ scripts/ (可執行腳本)
├── 📚 references/ (參考文檔)
└── 🎨 assets/ (模板、資源)
開始前必須做的兩個決策
在開始寫代碼之前,你需要先決定你的 Skill 定位:
決策一:全域 vs 專案
- 全域 Skills (~/.claude/skills/):跨專案通用,適合如「Email 回覆」、「日程管理」等工具
- 專案 Skills (.claude/skills/):特定專案專用,適合該專案獨有的業務邏輯
新手建議
先從「專案 Skill」開始,邏輯穩定後再升級到全域。
決策二:架構模式選擇
- 模式 A:單一 Skill(新手首選,結構簡單)
- 模式 B:主控 + 子 Skill(適合多步驟複雜工作流)
- 模式 C:連接現有 Skills(像積木一樣複用現成 Skill)
撰寫 SKILL.md 的 4 大核心原則
SKILL.md 是 Agent 的靈魂,請務必遵守以下規範:
原則 1:控制在 500 行以內
Context 是共享資源,精簡 = 高效。內容如果太長,請務必拆分到 references/ 資料夾。
原則 2:Description 是觸發關鍵
Claude 是靠 description 欄位來決定「何時啟用」你的 Skill!
❌ 模糊
幫助寫作
✅ 具體
當用戶要求撰寫技術部落格時,按照 XX 風格指南產出
原則 3:漸進式揭露 (Progressive Disclosure)
- Metadata (Name + Desc):始終載入,保持輕量
- SKILL.md 本體:只有被觸發時才載入
- references/:真的用到特定功能時才讀取
原則 4:小 Skill > 大 Skill
多個專注的小型 Skills 組合起來更靈活,就像樂高積木一樣,不要試圖做一個萬能的巨型 Skill。
萬用方法論:雙 Claude 測試法
這是我最推薦的開發流程,能大幅減少試錯時間:
Double Claude Workflow
- 開視窗 A (架構師):讓 Claude 幫你撰寫 Skill 代碼
- 開視窗 B (測試員):載入 Skill 進行實際測試(新對話)
- 回饋循環:把 B 遇到的報錯或問題,貼回給 A 修正
❌ 別說
「重來」— 它不知道哪裡錯
✅ 要具體指令
「這段語氣太正式,要更口語化」、「步驟三卡住了,請檢查腳本權限」
結論:從「操作員」升級為「設計師」
這不只是技術的改變,更是思維的升級:
- 操作員思維:學怎麼寫完美的 Prompt(一次性)
- 設計師思維:學怎麼封裝 Skill,建構可複用的知識資產(永久性)
與其每次重新解釋,不如一次訓練,永久使用。把你工作中最核心的 Know-how,封裝成 AI 帶不走的硬核資產——這才是 AI 時代真正的競爭力。