Part 7A：Skill 認知與架構

Skill = AI 的「食譜」

什麼是 Skill 為什麼需要檔案架構雙平台支援

曾慶良(阿亮老師) | AI 協作簡報實戰工作坊

💡 什麼是 Skill？用「食譜」來理解

🚫 沒有 Skill = 不給食譜

🧑‍🍳 你跟廚師說：「幫我做一道菜」

廚師不知道你要什麼口味
每次做出來都不一樣
要花很多時間溝通
結果可能不是你想要的

✅ 有 Skill = 給專屬食譜

📖 你給廚師一本你家的食譜：

清楚寫明材料、步驟、火候
每次照做，品質一致
一看就懂，快速產出
可以傳給其他廚師使用

🎯 定義：Skill 就是用來告訴 AI「遇到這種任務，你就照這個步驟做」的 SOP 操作手冊。

🎯 為什麼需要 Skill？

❌ 沒有 Skill	✅ 有 Skill
每次都要重複說明同樣的需求	一鍵執行，自動按照 SOP 操作
AI 產出品質不穩定	標準化輸出，品質一致
複雜任務需要多次對話指導	多步驟流程自動串接
學到的經驗無法累積	知識封裝，可重複使用
無法分享給團隊/朋友	打包分享，大家都能用

💡 關鍵價值：把你的經驗和流程「打包」起來，以後用一句話就能呼叫 AI 完成整套工作！

📍 Skill 放在哪裡？（超級重要！）

🔥 雙平台支援：同一份 SKILL.md 內容，放在不同路徑就能支援兩種 AI 工具！

🔵 Google Antigravity

.agent/skills/你的技能名稱/
├── SKILL.md          ← 必要
├── scripts/          ← 選用
├── data/             ← 選用
└── resources/        ← 選用

🟣 Claude Code

.claude/skills/你的技能名稱/
├── SKILL.md          ← 必要
├── scripts/          ← 選用
├── data/             ← 選用
└── resources/        ← 選用

📌 重點：只有 SKILL.md 是必要的！其他資料夾都是選用，可根據需求添加。

📁 Skill 的完整檔案架構

my-awesome-skill/
│
├── SKILL.md          [必要] 技能說明書
│                     AI 的操作手冊
│
├── scripts/          [選用] 輔助腳本
│   ├── search.py     Python 腳本
│   └── deploy.sh     Shell 腳本
│
├── data/             [選用] 資料檔案
│   ├── styles.csv    CSV 資料
│   └── config.json   JSON 設定
│
└── resources/        [選用] 模板檔案
    ├── template.html HTML 模板
    └── readme.md     文件模板

📋 各資料夾用途說明

資料夾	用途
`SKILL.md`	核心！AI 讀這份就知道怎麼做
`scripts/`	放 Python/Shell 腳本處理複雜邏輯
`data/`	放 CSV/JSON 資料供腳本查詢使用
`resources/`	放模板檔案 AI 讀取後填入參數

⚡ AI 執行 Skill 的流程

👤

Step 1

使用者下指令

→

🔍

Step 2

AI 搜尋 Skill

→

📖

Step 3

讀取 SKILL.md

→

⚙️

Step 4

執行指定動作

→

📄

Step 5

回傳結果報告

🤖 自動觸發（推薦）：
AI 根據 SKILL.md 的 Description 自動判斷要不要使用這個 Skill

👆 手動觸發：
使用 /skill 技能名稱 指令明確呼叫特定 Skill

📋 Part A 重點回顧

                        🧠 核心概念
                        Skill = AI 的食譜/SOP
讓 AI 遵循固定步驟執行任務
一次設定，重複使用
品質穩定，可分享給他人

                    

                        📁 檔案架構
                        SKILL.md 是唯一必要檔案
scripts/：放 Python 腳本
data/：放 CSV/JSON 資料
resources/：放模板檔案

                    

🔵🟣 雙平台支援

Antigravity：.agent/skills/技能名稱/
Claude Code：.claude/skills/技能名稱/

🎉 Part A 完成！

你已經理解 Skill 的基本概念了

接下來學習如何撰寫 SKILL.md 檔案

📚 回到學習地圖前往 Part B：SKILL.md 撰寫 →