# 技能管理

{% hint style="info" %}
如果您還不了解技能是什麼，請先閱讀：[技能功能概覽](https://docs.maiagent.ai/skills/skill-overview)
{% endhint %}

## 建立技能 <a href="#create-skill" id="create-skill"></a>

在左側選單中點選 <mark style="color:blue;">技能</mark>，進入技能管理頁面，點擊右上角 <mark style="color:blue;">新增技能</mark> 按鈕。

系統提供兩種建立方式：

### 方式一：手動建立 <a href="#method-manual-create" id="method-manual-create"></a>

適合從零開始撰寫技能指令的情境。

1. 在新增技能彈窗中，點擊下方的 <mark style="color:blue;">改用手動建立</mark> 連結，切換至手動模式
2. 填寫 <mark style="color:blue;">基本設定</mark> 頁籤：
   * **技能名稱**（必填）：為技能取一個易於辨識的名稱
   * **描述**（必填）：簡要說明技能的用途

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9ff82808eea81566942660166fb773f62bd50eac%2Fskills-new-manual.png?alt=media" alt=""><figcaption><p>手動建立技能 — 基本設定頁籤</p></figcaption></figure>

3. 切換至 <mark style="color:blue;">指令內容</mark> 頁籤，撰寫 Markdown 格式的指令內容。您也可以點擊 <mark style="color:blue;">套用範本</mark> 按鈕，使用系統提供的預設範本作為起點

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-208ccb129564da27338d716f0cabf4497a34af3f%2Fskills-new-instructions.png?alt=media" alt=""><figcaption><p>指令內容頁籤 — 支援 Markdown 格式與套用模板</p></figcaption></figure>

4. （選填）切換至 <mark style="color:blue;">附加工具</mark> 頁籤，為技能選擇所需的工具
5. 點擊 <mark style="color:blue;">儲存</mark> 完成建立

### 方式二：上傳技能包 <a href="#method-upload-skill-package" id="method-upload-skill-package"></a>

適合匯入已封裝好的 `.skill` 或 `.zip` 檔案。

1. 在新增技能彈窗中（預設為上傳模式），將 `.skill` 或 `.zip` 檔案拖曳至上傳區域，或點擊區域選擇檔案

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-8b0eb5b5dc222b68ce354bbcc6c48e59e1a4128a%2Fskills-new-upload.png?alt=media" alt=""><figcaption><p>上傳技能包 — 支援 .skill 或 .zip 格式</p></figcaption></figure>

2. 上傳完成後，系統會自動解析檔案中的 `SKILL.md`，提取技能名稱、描述與指令內容
3. 建立成功後會自動跳轉至編輯頁面，您可以進一步調整設定

{% hint style="info" %}
技能包內必須包含 `SKILL.md` 檔案，格式如下：

```markdown
---
name: 技能名稱
description: 技能描述
---

這裡是 AI 助理的執行指令...
```

{% endhint %}

***

## 編輯與設定技能 <a href="#edit-and-configure-skill" id="edit-and-configure-skill"></a>

在技能列表中，點擊該技能的 <mark style="color:blue;">編輯</mark> 圖示，進入技能設定頁面。

### 基本設定 <a href="#basic-settings" id="basic-settings"></a>

編輯技能的名稱與描述。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-fd93e13a22c9e6902e8739d1c5f2ee3ec68e9cf9%2Fskills-edit-basic.png?alt=media" alt=""><figcaption><p>編輯技能 — 基本設定</p></figcaption></figure>

### 指令內容 <a href="#instruction-content" id="instruction-content"></a>

編輯 Markdown 格式的技能指令。這些指令會在 AI 助理展開技能時作為執行依據。

點擊 <mark style="color:blue;">套用範本</mark> 可載入預設的指令範本。

{% hint style="warning" %}
套用範本會覆蓋目前的指令內容，請確認後再執行。
{% endhint %}

### 技能包（僅限上傳方式建立的技能） <a href="#skill-package" id="skill-package"></a>

若技能是透過上傳 `.skill` / `.zip` 建立的，此頁籤會顯示：

* **技能包資訊**：檔案名稱、大小、上傳時間
* <mark style="color:blue;">預覽</mark>：展開檢視技能包內的檔案結構
* <mark style="color:blue;">下載</mark>：匯出技能包檔案
* <mark style="color:blue;">重新上傳技能包</mark>：上傳新版本替換現有的技能包

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-20d9126b4fd95e0e54cef8732fb7ae1e096cef78%2Fskills-edit-instructions.png?alt=media" alt=""><figcaption><p>編輯技能 — 指令內容（含實際範例）</p></figcaption></figure>

### 附加工具 <a href="#additional-tools" id="additional-tools"></a>

為技能綁定所需的工具，讓 AI 助理在執行技能時可以調用。

1. 點擊 <mark style="color:blue;">選擇工具</mark> 按鈕，開啟工具選擇彈窗
2. 勾選要附加的工具（支援多選），點擊確認
3. 已選擇的工具會顯示在列表中，包含工具名稱、類型（API / MCP）與描述
4. 如需移除工具，點擊該工具卡片上的刪除圖示

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-34a440536c9d86df0a1633c9d813091f3b997a2e%2Fskills-edit-tools.png?alt=media" alt=""><figcaption><p>附加工具頁籤</p></figcaption></figure>

設定完成後，點擊頁面右下角的 <mark style="color:blue;">儲存</mark> 按鈕。

***

## 匯出技能 <a href="#export-skill" id="export-skill"></a>

在技能編輯頁面的 <mark style="color:blue;">技能包</mark> 頁籤中，點擊 <mark style="color:blue;">下載</mark> 按鈕即可將技能匯出為 `.skill` 檔案。

{% hint style="info" %}
手動建立的技能也可以匯出，系統會自動將指令內容與資源打包為 `.skill` 檔案。匯出的技能包可分享給其他組織匯入使用。
{% endhint %}

***

## 將技能綁定至 AI 助理 <a href="#bind-skill-to-ai-agent" id="bind-skill-to-ai-agent"></a>

建立好的技能需要綁定至 AI 助理才能生效：

1. 前往 <mark style="color:blue;">AI 助理</mark> 頁面，選擇目標 AI 助理並進入設置
2. 在模型設置區域找到 <mark style="color:blue;">技能</mark> 設定
3. 選擇要綁定的技能，點擊確認
4. 儲存 AI 助理設定

綁定後，AI 助理在對話中會根據使用者的問題自動判斷是否需要展開技能，並依照技能指令執行對應任務。

***

## 刪除技能 <a href="#delete-skill" id="delete-skill"></a>

在技能列表中，點擊該技能的 <mark style="color:blue;">刪除</mark> 圖示，確認後即可刪除。

{% hint style="warning" %}
刪除技能後，已綁定此技能的 AI 助理將無法再使用該技能。此操作不可復原。
{% endhint %}


---

# 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/skills-management.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.