AI Agent + SKILL.md 教學

AI Agent 與 SKILL.md 教學：建立可擴展的 AI 技能系統

近年來 AI 技術逐漸從「聊天型 AI」演進到「AI Agent」。 與單純回答問題的 LLM 不同，AI Agent 可以自主規劃任務、 呼叫工具並完成複雜工作流程。

在許多現代 AI Agent 系統中， SKILL.md 是一種用來定義 Agent 技能的方式， 讓 AI 能夠透過模組化技能來完成任務。

---

什麼是 AI Agent？

AI Agent 是一種可以自主執行任務的 AI 系統， 它不只回答問題，而是可以「幫你做事情」。

• 理解任務
• 規劃執行流程
• 選擇工具
• 執行操作
• 回傳結果

AI Agent 架構

元件	說明
LLM	負責語言理解與推理
Planner	負責拆解任務與決策
Tools	可呼叫的外部工具
Memory	儲存任務上下文
Skills	AI Agent 可使用的技能（SKILL.md）

---

什麼是 SKILL.md？

SKILL.md 是一種用來定義 AI Agent 技能的 Markdown 文件。

每個 Skill 都描述了：

• 技能名稱
• 用途
• 何時使用
• 相關資源

AI Agent 在執行任務時會閱讀 SKILL.md， 判斷是否應該使用該技能。

---

YAML Frontmatter 的重要性

在 SKILL.md 中，通常會使用 YAML Frontmatter 來描述技能的基本資訊。

YAML Frontmatter 是一段位於文件開頭的結構化資料， 讓 AI Agent 可以快速解析技能的用途。

---
name: search_web
description: Search information from the internet
tools:
  - browser
---

# Web Search Skill

This skill allows the agent to search information online.

透過 YAML Frontmatter，AI Agent 可以快速知道：

• 技能名稱
• 技能用途
• 需要使用哪些工具

---

SKILL 的目錄結構

在較完整的 AI Agent 系統中， 一個 Skill 通常不只是一個 Markdown 文件， 還會包含相關資源。

常見結構如下：

skills/
 ├─ search_web/
 │   ├─ SKILL.md
 │   ├─ references/
 │   │   └─ search_api.md
 │   └─ scripts/
 │       └─ search.py

各目錄用途

資料夾	用途
SKILL.md	技能說明與使用方式
references/	提供額外文件或說明
scripts/	實際執行技能的程式碼

這樣的設計可以讓 AI Agent 在需要時再載入相關資料， 而不是一次讀取所有資訊。

---

Progressive Disclosure（漸進式揭露）

SKILL.md 的設計理念之一是 Progressive Disclosure（漸進式揭露）。

意思是：只在需要時才提供詳細資訊。

例如：

• Agent 先閱讀 SKILL.md
• 如果需要更多資訊才讀取 references/
• 需要執行功能時才使用 scripts/

這種方式可以避免在 prompt 中放入大量資訊。

---

為什麼比 Long Prompt 更有效？

傳統 Prompt Engineering 常常使用「長提示（Long Prompt）」， 將所有規則與文件一次提供給 AI。

但這樣會有幾個問題：

Long Prompt	SKILL System
Token 消耗高	只載入需要資訊
Prompt 很難維護	技能可模組化管理
上下文容易混亂	技能結構清晰
難以擴展	可以新增更多 Skills

透過 Progressive Disclosure， AI Agent 可以只載入必要資訊， 因此能夠 節省 Token 並提升準確度。

---

實際應用場景

AI Agent + SKILL.md 可以應用在許多開發場景：

• 自動程式開發
• DevOps 自動化
• 資料分析
• 研究助理
• 企業工作流程自動化

例如一個開發型 AI Agent 可能擁有以下技能：

• search_documentation
• generate_code
• run_tests
• fix_bug

---

總結

AI Agent 正在改變我們與 AI 互動的方式， 從單純的聊天工具轉變為能夠執行任務的智能系統。

透過 SKILL.md 與模組化技能架構， 我們可以為 AI Agent 建立可擴展的能力系統。

再搭配 YAML Frontmatter、 references / scripts 結構 與 Progressive Disclosure， 可以讓 AI Agent 在保持高效率的同時， 也能維持精準與可維護性。

---

如果你是開發者，現在正是開始研究 AI Agent 架構的最佳時機。