您可以運用技能，透過專業知識和自訂工作流程，提升 Agent 模式的功能。這些技能是以代理程式技能開放標準為基礎。
與 AGENTS.md 檔案不同，技能代表隨選專業知識。這種結構可讓 Agent Mode 維持大量專業功能，例如在特定程式庫版本之間遷移，或讓可組合函式配合不同螢幕大小調整，而不會讓模型的脈絡窗口雜亂無章。
模型會根據您的要求和技能說明，自主決定何時要使用技能。系統辨識出相關技能後，模型會動態提取完成工作所需的完整操作說明和資源。
如要隨選啟用技能，請要求智慧助理執行與該技能相關的工作。你也可以在輸入框中輸入 @，觸發特定技能。
主要優點
- 分享專業知識：將複雜的工作流程 (例如特定團隊的提取要求審查程序) 封裝到專用資料夾中，供所有人使用。
- 可重複執行的工作流程：提供標準指示，確保複雜的多步驟工作都能一致執行。
- 資源組合：在指令中加入指令碼、範本或範例資料，讓代理程式集中取得所有必要資訊。
- 有效率地使用脈絡窗口：為節省脈絡權杖，系統一開始只會載入技能的中繼資料 (名稱和說明)。只有在啟用時，系統才會載入完整的
SKILL.md檔案。只有在代理程式特別需要時，references/、scripts/或assets/目錄中的支援檔案才會載入脈絡。
建立自己的技能
服務專員會從專案根目錄中的 .skills/ 或 .agent/skills/ 目錄開始尋找技能。如要建構自訂技能，請按照下列步驟操作：
- 建立技能目錄 (例如
my-new-skill/)。 - 在新的目錄中建立
SKILL.md檔案 (區分大小寫)。
技能必須遵守下列規則：
- 每個技能一個目錄：每個技能都必須有自己的專屬目錄，其中包含
SKILL.md檔案和任何其他資源。 - 巢狀結構：所有技能都必須位於專案根目錄的
.skills/或.agent/skills/目錄中。不過，您可以使用子目錄來提升整理效果 (例如skills/ui-flows/<skill name>/SKILL.md或skills/testing/<skill name>/SKILL.md)。 - 範圍：目前僅支援專案程式碼集中的技能。
SKILL.md 檔案會使用 YAML 區塊做為中繼資料，並使用標準 Markdown 做為指令。
name：技能的專屬 ID。這應與目錄名稱相符。description：清楚說明技能的用途，以及代理程式應使用技能的時機。- 內文：YAML 區塊下方的 Markdown 內文包含指令，可引導代理程式在技能啟用時的行為。
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
格式規範
- 名稱：最多 64 個字元 (只能使用小寫英文字母、數字和連字號)。
- 說明：最多 1,024 個字元。
- 內文內容：建議 10,000 到 20,000 個字元 (約 2,500 到 5,000 個權杖)。如果說明超出此限制，請考慮將詳細說明移至資源檔案，如「選用技能目錄」一文所述。
選用技能目錄
如要讓 SKILL.md 檔案簡潔且模組化，您可以在技能資料夾內的下列選用目錄中加入其他資源：
scripts/：包含代理程式可執行的程式碼 (例如 Python 或 Bash)。references/：包含詳細技術文件、API 參考資料或特定領域指南。assets/：包含靜態資源，例如文件範本、UI 圖表或 JSON 結構定義。
在 SKILL.md 指令中參照這些檔案時，請使用技能根目錄的相對路徑。例如：Run the script at scripts/cleanup.py。