4-1 什麼是 Skills？

什么是 Skill？

一句话：Skill 是一份写给 AI 的"操作手册"，教它如何处理某一类特定任务。

你可以把它想象成"经验笔记"——你把自己的工作标准、流程和偏好写进一个 Markdown 文件，AI 在遇到相关任务时就会自动翻阅这份笔记，按照你的要求来执行。

举个例子：你每次让 AI 帮你写 PR 描述，都要反复强调"要包含改动摘要、测试方法、影响范围"。有了 Skill，你只需要把这些要求写一次，AI 以后每次写 PR 描述时就会自动遵循。

重要概念：Skill 不是可执行的程序或插件，它是 Markdown 格式的指令文件。AI 读取这些指令后，用自己的能力去执行任务——就像你给新同事一份工作指南，他按照指南干活一样。

Skill 的核心文件：SKILL.md

每个 Skill 就是一个文件夹，里面有一个名为 SKILL.md 的文件。这个文件有两部分：

1. Frontmatter（元数据）：告诉 AI 这个 Skill 叫什么、什么时候该用

2. 正文（指令内容）：具体的操作步骤和规范

---
name: pr-description
description: 撰写 Pull Request 描述。当用户创建 PR、撰写 PR 描述、提交代码变更说明时使用。
---

## PR 描述规范

每份 PR 描述必须包含以下部分：

1. 改动摘要：用 2-3 句话说明这次改了什么、为什么改
2. 改动：列出主要的代码变更
3. 测试方法**：说明如何验证这些改动
4. 影响范围：标注这次改动可能影响的模块

其中 frontmatter（--- 之間的部分）支援以下欄位：

關鍵提醒：description 是最關鍵的欄位。AI 透過語義匹配把你的請求和 Skill 的 description 做對比，來決定是否啟用這個 Skill。如果你發現某個 Skill 總是不觸發，通常是 description 寫得不夠明確。

Skill 存放在哪裡？

Skill 可以放在兩個地方，取決於誰需要用它：

1. 個人 Skill

放在你的 home 目錄下，跟著你走，所有專案都能用：

# macOS / Linux
~/.claude/skills/你的skill名称/SKILL.md

# Windows
C:\Users\你的用户名\.claude\skills\你的skill名称\SKILL.md

適合場景：你個人的 commit 風格、你喜歡的程式碼注釋規範、你的 PR 描述模板——這些跟具體專案無關，走到哪用到哪。

2. 專案 Skill

放在專案儲存庫根目錄的 .claude/skills 裡，透過 Git 和團隊共享：

你的项目/.claude/skills/你的skill名称/SKILL.md

適合場景：團隊的程式碼審查標準、專案的文件模板、特定框架的除錯流程——這些是整個團隊需要統一遵守的規範。專案 Skill 會隨著程式碼庫一起提交到 Git，團隊成員 clone 儲存庫後自動獲得。

Skill 是怎麼被啟用的？

這是很多新手容易困惑的地方，讓我一步步說清楚：

• 啟動時掃描

  ：AI 啟動時會掃描所有 Skill 目錄，但

  只載入每個 Skill 的名稱和描述

  ，不會讀取完整內容——這樣不會浪費上下文視窗。

• 語義匹配

  ：當你傳送一個請求，AI 會把你的話和所有 Skill 的 description 做語義對比。比如你說「幫我寫一下這個 PR 的描述」，AI 發現這和

  pr-description

  這個 Skill 的描述匹配度最高。

• 確認提示

  ：匹配到之後，AI 會先問你：「要載入 pr-description 這個 Skill 嗎？」——你確認後，它才會讀取完整的 SKILL.md 內容。

• 按需載入

  ：確認後，完整的 Skill 指令才會加入到當前對話中，AI 按照指令來執行任務。

> 關鍵點：Skill 是「按需載入」的——只有當你的請求和 Skill 匹配時才會被呼叫，不會像背景設定一樣始終存在於每次對話中。這種設計既節省上下文空間，又能在需要時提供專業指導。

Skill 適合用在哪些場景？

Skill 最適合那些你反覆向 AI 解釋的東西：

• 程式碼審查標準

  ：團隊的 Code Review 清單

• Commit message 格式

  ：你偏好的提交訊息風格

• 文件模板

  ：特定類型文件的結構規範

• 除錯流程

  ：某個框架的常見問題排查清單

• 品牌指南

  ：組織的 UI／文案規範

> 黃金法則：如果你發現自己在反覆向 AI 解釋同一件事，那就是一個 Skill 等著你去寫。

下一步

現在你知道了 Skill 是什麼、怎麼存放、怎麼被啟用。下一課，我們將動手從零建立一個 Skill，並學習如何測試、優化和分享給團隊。

> 免責聲明

> 本文僅供參考。文中觀點僅代表作者個人，不代表 OKX 立場。本文無意提供：(i) 投資建議或投資推薦；(ii) 購買、出售或持有數位資產的要約或招攬；或 (iii) 財務、會計、法律或稅務建議。我們不保證文中資訊的準確性、完整性或實用性。

>

> 數位資產（包括穩定幣和 NFT）風險較高，價格可能大幅波動。歷史收益不代表未來表現，過往表現亦不構成對未來結果的保證。請您根據自身財務狀況，謹慎判斷交易或持有數位資產是否適合您，並在需要時諮詢法律、稅務或投資專業人士。

>

> 並非所有產品和服務均在所有地區提供，且部分產品和服務在某些地區可能受到限制或不可用。您有責任瞭解並遵守當地適用的法律法規。© 2026 OKX。保留所有權利。