Erstellen von Agentenfertigkeiten für GitHub Copilot

Sie können das Verhalten und die Fertigkeiten von Copilot ändern, wenn er an bestimmten Aufgaben arbeitet.

In diesem Artikel

Hinweis

Agentenfähigkeiten funktionieren mit Copilot-Programmierassistent, GitHub Copilot-CLI und dem Agentmodus in Visual Studio Code Insiders. Unterstützung in der stabilen Version von VS Code wird in Kürze verfügbar sein.

Agentenfertigkeiten sind Ordner mit Anleitungen, Skripten und Ressourcen, die Copilot im Bedarfsfall laden kann, um seine 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 Fertigkeit hinzuzufügen, speichern Sie die Datei SKILL.md und alle untergeordneten Ressourcen an einem Speicherort, an dem Copilot weiß, wo nach Fähigkeiten gesucht werden muss. Dies kann sich innerhalb eines Repositorys oder in Ihrem Startverzeichnis befinden.

  1. Erstellen Sie ein skills Verzeichnis, um Ihre Fähigkeiten und alle anderen zu speichern, die Sie in Zukunft erstellen möchten.

    Für Projektkompetenzen, die für ein einzelnes Repository spezifisch sind, speichern Sie Ihre Fähigkeiten unter .github/skills oder .claude/skills.

    Für persönliche Fähigkeiten, die über Projekte hinweg geteilt werden, speichern Sie Ihre Fähigkeiten unter ~/.copilot/skills oder ~/.claude/skills.

  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 macht und wann sie von Copilot verwendet werden sollte. * lizenz (optional): Eine Beschreibung der Lizenz, die für diese Fähigkeit gilt.
    • Ein Markdown-Inhalt mit den Anleitungen, Beispielen und Richtlinien, denen Copilot folgen soll.

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

    Wenn Sie beispielsweise eine Fähigkeit zum Konvertieren von Bildern zwischen verschiedenen Formaten geschrieben haben, können Sie ein Skript zum Konvertieren von SVG-Bildern in PNG einschließen. Die Fertigkeitsanweisungen sollen Copilot anweisen, wann und wie diese Ressourcen verwendet werden.

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.

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 benutzerdefinierter Repositoryanweisungen für GitHub Copilot.