# 技能
URL: /zh-TW/docs/customize/skills

使用者、.spirit 和 .agents 技能，以及內建的 create-rule、create-skill 和 create-hook。



技能是包含 `SKILL.md` 的資料夾。Spirit 從三個位置發現技能：

| 範圍         | 路徑                                           |
| ---------- | -------------------------------------------- |
| 使用者        | `{spiritDataDir}/skills/{name}/SKILL.md`     |
| 工作區 Spirit | `{workspace}/.spirit/skills/{name}/SKILL.md` |
| 工作區 agents | `{workspace}/.agents/skills/{name}/SKILL.md` |

當您在對話中提到技能時，Spirit 可以將該技能的完整文字附加到該使用者訊息中。它不會將每個技能都傾倒到系統提示中。

## Frontmatter [#frontmatter]

`SKILL.md` 必須以 Frontmatter 開頭。缺少 `name` 或 `description` 的檔案不會被發現。

| 欄位            | 說明                                         |
| ------------- | ------------------------------------------ |
| `name`        | 必填。技能名稱；必須與資料夾名稱相符。僅限 1–64 個字元、小寫字母、數字和連字號 |
| `description` | 必填。簡短說明                                    |

## 內建技能 [#內建技能]

以下技能隨 Spirit 提供（它們不是您資料目錄中的檔案）：

* `create-rule` — 起草 [規則](./rules.mdx)
* `create-skill` — 起草 [技能](./skills.mdx)
* `create-hook` — 起草 [hook](./hooks.mdx)

在**設定 → 技能**中管理技能。Git commit / push / merge 標籤是主機介面的功能，不是隨附的技能。請參閱 [Desktop](../desktop.mdx)。