代理技能是可重複使用的指令集,教導 Copilot 代理執行特定任務,例如執行建置管線、產生樣板,或遵循團隊的程式碼標準。 只要定義一次技能,就能節省時間,並確保整個工作流程的一致性。
技能與 客製化代理人 及 客製化指示相輔相成。 客製化代理定義角色與工具組,自訂指令設定一般編碼偏好,技能則提供針對特定任務的指引,任何代理都能自動發現並運用。
Prerequisites
特務技能的運作方式
當你使用 agent mode 時,Copilot 會自動從你的資料庫和使用者資料中發現技能。 代理人會判斷某項技能何時與你的請求相關並啟動。 當技能啟動時,聊天室會顯示該技能正在生效。
使用內建的 .NET 和 Azure 技能
Visual Studio 內建了由 .NET 與 Azure 團隊專家打造的技能。 這些技能會在你安裝對應的 .NET 和 Azure 工作負載時取得。
內建技能預設是關閉的。 要檢視和管理工具,請在 Copilot Chat 中選擇工具圖示以開啟工具選擇器,然後展開內建功能。 將滑鼠移到技能上可顯示其描述和檔案路徑。 要檢查完整技能或其資料夾,請使用 ...... 選單。 只啟用與你任務相關的技能。
欲了解更多可用技能資訊,請參閱 .NET 技能與 Azure 技能庫。
技能位置
Visual Studio 從以下地點發掘自訂技能:
| 技能類型 | 地點 |
|---|---|
| 工作空間或專案技能(儲存在你的儲存庫中) |
.github/skills/、.claude/skills/、.agents/skills/ |
| 個人技能(儲存在你的使用者檔案中) |
~/.copilot/skills/、~/.claude/skills/、~/.agents/skills/ |
Workspace 技能會透過源碼控制與團隊分享。 個人技能應用於所有專案,且不需依賴任何資料庫。
建立技能
你可以從 Visual Studio 的技能面板建立技能,或是在你的檔案系統手動建立。 要從技能面板建立技能,必須擁有 Visual Studio 2026 Insiders 版本 18.6 或更新版本。
從技能面板創建一項技能(Insiders)
選擇Copilot Chat右下角的Tools圖示以開啟技能面板。
選取面板右上角的 + 按鈕。
選擇一個範圍(工作區 或 個人),並輸入你的技能名稱和描述。
Visual Studio 會按照
SKILL.md將 寫入選定的位置,並產生範本供你填寫。 你可以使用 Copilot Agent 模式來協助完成範本。
手動建立技能
每個技能都是一個目錄,內含 SKILL.md 符合 agentskills.io 規範的檔案。
建立技能目錄。 對於工作區技能,請在儲存庫的根目錄使用
.github/skills/。 個人技能方面,請使用~/.copilot/skills/。為你的技能建立一個子目錄。 每個技能都應該有自己的目錄(例如)。
.github/skills/github-issues/在技能目錄裡建立一個
SKILL.md檔案。 該檔案包含 YAML 前置內容,包含元資料,後接 Markdown 指令。可選擇性地,將腳本、範例或其他資源加入你的技能目錄。
技能目錄結構
your-repo/
└── .github/
└── skills/
└── github-issues/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
SKILL.md 格式
SKILL.md檔案必須先有 YAML 前言,然後是 Markdown 內容:
---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---
When creating GitHub issues:
- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs
前置物性質
| Property | Required | Description |
|---|---|---|
name |
Yes | 只限小寫字母、數字和連字號。 必須與父目錄名稱相符。 最多64字元。 |
description |
Yes | 描述該技能的作用以及何時使用。 最多1,024字元。 |
license |
No | 授權名稱或綁定授權檔案的引用。 |
compatibility |
No | 環境需求,例如預期產品或所需系統套件。 |
metadata |
No | 額外元資料的任意鍵值映射。 |
allowed-tools |
No | 一串預先核准的空格工具,技能者可以使用。 |
撰寫有效技能的技巧
- 保持主
SKILL.md線在500條線以下。 將詳細的參考資料移到目錄中的references/獨立檔案。 - 撰寫包含特定關鍵字的說明
description文件,幫助客服人員辨識該技能何時相關。 - 包含逐步說明、範例及常見的邊緣案例。
從技能面板管理技能
選擇Copilot Chat右下角的Tools圖示,開啟技能面板,專門查看每個已發現的技能。 技能面板僅在 Visual Studio 2026 Insiders 中提供。
從面板中,你可以:
-
編輯:直接在編輯器的
SKILL.md選單中開啟任何技能。 - 開啟檔案位置:跳到磁碟上的技能目錄。
- 搜尋:依名稱或關鍵字篩選技能。
面板還會顯示技能設定錯誤的診斷,讓你能快速發現並修正問題。
社區技能
可以參考社群分享的 awesome-copilot 範例技能庫 。