# Skills

Source: https://docs.mira.day/zh-TW/docs/agent-sourcing/skills

> 把常用的工作流程儲存成可重複使用的 Skill，在 Task 輸入框輸入 / 即可叫出。



Skills 讓你把反覆使用的工作流程儲存下來——例如尋訪需求的 brief 格式、評估準則、報告架構——之後在任何 Task 直接套用，不必每次都從頭描述同樣的需求。

***

什麼是 Skill [#什麼是-skill]

Skill 是一組儲存好的指令，告訴 Mira 該怎麼處理某類重複出現的工作。Skill 屬於你的個人帳號，分成兩種：

* **官方 Skill**：由 Mira 團隊打造並維護。第一個官方 Skill 是 **skill-creator**，它能透過對話協助你建立和編輯自己的 Skill。
* **個人 Skill**：由你自己建立，只有你的帳號看得到。

叫出 Skill [#叫出-skill]

1. 在 Task 輸入框輸入 **/**，會出現 Skill 選單，列出你可用的 Skill。
2. 選一個 Skill，或繼續輸入文字以名稱篩選。
3. 描述這次執行的具體需求後送出。Skill 名稱會以標籤形式出現在你的訊息中，Mira 會依照該 Skill 的指令執行這個 Task。

{/* TODO: screenshot — Task input with "/" skill picker open */}

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

建立 Skill [#建立-skill]

前往 **Settings → Skills**，點擊 **New Skill**。有兩種方式：

Create via Chat [#create-via-chat]

選擇 **Create via Chat**。Mira 會開啟一個新 Task 並載入官方的 **skill-creator** Skill，透過對話把你描述的工作流程整理成一個儲存好的 Skill。

Import File [#import-file]

選擇 **Import File**，拖入 `SKILL.md`、`.skill` 或 `.zip` 檔案（最大 10 MB）。一個 Skill 套件包含：

* `SKILL.md`——必要。Frontmatter 內含 Skill ID（slug）和一段不超過 80 個字元的簡短描述——Mira 會根據它判斷何時自動套用這個 Skill——後面接著 markdown 格式的指令內容（最大 100 KB）。
* 選用的 `scripts/`、`references/`、`assets/` 資料夾，用來存放輔助檔案。

如果名稱與你既有的 Skill 或官方 Skill 重複，請在 `SKILL.md` 的 frontmatter 改名後重新上傳。

編輯 Skill [#編輯-skill]

* **在 Settings 中編輯**：在 **Settings → Skills** 開啟該 Skill，點擊 **Edit** 直接修改描述或指令。
* **透過對話編輯**：在 Skill 的詳細頁面，把編輯交給 **skill-creator**——Mira 會在 Task 中接續處理，替你套用修改。

管理你的 Skills [#管理你的-skills]

**Settings → Skills** 以 **Official** 和 **Personal** 兩個分頁列出所有 Skill。

{/* TODO: screenshot — Settings → Skills list page */}

針對每個 Skill 你可以：

* 用開關**啟用或停用**。停用的 Skill 不會被使用。
* **匯出**成 `.skill` 檔案。
* **永久刪除**。刪除會一併移除 `SKILL.md` 以及 `scripts/`、`references/`、`assets/` 底下的所有內容，且無法復原。

FAQ [#faq]

目前有哪些官方 Skill？ [#目前有哪些官方-skill]

目前是 **skill-creator**，用來透過對話建立和編輯個人 Skill。Mira 團隊發佈新的官方 Skill 時，會陸續出現在 **Official** 分頁。

Skill 裡面有什麼？ [#skill-裡面有什麼]

一個 `SKILL.md` 檔案，內含 Skill 的 ID、描述和 markdown 指令，外加選用的 `scripts/`、`references/`、`assets/` 資料夾存放輔助檔案。

可以和同事分享 Skill 嗎？ [#可以和同事分享-skill-嗎]

目前還沒有內建的分享功能。你可以把 Skill 匯出成 `.skill` 檔案，任何人都能從 **Settings → Skills → New Skill → Import File** 匯入。

相關頁面 [#相關頁面]

* [建立任務](/zh-TW/docs/agent-sourcing/create-a-task)：Skills 所銜接的基本 Task 流程。
* [語音輸入](/zh-TW/docs/agent-sourcing/voice-input)：另一種加快描述需求的方式。