Verwendung von Agentenfähigkeiten mit GitHub Copilot

Agent-Fähigkeiten sind wiederverwendbare Anweisungen, die Copilot-Agenten beibringen, wie sie spezifische Aufgaben ausführen, etwa beim Ausführen einer Build-Pipeline, beim Generieren von Boilerplate-Code oder beim Befolgen der Codierungsstandards Ihres Teams. Durch einmaliges Definieren von Fähigkeiten sparen Sie Zeit und sorgen für ein einheitliches Verhalten im gesamten Workflow.

Fähigkeiten ergänzen benutzerdefinierte Agents und benutzerdefinierte Anweisungen. Während benutzerdefinierte Agents eine Persona und einen Toolsatz definieren und benutzerdefinierte Anweisungen allgemeine Codierungseinstellungen festlegen, bieten Fähigkeiten fokussierte, aufgabenspezifische Anleitungen, die jeder Agent automatisch erkennen und verwenden kann.

Prerequisites

Funktionsweise von Agentenfähigkeiten

Wenn Sie agentmodus verwenden, erkennt Copilot automatisch Fähigkeiten aus Ihrem Repository und Benutzerprofil. Der Agent entscheidet, wann eine Fähigkeit für Ihre Anfrage relevant ist und aktiviert. Wenn eine Fähigkeit aktiviert wird, wird sie im Chat angezeigt, um Sie darüber zu informieren, dass sie angewendet wird.

Screenshot, der zeigt, wie der Copilot-Agent eine Fähigkeit im Chat verwendet.

Qualifikationsstandorte

Die Fähigkeiten werden von den folgenden Standorten abgeholt:

Fähigkeitstyp Ort
Arbeitsbereichs- oder Projektfähigkeiten (gespeichert in Ihrem Repository) .github/skills/, .claude/skills/.agents/skills/
Persönliche Fähigkeiten (gespeichert in Ihrem Benutzerprofil) ~/.copilot/skills/, ~/.claude/skills/~/.agents/skills/

Arbeitsbereichskenntnisse werden über die Quellcodeverwaltung für Ihr Team freigegeben. Persönliche Fähigkeiten gelten für alle Ihre Projekte und sind an kein Repository gebunden.

Erstellen einer Qualifikation

Sie können eine Fähigkeit manuell in Ihrem Dateisystem erstellen.

Manuelles Erstellen einer Fähigkeit

Jede Fähigkeit ist ein Verzeichnis mit einer SKILL.md Datei, die der agentskills.io Spezifikation folgt.

  1. Erstellen Sie ein Kompetenzverzeichnis. Verwenden Sie .github/skills/ für eine Arbeitsbereichskompetenz im Stammverzeichnis Ihres Repositorys. Für eine persönliche Fähigkeit verwenden Sie ~/.copilot/skills/.

  2. Erstellen Sie ein Unterverzeichnis für Ihre Fähigkeiten. Jede Fähigkeit sollte über ein eigenes Verzeichnis verfügen (z. B .github/skills/github-issues/. ).

  3. Erstellen Sie eine SKILL.md Datei im Qualifikationsverzeichnis. Die Datei enthält YAML-Frontmatter mit Metadaten gefolgt von Markdown-Anweisungen.

  4. Fügen Sie optional Skripts, Beispiele oder andere Ressourcen zum Verzeichnis Ihrer Fähigkeiten hinzu.

Kompetenzverzeichnisstruktur

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

SKILL.md Format

Die SKILL.md Datei muss YAML-Frontmatter enthalten, gefolgt von Markdown-Inhalt:

---
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

Frontmatter-Eigenschaften

Property Erforderlich Beschreibung
name Ja Nur Kleinbuchstaben, Zahlen und Bindestriche. Muss mit dem namen des übergeordneten Verzeichnisses übereinstimmen. Maximal 64 Zeichen.
description Ja Beschreibt, was die Fähigkeit tut und wann sie verwendet werden soll. Maximal 1.024 Zeichen.
license No Lizenzname oder Verweis auf eine gebündelte Lizenzdatei.
compatibility No Umgebungsanforderungen, z. B. beabsichtigtes Produkt oder erforderliche Systempakete.
metadata No Beliebige Schlüsselwertzuordnung für zusätzliche Metadaten.
allowed-tools No Mit Leerzeichen getrennte Zeichenfolge von vorab genehmigten Tools, die die Fähigkeit nutzen kann.

Tipps zum Schreiben effektiver Fähigkeiten

  • Halten Sie das Haupt-SKILL.md unter 500 Zeilen. Verschieben Sie detailliertes Referenzmaterial in separate Dateien im references/ Verzeichnis.
  • Schreiben Sie ein Klares description , das bestimmte Schlüsselwörter enthält, um Agenten dabei zu helfen, zu identifizieren, wann die Qualifikation relevant ist.
  • Fügen Sie schrittweise Anleitungen, Beispiele und gängige Randfälle ein.

Fähigkeiten über das Fähigkeiten-Panel verwalten

Wählen Sie in der unteren rechten Ecke Copilot Chat das Symbol Tools aus, um den Kompetenzbereich zu öffnen, eine dedizierte Ansicht aller entdeckten Fähigkeiten. Der Bereich "Fähigkeiten" ist nur im Visual Studio 2026 Insider verfügbar.

Screenshot des Bereichs

Folgende Optionen stehen Ihnen im Bereich zur Verfügung:

  • Bearbeiten: Öffnen Sie alle Fähigkeiten SKILL.md direkt im Editor über das Menü ... .
  • Dateispeicherort öffnen: Wechseln Sie zum Verzeichnis der Fähigkeiten auf dem Datenträger.
  • Suche: Filtern sie Fähigkeiten nach Name oder Schlüsselwort.

Das Panel zeigt auch Diagnosen für alle Fähigkeitskonfigurationsfehler an, sodass Sie Probleme schnell erkennen und beheben können.

Fähigkeiten der Gemeinschaft

Sehen Sie sich das Super-Copilot-Repository an, z. B. Fähigkeiten, die von der Community geteilt werden.