Kurzanleitung: Erstellen und Anwenden eigener Fähigkeiten zur Modernisierung von GitHub Copilot

In dieser Schnellstartanleitung erfahren Sie, wie Sie ihre eigenen benutzerdefinierten Fähigkeiten erstellen und anwenden, wenn Sie GitHub Copilot Modernisierung verwenden.

GitHub Copilot Erweiterung unterstützt benutzerdefinierte Funktionen, um Ihr Organisationswissen für benutzerdefinierte Bibliotheks-Upgrades, Konfigurationsupdates, das Erzwingen von Codierungsstandards und vieles mehr einzubinden. Sie können auch die sofort einsatzbereiten Microsoft Aufgaben in benutzerdefinierte Fähigkeiten kopieren, um sie an Ihre Bedürfnisse anzupassen. Sie können benutzerdefinierte Fähigkeiten wiederverwenden, teilen und verbessern, um die Effizienz Ihres Teams zu steigern.

Prerequisites

• Ein GitHub-Konto mit einem aktiven GitHub Copilot-Abonnement unter einem beliebigen Plan.
• Eine der folgenden IDEs:
  • Die neueste Version von Visual Studio Code. Muss Version 1.106 oder höher sein.
    • GitHub Copilot in Visual Studio Code. Anweisungen zum Einrichten finden Sie unter Set up GitHub Copilot in Visual Studio Code. Melden Sie sich innerhalb Visual Studio Code bei Ihrem GitHub Konto an.
    • GitHub Copilot Modernisierung. Starten Sie Visual Studio Code nach der Installation neu.
  • Die neueste Version von IntelliJ IDEA. Muss Version 2023.3 oder höher sein.
    • GitHub Copilot. Muss Version 1.5.59 oder höher sein. Weitere Anweisungen finden Sie unter Setup GitHub Copilot in IntelliJ IDEA. Melden Sie sich unbedingt bei Ihrem GitHub Konto in IntelliJ IDEA an.
    • GitHub Copilot Modernisierung. Starten Sie IntelliJ IDEA nach der Installation neu. Wenn Sie GitHub Copilot nicht installiert haben, können Sie GitHub Copilot Modernisierung direkt installieren.
• Java 21 oder höher.
• Maven oder Gradle zum Erstellen Java Projekte.

Eigene Fähigkeiten erstellen

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Fähigkeit zu erstellen.

Definieren von Qualifikationsinformationen

1. In der Activity Seitenleiste öffnen Sie das GitHub Copilot Erweiterungspaneel, zeigen Sie mit der Maus auf den Abschnitt TASKS, und wählen Sie dann Erstellen Sie eine benutzerdefinierte Fähigkeit aus.

   

2. Eine SKILL.md Datei wird geöffnet. Füllen Sie die folgenden Felder aus. Die Spezifikation des vollständigen Qualifikationsformats finden Sie in der Spezifikation "Agent Skills".

   • Qualifikationsname: Ein beschreibender, bindestrichierter Bezeichner für die Fähigkeit. Beispiel: "Custom-skill-migrate-rabbitmq".
   • Qualifikationsbeschreibung: Eine kurze Zusammenfassung des Qualifikationszwecks. Beispiel: "RabbitMQ-Nachrichtenübermittlung zu Azure Service Bus für Spring-Boot-Anwendungen migrieren".
   • Skill Content: Detaillierte Anweisungen, die Copilot während der Kodierungsmigration anleiten. Sie können im Abschnitt "Ressourcen " anhand des Namens in diesem Feld auf Dateien verweisen. Beispiel: "Sie sind Ein Spring Boot-Entwicklerassistent, folgen Sie guide.md, um von RabbitMQ zu Azure Service Bus zu migrieren."

Ressourcen hinzufügen

Ressourcen bieten Referenzwissen, das Copilot verwendet, wenn er diese Fähigkeit einsetzt. Wählen Sie "Ressourcen hinzufügen" und dann einen Ressourcentyp aus:

• Dateien: Wählen Sie einzelne Dateien aus, die Migrationsanweisungen, Konfigurationsbeispiele oder andere Referenzmaterialien enthalten. Um einen Git Commit-Diff als Ressource einzuschließen, wählen Sie die entsprechende Diff-Datei aus.

• Ordner: Wählen Sie einen Ordner aus, um alle Darin enthaltenen Dateien als Ressourcen einzuschließen. Diese Option ist nützlich, wenn sich das Referenzwissen über mehrere verwandte Dateien erstreckt.

  

Die ausgewählten Dateien werden in .github/skills/<skill-name>/ Ihres Projekts kopiert. Ressourcendateien und Ordner werden zusammen mit SKILL.md im Skill-Ordner gespeichert. Die Gesamtressourcengröße ist begrenzt. Stellen Sie sicher, dass Sie im Feld Skill Content auf diese Dateien oder Ordner anhand des Namens verweisen, damit Copilot weiß, wann sie verwendet werden sollen.

Speichern Sie die Fähigkeit

Nachdem Sie alle Felder abgeschlossen und Ressourcen hinzugefügt haben, wählen Sie "Speichern" aus. Die benutzerdefinierte Fähigkeit wird im Abschnitt "Meine Fähigkeiten" angezeigt.

Teilen Sie Ihre eigenen Fähigkeiten

Teilen Sie eine Fertigkeit mit anderen, indem Sie den Ordner aus Ihrem Projekt kopieren.

1. Kopieren Sie den Qualifikationsordner unter .github/skills/ , und geben Sie ihn für den vorgesehenen Empfänger frei.

   

2. Platzieren Sie den Ordner .github/skills/ auf der Seite des Empfängers unter dem Projektstamm. Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist.

3. Wählen Sie im Erweiterungsbereich "Aktualisieren" aus. Die Fähigkeiten werden im Abschnitt "Meine Fähigkeiten " angezeigt, die einsatzbereit sind.

Eigene Fähigkeiten anwenden

Führen Sie die folgenden Schritte aus, um Ihre eigenen Fähigkeiten anzuwenden:

1. Wählen Sie unten in der Datei SKILL.md aus, oder suchen Sie die Fähigkeiten im Abschnitt "Meine Fähigkeiten", und wählen Sie "Fertigkeit ausführen" aus.

2. Das Copilot Chatfenster wird im Agentmodus geöffnet und führt automatisch die folgenden Schritte aus:

   1. Erstellt plan.md und progress.md.
   2. Überprüft den Versionssteuerungsstatus und checkt einen neuen Migrationszweig aus.
   3. Führt die Migration des Codes durch.
   4. Führt Überprüfungen und Korrekturen für Build- und Komponententests, CVE, Konsistenzüberprüfung und Vollständigkeitsprüfung aus.
   5. Generiert eine summary.md Datei.

3. Wenn der Agent zur Bestätigung anhält oder unterbrochen wird, geben Sie "Weiter" ein, um fortzufahren.

4. Nachdem alle Schritte abgeschlossen sind, überprüfen Sie die Codeänderungen, und wählen Sie "Im Chatfenster beibehalten" aus, um dies zu bestätigen.

Zu meinen Fähigkeiten kopieren

Wenn Sie eine Microsoft Aufgabe anpassen möchten, können Sie sie in My Skills als Ausgangspunkt exportieren und dann an Ihre Anforderungen anpassen:

1. Suchen Sie im Abschnitt TASKS die Microsoft Aufgabe, die Sie anpassen möchten.

2. Klicken Sie mit der rechten Maustaste auf das Element, und wählen Sie "In meine Fähigkeiten kopieren" aus.

   

3. Eine neue SKILL.md Datei wird geöffnet, die bereits mit dem Inhalt des ausgewählten Elements ausgefüllt wurde. Bearbeiten Sie die Felder "Qualifikationsname", " Beschreibung", "Inhalt" und "Ressourcen " nach Bedarf.

4. Wählen Sie Speichern aus. Die Fähigkeit wird im Abschnitt "Meine Fähigkeiten" angezeigt.

Aktualisieren oder Löschen Ihrer eigenen Fähigkeiten

Klicken Sie im Abschnitt "Meine Fähigkeiten " mit der rechten Maustaste auf die Fähigkeiten, die Sie ändern möchten, und wählen Sie eine der folgenden Optionen aus:

• Bearbeiten, um die Fähigkeit zu aktualisieren.
• Löschen, um die Fähigkeit zu entfernen.

Häufig gestellte Fragen

Wenn ich manuell einen Qualifikationsordner .github/skills/einstelle, erkennt die Erweiterung ihn?

Ja. Wenn Sie einen gültigen Qualifikationsordner, der eine SKILL.md Datei .github/skills/ enthält, im Projektstamm ablegen, erkennt die Erweiterung ihn, nachdem Sie im Erweiterungsbereich "Aktualisieren" ausgewählt haben. Die Fähigkeit wird im Abschnitt "Meine Fähigkeiten" des Aufgabenbereichs angezeigt, und Sie können sie auf die gleiche Weise ausführen, bearbeiten oder löschen wie alle anderen benutzerdefinierten Fähigkeiten.

In der Erweiterungs-UI werden jedoch nur Ressourcendateien angezeigt, die explizit in SKILL.md referenziert werden. Wenn Sie die Schaltfläche "Ressourcen hinzufügen" verwenden, kopiert die Erweiterung die ausgewählten Dateien in den Qualifikationsordner und fügt unter dem Abschnitt SKILL.md" einen Linkeintrag hinzu, z. B.:

**Resources:**
- file:///references.txt

Wenn Sie zusätzliche Dateien manuell im Qualifikationsordner platzieren, ohne diese Linkeinträge hinzuzufügen, werden sie von der Erweiterung nicht angezeigt. Um sicherzustellen, dass Ressourcendateien auf der Benutzeroberfläche angezeigt werden und für Copilot verfügbar sind, fügen Sie sie immer über die Schaltfläche Add Resources hinzu, oder fügen Sie die entsprechenden Linkeinträge manuell in SKILL.md hinzu.

Nächster Schritt

Vordefinierte Aufgaben für GitHub Copilot Modernisierung