使用 GitHub Copilot 的代理技能

代理技能是可重複使用的指令集,教導 Copilot 代理執行特定任務,例如執行建置管線、產生樣板,或遵循團隊的程式碼標準。 只要定義一次技能,就能節省時間,並確保整個工作流程的一致性。

技能與 客製化代理人 及 客製化指示相輔相成。 客製化代理定義角色與工具組,自訂指令設定一般編碼偏好,技能則提供針對特定任務的指引,任何代理都能自動發現並運用。

Prerequisites

特務技能的運作方式

當你使用 agent mode 時,Copilot 會自動從你的資料庫和使用者資料中發現技能。 代理人會判斷某項技能何時與你的請求相關並啟動。 當技能啟動時,聊天室會顯示該技能正在生效。

截圖,顯示Copilot Agent在聊天中使用技能。

使用內建的 .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)

  1. 選擇Copilot Chat右下角的Tools圖示以開啟技能面板。

  2. 選取面板右上角的 + 按鈕。

    從技能面板建立新技能的截圖。

  3. 選擇一個範圍(工作區 或 個人),並輸入你的技能名稱和描述。

    截圖顯示新技能命名的過程。

  4. Visual Studio 會按照 SKILL.md將 寫入選定的位置,並產生範本供你填寫。 你可以使用 Copilot Agent 模式來協助完成範本。

手動建立技能

每個技能都是一個目錄,內含 SKILL.md 符合 agentskills.io 規範的檔案。

  1. 建立技能目錄。 對於工作區技能,請在儲存庫的根目錄使用.github/skills/。 個人技能方面,請使用 ~/.copilot/skills/。

  2. 為你的技能建立一個子目錄。 每個技能都應該有自己的目錄(例如)。 .github/skills/github-issues/

  3. 在技能目錄裡建立一個 SKILL.md 檔案。 該檔案包含 YAML 前置內容,包含元資料,後接 Markdown 指令。

  4. 可選擇性地,將腳本、範例或其他資源加入你的技能目錄。

技能目錄結構

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 範例技能庫 。