Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Umiejętności agenta to zestawy instrukcji wielokrotnego użytku, które uczą agentów Copilot, jak wykonywać określone zadania, takie jak uruchamianie potoku kompilacji, generowanie szablonowego kodu lub przestrzeganie zespołowych standardów kodowania. Definiowanie umiejętności raz pozwala zaoszczędzić czas i zapewnić spójne zachowanie w przepływie pracy.
Umiejętności uzupełniają agentów niestandardowych i instrukcje niestandardowe. Podczas gdy agenci dostosowani definiują personę i zestaw narzędzi, a niestandardowe instrukcje ustawiają ogólne preferencje dotyczące kodowania, umiejętności zapewniają ukierunkowane, specyficzne dla zadań wskazówki, które każdy agent może odkrywać i używać automatycznie.
Prerequisites
- Visual Studio 2026 w wersji 18.5 lub nowszej
- Subskrypcja GitHub Copilot
Jak działają umiejętności agenta
W przypadku korzystania z trybu agent Copilot automatycznie odnajduje umiejętności z repozytorium i profilu użytkownika. Agent decyduje, kiedy umiejętność jest odpowiednia dla Twojego żądania i aktywuje ją. Po aktywowaniu umiejętności pojawia się na czacie, aby poinformować Cię, że jest ona stosowana.
Korzystanie z wbudowanych umiejętności .NET i Azure
Visual Studio obejmuje wbudowane umiejętności utworzone przez ekspertów z zespołów .NET i Azure. Umiejętności są dostępne podczas instalowania odpowiednich obciążeń .NET i Azure.
Wbudowane umiejętności są domyślnie wyłączone. Aby je przejrzeć i zarządzać, wybierz ikonę Narzędzia w Copilot Chat, aby otworzyć selektor narzędzi, a następnie rozwiń pozycję Wbudowane. Umieść kursor na umiejętności, aby wyświetlić jego opis i ścieżkę pliku. Aby wyświetlić całą umiejętność lub jej folder, użyj menu .... Włącz tylko umiejętności, które mają zastosowanie do zadań.
Aby uzyskać więcej informacji na temat dostępnych umiejętności, zobacz .NET umiejętności i repozytoria umiejętności Azure.
Lokalizacje umiejętności
Visual Studio wykrywa umiejętności niestandardowe w następujących lokalizacjach:
| Typ umiejętności | Location |
|---|---|
| Umiejętności dotyczące obszaru roboczego lub projektu (przechowywane w repozytorium) |
.github/skills/, .claude/skills/, .agents/skills/ |
| Umiejętności osobiste (przechowywane w profilu użytkownika) |
~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ |
Umiejętności dotyczące obszaru roboczego są udostępniane zespołowi za pośrednictwem kontroli źródła. Umiejętności osobiste mają zastosowanie do wszystkich Twoich projektów i nie są powiązane z żadnym repozytorium.
Tworzenie umiejętności
Możesz utworzyć umiejętności z panelu umiejętności w Visual Studio lub ręcznie w systemie plików. Aby utworzyć umiejętność z panelu Umiejętności, musisz mieć program Visual Studio 2026 Insiders w wersji 18.6 lub nowszej.
Utwórz umiejętność w panelu umiejętności (Insiders)
Wybierz ikonę Tools w prawym dolnym rogu Copilot Chat, aby otworzyć panel umiejętności.
+ Wybierz przycisk w prawym górnym rogu panelu.
Wybierz zakres (obszar roboczy lub osobisty) i wprowadź nazwę i opis umiejętności.
Visual Studio zapisuje element
SKILL.mdw wybranej lokalizacji zgodnie ze specyfikacją agentskills.io i generuje szablon do wypełnienia. Możesz użyć trybu agent funkcji Copilot, aby ułatwić ukończenie szablonu.
Ręczne tworzenie umiejętności
Każda umiejętność to katalog zawierający plik zgodny ze SKILL.md agentskills.io.
Utwórz katalog umiejętności. W przypadku funkcji obszaru roboczego użyj
.github/skills/w katalogu głównym repozytorium. Aby uzyskać osobistą umiejętność, użyj polecenia~/.copilot/skills/.Utwórz podkatalog dla swojej umiejętności. Każda umiejętność powinna mieć własny katalog (na przykład
.github/skills/github-issues/).Utwórz plik
SKILL.mdw katalogu umiejętności. Plik zawiera frontmatter YAML z metadanymi, a następnie instrukcje w języku Markdown.Opcjonalnie dodaj skrypty, przykłady lub inne zasoby do katalogu umiejętności.
Struktura katalogu umiejętności
your-repo/
└── .github/
└── skills/
└── github-issues/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
format SKILL.md
Plik SKILL.md musi zawierać frontmatter YAML, po którym następuje zawartość języka 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
Właściwości frontmatteru
| Property | Required | Description |
|---|---|---|
name |
Tak | Tylko małe litery, cyfry i łączniki. Nazwa musi odpowiadać nazwie katalogu nadrzędnego. Maksymalnie 64 znaki. |
description |
Tak | Opisuje, co robi umiejętność i kiedy należy jej używać. Maksymalnie 1024 znaki. |
license |
Nie. | Nazwa licencji lub odwołanie do dołączonego pliku licencji. |
compatibility |
Nie. | Wymagania środowiskowe, takie jak zamierzony produkt lub wymagane pakiety systemowe. |
metadata |
Nie. | Dowolne mapowanie wartości klucza dla dodatkowych metadanych. |
allowed-tools |
Nie. | Rozdzielony spacjami ciąg wstępnie zatwierdzonych narzędzi, z których może korzystać moduł. |
Porady dotyczące skutecznego opisywania umiejętności
- Zachowaj główną
SKILL.mdwartość poniżej 500 wierszy. Przenieś szczegółowy materiał referencyjny do oddzielnych plików wreferences/katalogu. - Napisz jasne
description, które zawiera określone słowa kluczowe, aby pomóc agentom zidentyfikować, kiedy umiejętność jest istotna. - Dołącz instrukcje krok po kroku, przykłady i typowe przypadki brzegowe.
Zarządzanie umiejętnościami z panelu umiejętności
Wybierz ikonę Tools w prawym dolnym rogu Copilot Chat, aby otworzyć panel umiejętności, dedykowany widok każdej odnalezionej umiejętności. Panel Umiejętności jest dostępny tylko w Visual Studio 2026 Insiders.
Z panelu można wykonywać następujące czynności:
-
Edytuj: Otwórz dowolną umiejętność
SKILL.mdbezpośrednio w edytorze z menu ... - Otwórz lokalizację pliku: przejdź do katalogu umiejętności na dysku.
- Wyszukiwanie: filtruj umiejętności według nazwy lub słowa kluczowego.
Panel przedstawia również diagnostykę błędów konfiguracji umiejętności, dzięki czemu można szybko wykrywać i rozwiązywać problemy.
Kompetencje wspólnotowe
Zobacz repozytorium awesome-copilot w celu zapoznania się z przykładowymi umiejętnościami udostępnianymi przez społeczność.