Erstellen von Agent-Fähigkeiten für GitHub Copilot

Sie können das Verhalten und die Fähigkeiten von Copilot ändern, wenn es an bestimmten Aufgaben arbeitet.

In diesem Artikel

Hinweis

Agentenfähigkeiten funktionieren mit Copilot Codierungsassistent, dem GitHub Copilot-CLI und dem Agentenmodus in Visual Studio Code.

Agentenfähigkeiten sind Ordner mit Anweisungen, Skripts und Ressourcen, die Copilot geladen werden können, wenn dies relevant ist, um deren Leistung bei spezialisierten Aufgaben zu verbessern. Weitere Informationen finden Sie unter Informationen zu Agentenkenntnissen.

Erstellen und Hinzufügen einer Fähigkeit

Um eine Agentfähigkeit zu erstellen, schreiben Sie eine SKILL.md Datei und optional andere Ressourcen, z. B. ergänzende Markdown-Dateien oder Skripts, auf die Sie in den SKILL.md Anweisungen verweisen.

Um eine Fähigkeit hinzuzufügen, speichern Sie die SKILL.md Datei und alle untergeordneten Ressourcen an einem Speicherort, an dem Copilot sie nach Fähigkeiten suchen kann. Dies kann sich innerhalb eines Repositorys oder in Ihrem Startverzeichnis befinden.

  1. Erstellen Sie ein skills Verzeichnis an einem der unterstützten Speicherorte, um Ihre Fähigkeiten und alle anderen zu speichern, die Sie in Zukunft erstellen möchten.

    Für Projektkompetenzen, die spezifisch für ein einzelnes Repository sind, erstellen Sie ein .github/skills, .claude/skills oder .agents/skills Verzeichnis und verwenden Sie es in Ihrem Repository.

    Für persönliche Fähigkeiten, die projektübergreifend geteilt werden, erstellen und verwenden Sie ein ~/.copilot/skills, ~/.claude/skills, oder ~/.agents/skills Verzeichnis in Ihrem Heimverzeichnis.

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

    Skill-Unterverzeichnisnamen sollten in Kleinbuchstaben geschrieben sein und Bindestriche für Leerzeichen verwenden.

  3. Erstellen Sie in Ihrem Qualifikationsunterverzeichnis eine SKILL.md Datei mit den Anweisungen Ihrer Fähigkeiten.

    Wichtig

    Skill-Dateien müssen SKILL.md genannt werden.

           `SKILL.md` Dateien sind Markdown-Dateien mit YAML-Frontmatter. In ihrer einfachsten Form enthalten sie:
    • YAML-Titelei * Name (erforderlich): Ein eindeutiger Bezeichner für die Fähigkeit. Dies muss kleingeschrieben sein, wobei Bindestriche für Leerzeichen verwendet werden. In der Regel entspricht dies dem Namen des Qualifikationsverzeichnisses. * Beschreibung (erforderlich): Eine Beschreibung, was die Fähigkeit tut, und wann Copilot sollte sie verwendet werden. * lizenz (optional): Eine Beschreibung der Lizenz, die für diese Fähigkeit gilt.
    • Ein Markdown-Textkörper mit Anweisungen, Beispielen und Richtlinien, denen Copilot folgen soll.

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

    Weitere Informationen finden Sie unter "Aktivieren einer Fähigkeit zum Ausführen eines Skripts".

Beispieldatei für SKILL.md

Für eine Projektkompetenz würde sich diese Datei in einem .github/skills/github-actions-failure-debugging Verzeichnis Ihres Repositorys befinden.

Für eine persönliche Fähigkeit würde sich diese Datei in einem ~/.copilot/skills/github-actions-failure-debugging Verzeichnis befinden.

Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

Aktivieren einer Fähigkeit zum Ausführen eines Skripts

Wenn eine Fähigkeit aufgerufen wird, Copilot entdeckt automatisch alle Dateien im Verzeichnis der Fähigkeiten und macht sie zusammen mit den Anweisungen der Qualifikation verfügbar. Dies bedeutet, dass Sie Skripts oder andere Ressourcen in das Qualifikationsverzeichnis aufnehmen und in Ihren SKILL.md Anweisungen darauf verweisen können.

So erstellen Sie eine Fähigkeit, die ein Skript ausführt:

  1.        **Fügen Sie das Skript zum Verzeichnis Ihrer Fähigkeiten hinzu.** Beispielsweise könnte eine Fähigkeit zum Konvertieren von SVG-Bildern in PNG die folgende Struktur haben.

    .github/skills/image-convert/
├── SKILL.md
└── convert-svg-to-png.sh

  2.        **Optional genehmigen Sie die Tools, die die Fertigkeit benötigt, vorab.** In Ihrem `SKILL.md` Front-Matter können Sie das `allowed-tools` Feld verwenden, um die Tools aufzulisten, die Copilot möglicherweise verwenden darf, ohne jedes Mal eine Bestätigung einholen zu müssen. Wenn ein Tool nicht im `allowed-tools` Feld aufgeführt ist, fordert Copilot Sie um Erlaubnis auf, bevor es verwendet wird.

    ---
name: image-convert
description: Converts SVG images to PNG format. Use when asked to convert SVG files.
allowed-tools: shell
---

    Warnung

    Genehmigen Sie shell oder bash Tools nur vorab, wenn Sie diese Fähigkeit und alle referenzierten Skripte überprüft haben und deren Quelle vollständig vertrauen. Die Vorabgenehmigung von shell oder bash entfernt den Bestätigungsschritt bei der Ausführung von Terminalbefehlen und kann angreifergesteuerte Befehle oder Eingabeaufforderungen zur Ausführung beliebiger Befehle in Ihrer Umgebung ermöglichen. Wenn Sie im Zweifel sind, lassen Sie shell und bash von allowed-tools weg, damit Copilot Ihre ausdrückliche Bestätigung anfordern muss, bevor Terminalbefehle ausgeführt werden.

  3.        **Schreiben Sie Anweisungen zur Copilot Verwendung des Skripts.** Beschreiben Sie im Markdown-Textkörper `SKILL.md`, wann und wie das Skript ausgeführt wird.

    When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script
from this skill's base directory, passing the input SVG file path as the
first argument.

Wie Copilot Agentenfähigkeiten verwendet

Bei der Durchführung von Aufgaben entscheidet Copilot anhand deines Prompts und der Beschreibung des Skills, wann Deine Skills verwendet werden.

Wenn Copilot sich zur Verwendung eines Skills entscheidet, wird die SKILL.md-Datei in den Kontext des Agents eingebunden, was dem Agent Zugriff auf Deine Anweisungen gewährt. Anschließend können Sie diesen Anweisungen folgen und alle Skripts oder Beispiele verwenden, die Sie möglicherweise in das Verzeichnis der Skills eingefügt haben.

Fähigkeiten im Vergleich zu benutzerdefinierten Anweisungen

Du kannst sowohl Skills als auch benutzerdefinierte Anleitungen verwenden, um Copilot anzuleiten, wie man in Deinem Repository arbeitet und spezifische Aufgaben durchführt.

Wir empfehlen, benutzerdefinierte Anweisungen für einfache Anweisungen zu verwenden, die für fast jede Aufgabe relevant sind (z. B. Informationen zu den Codierungsstandards Ihres Repositorys), und Kompetenzen für detailliertere Anweisungen, auf die Copilot nur dann zugreifen soll, wenn es relevant ist.

Weitere Informationen zu benutzerdefinierten Repositoryanweisungen finden Sie unter Hinzufügen von benutzerdefinierten Repositoryanweisungen für GitHub Copilot.