# 技能功能概覽

## 什麼是技能？ <a href="#what-is-skill" id="what-is-skill"></a>

技能就像是 AI 助理的**專業證照**——每學會一個技能，AI 助理就多了一項專業能力。如果說工具是 AI 助理的「工具箱裡的螺絲起子」，那技能就是「一整套標準作業流程（SOP）」，不只告訴 AI 助理用什麼工具，更告訴它**什麼時候用、怎麼用、用了之後要怎麼回覆**。

想像你經營一間客服中心：

**沒有技能：**

* 客戶：「我想退貨」
* AI 客服：「好的，請問您的訂單編號？」*（只能做基本問答）*

**有了技能：**

* 客戶：「我想退貨」
* AI 客服：「好的！」💫 *（自動展開退貨流程技能）* → 查詢訂單 → 確認退貨資格 → 產出退貨單 → 「您的退貨申請已建立，退貨單號為 RT-20260324，預計 3-5 個工作天處理完成。」✅

### 技能的核心組成 <a href="#skill-core-components" id="skill-core-components"></a>

每個技能由三個部分組成：

```
技能 = 指令內容 + 附加工具 + 資源檔案
        │            │           │
        ▼            ▼           ▼
   SOP 流程      可調用的     輔助參考
  （怎麼做）    外部能力      的附件
```

* **指令內容**：Markdown 格式的詳細指令，就像一份 SOP，引導 AI 助理一步步完成任務
* **附加工具**：技能需要使用的工具（MCP 工具、API 工具等），讓 AI 助理能執行實際操作
* **資源檔案**：技能執行時可參考的附件資料（僅限上傳方式建立的技能）

## 技能的運作流程 <a href="#skill-workflow" id="skill-workflow"></a>

一個完整的技能運作流程如下：

1. **建立技能：**
   * 定義技能的名稱和描述（描述決定 AI 何時觸發此技能）
   * 撰寫詳細的指令內容（Markdown 格式的 SOP）
   * 綁定所需的工具
2. **綁定至 AI 助理：**
   * 在 AI 助理的設定中選擇要使用的技能
   * 一個 AI 助理可以綁定多個技能
3. **使用者提問：**
   * 使用者以自然語言向 AI 助理提出請求
   * *範例：* 「幫我查一下我的休假天數」
4. **AI 助理判斷與展開技能：**
   * AI 助理根據使用者的問題，比對已綁定技能的描述
   * 判斷該問題應由哪個技能處理
   * 自動展開該技能的完整指令內容
5. **執行指令並調用工具：**
   * AI 助理依照技能指令中的步驟逐一執行
   * 需要時自動調用技能附加的工具（查詢資料庫、呼叫 API 等）
6. **生成最終回覆：**
   * AI 助理彙整工具回傳的結果
   * 依照技能指令中定義的回覆格式，生成結構化的回答

## 技能的主要優勢 <a href="#skill-key-benefits" id="skill-key-benefits"></a>

### ⚡ 複雜任務標準化 <a href="#complex-task-standardization" id="complex-task-standardization"></a>

* **沒有技能**：AI 助理只能根據通用知識回答，品質不穩定
* **有了技能**：每次都按照 SOP 執行，確保回答品質一致

### 🎯 精準觸發與分工 <a href="#precise-trigger-and-routing" id="precise-trigger-and-routing"></a>

* 透過描述中的觸發條件，AI 助理能自動判斷何時使用哪個技能
* 不同技能負責不同任務，實現模組化的能力分工

### 🔄 可重複使用與分享 <a href="#reusable-and-shareable" id="reusable-and-shareable"></a>

* 一個技能可以綁定到多個 AI 助理
* 技能可匯出為 `.skill` 檔案，分享給其他組織使用

### 📦 指令與工具封裝 <a href="#instruction-and-tool-encapsulation" id="instruction-and-tool-encapsulation"></a>

* 將「做什麼」（指令）和「用什麼」（工具）打包在一起
* 不需要在 AI 助理的角色指令中重複撰寫大量流程細節

## 技能與工具的差異 <a href="#skill-vs-tool" id="skill-vs-tool"></a>

| 比較項目     | 工具               | 技能               |
| -------- | ---------------- | ---------------- |
| **本質**   | 單一的外部能力（API、MCP） | 一套完整的執行流程        |
| **包含內容** | API 端點 / MCP 伺服器 | 指令 + 工具 + 資源     |
| **類比**   | 螺絲起子             | 組裝手冊 + 螺絲起子      |
| **觸發方式** | AI 自行判斷是否呼叫      | 根據描述中的觸發條件匹配     |
| **適用場景** | 單一動作（查天氣、發郵件）    | 多步驟流程（退貨處理、休假計算） |

{% hint style="info" %}
技能和工具是互補的關係：技能透過「附加工具」來調用工具的能力，而工具提供了技能所需的實際執行能力。
{% endhint %}

## 具體應用場景 <a href="#use-cases" id="use-cases"></a>

### 🏢 企業客服 <a href="#enterprise-customer-service" id="enterprise-customer-service"></a>

```
技能：退貨處理流程
觸發：當客戶要求退貨、換貨時
步驟：查詢訂單 → 確認退貨資格 → 建立退貨單 → 回覆處理結果
附加工具：訂單查詢 API、退貨系統 API
```

### 🏛️ 政府機關 <a href="#government-agency" id="government-agency"></a>

```
技能：休假天數計算
觸發：當使用者詢問休假天數、特休天數
步驟：確認人員類別 → 檢索法規範例 → 比對計算 → 產出結果
附加工具：知識庫檢索
```

### 🏪 電商平台 <a href="#e-commerce-platform" id="e-commerce-platform"></a>

```
技能：客戶資料收集
觸發：當客戶表達採購意願、索取報價
步驟：引導提供姓名/公司/聯繫方式 → 寫入 CRM
附加工具：Google Sheet API、CRM 工具
```

### 📧 行銷團隊 <a href="#marketing-team" id="marketing-team"></a>

```
技能：郵件發送服務
觸發：當使用者要求寄送郵件、聯繫客戶
步驟：確認收件人 → 撰寫郵件內容 → 發送
附加工具：Gmail MCP 工具
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maiagent.ai/skills/skill-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.