> ## Documentation Index
> Fetch the complete documentation index at: https://docs.miraday.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能

> 把你反覆使用的工作流程儲存成可重複套用的技能，在頻道輸入框輸入 / 即可叫出。內建的招募技能來自 Mira 團隊；你自己的技能可以自由建立、編輯與分享。

找到對的人是一次勝利。把你達成這件事的方法保留下來，它就能一再複製，這就是技能。把你反覆使用的工作流程儲存下來（一種職缺需求的格式、一套評估準則、一種報告架構），然後在任何頻道裡重複套用，不必每次都從頭描述同樣的需求。

***

## 什麼是技能

技能是一組儲存好的指令，告訴 Mira 如何處理某類重複出現的工作：你的需求釐清問題、一套評估準則、一種交付給客戶的報告格式，甚至要執行哪些工具、按什麼順序。Mira 會把這類工作從頭到尾跑完，而不是當成一次性的提問。技能分兩類：

* **官方技能**：由 Mira 團隊打造並維護，列在 **官方** 分頁。詳見下方說明。
* **個人技能**：由你建立，只有你自己的帳號看得到。

把技能匯出並分享檔案，整個團隊就能用同一套方式工作。

## 官方技能

官方技能會出現在 **官方** 分頁。叫出官方技能的方式和其他技能一樣；當你的請求與某個官方技能相符時，Mira 也會自動套用（見[叫出技能](#叫出技能)）。

### skill-creator

你會一再用到的那個官方技能就是 **skill-creator**：它透過對話幫你建立和編輯自己的技能，完全不用寫任何檔案。

* \*\*它能做什麼：\*\*用白話描述一個工作流程，skill-creator 就會把它變成一個技能，替你草擬指令。
* \*\*怎麼使用：\*\*在技能設定裡點擊 **新建技能**，再點 **對話創建**（Mira 會開啟一個執行 skill-creator 的頻道），或在任何頻道裡輸入 **/skill-creator**。完整流程見[建立技能](#建立技能)。之後若要修改你的任一技能，開啟它並點擊 **編輯** 即可。
* \*\*什麼時候用：\*\*當你有一套可重複的流程（一份需求釐清清單、一套評估準則，或一種交付給客戶的報告格式），想把它存成可重複套用的技能，又不想手動編輯 `SKILL.md` 時。

## 叫出技能

1. 點擊頻道輸入框工具列上的 **技能** 按鈕，或輸入 **/**，會跳出技能選單，列出你可用的技能；點 **查看全部技能** 可前往你的技能設定。
2. 選擇一個技能，或繼續輸入以名稱篩選。
3. 描述這次執行的具體需求後送出。技能名稱會以標籤形式出現在你的訊息裡，Mira 會依照該技能的指令來處理這個頻道。

![在頻道輸入框輸入斜線後開啟的技能選單，列出可選用的技能](https://mintcdn.com/forward-ai-labs/If_K_8Hs5y-s1pix/docs/skills-picker.png?fit=max\&auto=format\&n=If_K_8Hs5y-s1pix\&q=85\&s=65d96a4a2ba110d388e9450aeff6d208)

Mira 也能自動套用相關技能：每個技能都帶有一段簡短描述，當你的請求與描述相符時，Mira 會自行套用該技能。

## 建立技能

開啟你的技能設定（先進 **設定**，再點 **技能**），點擊 **新建技能**。有兩種方式：

![技能設定裡的「新建技能」選單，提供「對話創建」和「匯入檔案」兩種方式](https://mintcdn.com/forward-ai-labs/If_K_8Hs5y-s1pix/docs/create-skill.png?fit=max\&auto=format\&n=If_K_8Hs5y-s1pix\&q=85\&s=b91d1b31d46b013f03ae5cc55aeb9a52)

**對話創建。** Mira 會用官方的 **skill-creator** 技能開啟一個新頻道，透過對話把你描述的工作流程整理成技能。草稿完成後，Mira 會在對話中以卡片形式交付；預覽後點擊 **添加到我的技能** 即可儲存。

**匯入檔案。** 拖入 `.md`、`.skill` 或 `.zip` 檔案（最大 10 MB）。若只上傳單一 `.md` 檔案，檔名必須是 `SKILL.md`。Mira 會解析 `SKILL.md` 的 frontmatter，直接加入該技能，並開啟它的詳細頁面，顯示名稱、觸發方式、來源與檔案。一個技能套件包含：

* `SKILL.md`，必要：frontmatter 裡是技能 ID（slug）和一段簡短描述（最多 1024 個字元；Mira 會用它判斷何時自動套用該技能），後面接著 markdown 格式的指令（最大 100 KB）。
* 選用的 `scripts/`、`references/` 和 `assets/` 資料夾，用來存放輔助檔案。

如果名稱和官方技能重複，請在 `SKILL.md` 的 frontmatter 裡改名後重新上傳。如果和你自己的某個技能重複，Mira 會詢問是否取代；點擊 **替換並保存** 即可覆寫。

## 技能詳細頁面

在技能設定裡開啟任一技能，就能看到它的詳細頁面：描述、來源、觸發方式（例如 **支援自動比對**），以及啟用開關。你的個人技能還會顯示建立或最後編輯時間、建立方式（上傳或對話）、版本，以及技能的檔案清單（點擊任一列可唯讀預覽）。針對你的個人技能，你還可以：

* **編輯**：把修改交給 **skill-creator**。設定視窗會關閉，Mira 會在建立該技能的頻道中接續處理；如果那個頻道已不存在，或該技能是從檔案匯入的，則會開啟一個新頻道，並替你完成修改。
* **導出 .skill 文件**（在 ⋯ 選單中）：把技能下載為 `.skill` 檔案。
* **刪除**（在 ⋯ 選單中）：永久移除該技能。這會一併移除 `SKILL.md` 以及 `scripts/`、`references/`、`assets/` 底下的所有內容，且無法復原。

## 管理你的技能

技能設定用 **全部**、**官方** 和 **我的** 三個分頁列出所有技能。

![技能設定頁面，列出官方技能和個人技能，每個都有啟用開關](https://mintcdn.com/forward-ai-labs/If_K_8Hs5y-s1pix/docs/skills-settings.png?fit=max\&auto=format\&n=If_K_8Hs5y-s1pix\&q=85\&s=44245f0bfb5877d21563dabbe30df45c)

用開關**啟用或停用**任一技能；停用的技能不會被使用。編輯、匯出和刪除，都在該技能的詳細頁面進行。

## 常見問題

### 有哪些官方技能？

**官方** 分頁列出 Mira 團隊提供、且已為你的帳號啟用的技能，其中包括 **skill-creator**，能透過對話協助你建立和編輯自己的技能。Mira 團隊發布新的官方技能後，會陸續出現在這裡。

### 可以把技能分享給同事嗎？

目前還沒有內建的分享功能。把技能匯出成 `.skill` 檔案，任何人都可以在自己的技能設定裡透過 **新建技能** 和 **匯入檔案** 匯入。一個人的技能，就是這樣傳承下去、讓整個團隊都能使用。

## 下一步

* [MiraDay 如何搜尋](https://docs.miraday.ai/zh-TW/docs/sourcing/agentic-search.md)：技能所嵌入的搜尋流程。
* [語音與音訊輸入](https://docs.miraday.ai/zh-TW/docs/sourcing/voice-input.md)：另一種快速描述需求的方式。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.