agent 技能是可重複使用的指示套件，可選擇包含指令碼、參考資料和範本，用於引導 AI agent 完成特定任務。在開放的 Agent Skills 格式中，每個套件都是以 SKILL.md 檔案為核心的資料夾。相容的 agent 可探索技能，並在相關時載入其指示，而不必一次將所有程序都保留在對話中。本指南說明此格式、展示實用範例，並帶你建立及測試第一個技能。
什麼是 agent 技能？
Agent Skills 是一種輕量、開放的格式，用於封裝專業知識與工作流程。技能包含一個 SKILL.md 檔案，內有以 YAML frontmatter 描述其名稱與用途的內容，後接 Markdown 指示。輔助檔案可包含指令碼、參考文件與範本。
「AI 技能」一詞可能指涉多種事物，包括人們使用 AI 的能力。本指南中的 agent 技能和 AI agent 技能，特指供相容 agent 使用、可重複使用的 SKILL.md 套件。
例如，會議摘要技能可定義團隊會議紀錄的章節、記錄決策的方式，以及如何標示缺少負責人或截止日期的項目。你只需儲存這些規則一次，之後便可套用於新的會議筆記。技能引導 agent 的工作；它不會重新訓練底層模型。
開放規格要求 frontmatter 中必須包含名稱和說明。名稱須為 1–64 個字元，只能使用小寫字母、數字和連字號，且必須與目錄名稱一致；不得以連字號開頭或結尾，也不得包含連續連字號。說明須為 1–1,024 個字元，並說明任務內容及何時使用此技能。
agent 技能如何運作？
此格式採漸進式揭露設計：agent 在載入完整指示前，會先取得足以選擇技能的資訊。
探索。 agent 會取得可用技能的名稱和說明。這些中繼資料仍會占用 context，但不會預先載入所有完整程序。
啟用。 agent 選擇相關技能後，便會讀取 SKILL.md。部分工具也可讓你依名稱呼叫技能，或停用自動選擇。
執行。 agent 會依循程序，並在需要且獲准時讀取輔助參考資料或執行指令碼。
這可減少未啟用程序占用的 context。實際的 context 用量取決於說明的數量與長度、啟用中的技能，以及載入的任何資源。清楚的說明有助於選擇技能，但仍須測試啟用情況與輸出品質。
agent 技能、提示詞、MCP 與工具的差異
AI 工具領域的術語繁多，而「技能」與幾個看似相似的概念並列。以下說明它們的差異：
| 功能 | 定義 | 啟用時機 | 最適用於 |
|---|---|---|---|
| 提示詞 | 在對話中提供的指示，也可以儲存 | 保留在對話脈絡期間 | 一次性指示 |
| 持續生效的指示（例如 AGENTS.md、QWEN.md） | 專案事實與限制條件 | 依據 agent 的專案範圍與載入規則 | 全專案規則 |
| Agent skill | 含有指示與資源的版本化資料夾 | 相關時視需要載入 | 可重複使用的工作流程與程序 |
| MCP 伺服器／工具 | 提供動作與資料的執行中整合項目 | 完成設定、連線並獲得權限時 | 執行動作、存取即時資料 |
| 子 agent | 具有自身脈絡視窗的獨立工作者 | 生成時 | 隔離或平行工作 |
技能與提示詞。 提示詞是在對話中提供指示；技能則儲存可重複使用的程序和輔助資源，供探索或明確呼叫。提示詞也可以儲存並重複使用。當重複性任務需要可維護的工作流程、範例、參考資料或指令碼時，技能便很有用。
技能與 MCP。 MCP 為 agent 提供能力，也就是連接即時工具和資料的途徑。技能則為 agent 提供知識：如何妥善完成任務、應依何種順序進行，以及採取哪些驗證步驟。兩者相輔相成。程式碼審查技能定義完整審查的標準，而 GitHub MCP 伺服器讓 agent 能讀取實際的提取請求。
技能與專案指示。 AGENTS.md 等檔案會依 agent 的載入與範圍規則提供專案指引。適用範圍廣的慣例應放在這類檔案中，而應在相關時載入的任務專屬程序則使用技能。具體行為取決於工具。
agent 技能的重要性
可重複使用的專業知識： 擷取任務專屬的方法、檢查清單和範本，避免每次都要重新說明。
程序更一致： 為 agent 在重複任務中提供相同的步驟和審查標準。結果仍須驗證。
context 效率： 在需要時載入詳細指示，而非將所有程序都放入永遠載入的指引中。
跨工具重複使用： 可在相容的 agent 間共用核心 SKILL.md 格式，但使用前須確認工具存取權、相依項目及平台專屬欄位。
團隊維護： 將技能資料夾納入版本控制，以便審查共用工作流程的變更。
哪些 AI 工具支援 agent 技能？
愈來愈多 AI 工具支援 agent 技能，包括 Claude Code、OpenAI Codex、Cursor、GitHub Copilot 和 Kimi Code。這些工具使用可重複使用的技能套件，為 agent 提供任務專屬的指示、工作流程和輔助資源。
共用的 SKILL.md 格式讓技能更容易在相容工具間重複使用，但安裝方式和呼叫方法因產品而異。如果技能依賴指令碼或外部工具，請確認計畫使用它的環境中具備這些相依項目。
agent 技能範例與使用情境
實用的技能會擷取使重複任務符合你團隊需求的規則。以下範例說明應封裝哪些內容，以及如何檢查結果：
| Skill | 輸入 | 可重複使用的規則 | 待驗證的輸出 |
|---|---|---|---|
| 會議摘要 | 會議筆記或逐字稿 | 將決策與討論分開；列出任務負責人與截止日期；標示缺少的細節 | 包含摘要、決策與行動項目的會議記錄 |
| 品牌內容審核 | 草稿與品牌指南 | 檢查已核准的術語、語氣、禁止聲明與必要訊息 | 問題清單及建議修訂內容 |
| 程式碼審查 | 提取請求差異 | 檢查錯誤處理、測試、相依性變更及專案慣例 | 區分必要修正與建議事項的報告 |
| 每週報告 | 進度說明與指標 | 使用固定的報告期間與章節；區分已完成的工作、風險與後續步驟 | 保留提供的指標並標示缺漏資料的報告 |
文件處理和定期資料分析也是合適的候選項目，但通常需要 SKILL.md 以外的工具或指令碼。先從範圍明確的工作流程開始，驗證其輸出結果，僅在任務需要時再加入相依項目。
在 Kimi AI 中使用 agent 技能
選擇符合任務需求的環境。上述建立方式涵蓋以自然語言撰寫，以及以本機檔案為基礎的工作流程。
Kimi Code 中的 agent skills
Kimi Code CLI 會在專案目錄 .agents/skills/ 和 .kimi-code/skills/，以及使用者目錄 ~/.agents/skills/ 和 ~/.kimi-code/skills/ 中尋找 skills。Kimi 專用的使用者目錄可透過 KIMI_CODE_HOME 變更。可使用 /skill:<name> 呼叫 skill，或讓模型依據其說明與支援的觸發欄位自行選擇。個別 skill 可停用自動選擇功能。設定路徑或平台專屬欄位時，請查閱最新 CLI 文件。
在 Kimi 中用 agent skills 處理日常工作
不必從頭設定。開啟桌面版或網頁版 Kimi，瀏覽 Skill Store，只要按一下即可安裝 Skill 並在 Kimi 中使用。從研究、寫作到程式設計與資料分析，Kimi Skill Store 提供各式任務適用的 skills。在 Kimi 的桌面版或網頁版應用程式中瀏覽商店，按一下安裝 Skill，即可開始在 Kimi 中使用。
如何建立自己的 agent skill
你可以向 AI 工具描述工作流程來建立 skill，或自行撰寫 SKILL.md。先從一項重複性任務開始，並選擇容易檢查的輸出，例如會議紀錄。
方法 1：使用 Kimi 建立 agent skill
在 Kimi 中開啟 Skills 面板，即可探索或安裝 skills。若要建立自己的 skill，可上傳流程說明，或在建立 skill 的對話中描述需求。你也可以使用 /skill-creator。請參閱 Kimi 的 Skills 指南，了解目前可用的入口。
步驟 1：開啟 Kimi 的 Skills 商店，依序點選「customize」>「Create with Kimi」。
步驟 2：描述你需要的 skill。
向 Kimi 說明任務、預期輸入、輸出結構，以及資訊缺漏時的處理規則。
例如：
如果結果遺漏某項規則，請要求 Kimi 修訂該規則後再次測試。若使用現有的 SOP，請明確指出哪些部分是指示、哪些是背景資料；在封裝前移除無關或敏感內容。skill 建立完成後，即可立即在 Kimi 中使用。
方法 2：自行撰寫 agent skills
此範例僅使用文字指示，不需要額外的指令碼。範例以 Kimi Code CLI 示範安裝與呼叫方式；其他 agent 可能使用不同的路徑與指令。
步驟 1：建立資料夾。 若要為 Kimi Code CLI 建立使用者層級的 skill，請建立 ~/.agents/skills/meeting-summary/。若要建立可供團隊共用的儲存庫層級 skill，則改在儲存庫根目錄下使用 .agents/skills/meeting-summary/。
步驟 2：儲存 SKILL.md。 建立 ~/.agents/skills/meeting-summary/SKILL.md，並貼上以下內容。description 用於識別任務；本文則定義輸出與資訊缺漏的處理規則。
步驟 3：開始新工作階段並呼叫它。 儲存檔案後，開啟新的 Kimi Code CLI 工作階段。在聊天輸入框中輸入此指令：
步驟 4：檢查結果。 以下為示意性的預期輸出，並非實際產品執行紀錄。措辭可能有所不同，但章節、決議、負責人與期限應遵循此 skill。
步驟 5：測試自動選擇與適用界限。 在新的對話中，不使用斜線指令，直接要求「將這些會議筆記整理成會議紀錄」，並提供相同筆記。檢查 agent 是否透過介面的活動紀錄載入 skill（如有提供此功能），以及輸出是否符合其規則。接著嘗試不相關的要求，例如「解釋 Python 中的遞迴」；meeting-summary skill 應維持未啟用。此外，也可在未提供筆記時呼叫它：它應要求提供輸入內容。
如果 agent skill 無法運作，該怎麼辦？
| 症狀 | 檢查項目 |
|---|---|
| 找不到該技能 | 檢查掃描目錄、SKILL.md 檔名是否完全正確、YAML 前置資料是否有效，以及資料夾與名稱是否相符。新增後請開啟新的工作階段。 |
| 手動呼叫可正常運作，但不會自動選取 | 請讓描述更明確對應預定任務。檢查是否停用了自動呼叫；在新的對話中重試。 |
| 技能會因不相關的請求而啟用 | 縮小描述範圍，並以不相關的請求作為反例測試。 |
| 輸出遺漏了一項規則 | 明確寫出規則、加入輸入／輸出範例，並以資訊缺漏的情況重新測試。 |
| 指令碼或整合失敗 | 檢查所需套件、權限、網路存取權及已設定的工具。技能不會自動安裝所有相依項目。 |
如需使用指令碼、冗長參考資料或範本，可視需要加入 scripts/、references/ 或 assets/，並從 SKILL.md 連結至這些內容。請參閱 Kimi Code CLI Skills 文件，了解目前的路徑與呼叫選項。
使用與建立 agent skills 的最佳做法
定義清楚的觸發條件： 說明任務內容，以及何時應使用此 skill。納入使用者自然會使用的詞彙，並測試相關與不相關的要求。
讓指示保持聚焦： 規格建議主檔案少於 500 行、少於 5,000 個 token。這是兩項獨立的指引，並非行數與 token 數的換算關係。請將詳細參考資料移至輔助檔案。
指定可觀察的輸出： 納入必要章節、輸入與輸出範例，以及資訊缺漏時的處理規則。
記錄相依項目： 標示所需工具與套件，並在適當情況下使用相容性中繼資料。將平台專屬擴充功能與可攜式核心分開。
控管具重大影響的操作： 對於傳送訊息或部署變更的工作流程，應使用明確呼叫方式與適當的核准規則。僅靠手動呼叫無法取代權限檢查。
檢閱第三方套件： 安裝前檢查指示與隨附指令碼，包括它們使用哪些資料與權限。
結論
agent skills 可將重複性任務轉化為可重複使用的工作流程，讓相容的 AI agent 在需要時載入。先從一份聚焦的 SKILL.md 開始，定義何時使用此 skill，以及它應產出什麼內容。僅在任務需要時加入指令碼或參考資料，接著測試 skill 的啟用時機與輸出品質。