Erstellen von Agentenfertigkeiten für GitHub Copilot-CLI

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

In diesem Artikel

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.

Verwenden von Agentenkenntnissen

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.

Um Copilot anzuweisen, eine bestimmte Fertigkeit zu verwenden, fügen Sie den Namen der Fertigkeit mit vorangestelltem Slash in Ihre Eingabeaufforderung ein. Wenn Sie beispielsweise eine Fähigkeit namens "frontend-design" haben, könnten Sie eine Aufforderung wie folgt verwenden:

Use the /frontend-design skill to create a responsive navigation bar in React.

Fähigkeitenbefehle in der CLI

  •         **Auflisten der derzeit verfügbaren Fähigkeiten:** Verwenden Sie den Befehl `/skills list` oder die Eingabeaufforderung:

    What skills do you have?

  •         **Aktivieren oder deaktivieren Sie bestimmte Fähigkeiten: Verwenden Sie** den Befehl `/skills` , und verwenden Sie dann die NACH-OBEN- und NACH-UNTEN-TASTE auf der Tastatur und die Leertaste, um Die Fähigkeiten ein- oder auszuschalten.

  •         **Erfahren Sie mehr über eine Fähigkeit** (einschließlich ihres Standorts): Verwenden Sie den Befehl `/skills info`.

  •         **Fügen Sie einen Speicherort für Fähigkeiten hinzu: Um** einen alternativen Speicherort hinzuzufügen, an dem Fähigkeiten gespeichert werden sollen, verwenden Sie den Befehl `/skills add`.

  •         **Neuladen von Fähigkeiten:** Wenn Sie während einer CLI-Sitzung eine Fähigkeit hinzugefügt haben, können Sie sie mithilfe des Befehls `/skills reload` hinzufügen, um zu vermeiden, dass Sie die CLI neu starten müssen, um sie zu verwenden.

  •         **Entfernen Sie Fähigkeiten:** Um eine Fähigkeit zu entfernen, die Sie direkt hinzugefügt haben , nicht über ein Plug-In, verwenden Sie den Befehl `/skills remove SKILL-DIRECTORY`. Um fähigkeiten zu entfernen, die als Teil eines Plug-Ins hinzugefügt werden, müssen Sie das Plug-In selbst verwalten. Verwenden Sie den `info` Unterbefehl, um herauszufinden, von welchem Plugin eine Fähigkeit stammt.

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.

Weitere Informationen dazu, wie sich die Fähigkeiten von anderen Anpassungsfeatures unterscheiden, finden Sie unter Vergleich der Anpassungsfunktionen von GitHub Copilot CLI.