Quickstart: Uw eigen vaardigheden maken en toepassen voor de modernisering van GitHub Copilot

Deze quickstart laat zien hoe u uw eigen aangepaste vaardigheden maakt en toepast wanneer u GitHub Copilot-modernisering gebruikt.

GitHub Copilot-modernisering ondersteunt aangepaste vaardigheden om uw organisatiekennis te codificeren voor aangepaste bibliotheekupgrades, configuratie-updates, het afdwingen van coderingsstandaarden en meer. U kunt de standaard Microsoft-taken ook kopiëren naar aangepaste vaardigheden om ze aan uw behoeften aan te passen. U kunt aangepaste vaardigheden hergebruiken, delen en verbeteren om de efficiëntie van uw team te verbeteren.

Prerequisites

• Een GitHub-account met een actief GitHub Copilot-abonnement onder elk abonnement.
• Een van de volgende IDE's:
  • De nieuwste versie van Visual Studio Code. Moet versie 1.106 of hoger zijn.
    • GitHub Copilot in Visual Studio Code. Zie GitHub Copilot instellen in Visual Studio Code voor installatie-instructies. Meld u aan bij uw GitHub-account in Visual Studio Code.
    • GitHub Copilot-modernisering. Start Visual Studio Code opnieuw op na de installatie.
  • De nieuwste versie van IntelliJ IDEA. Moet versie 2023.3 of hoger zijn.
    • GitHub Copilot. Moet versie 1.5.59 of hoger zijn. Zie GitHub Copilot instellen in IntelliJ IDEA voor meer instructies. Meld u aan bij uw GitHub-account in IntelliJ IDEA.
    • GitHub Copilot-modernisering. Start IntelliJ IDEA opnieuw op na de installatie. Als u GitHub Copilot niet hebt geïnstalleerd, kunt u GitHub Copilot-modernisering rechtstreeks installeren.
• Java 21 of hoger.
• Maven of Gradle voor het bouwen van Java-projecten.

Uw eigen vaardigheid maken

Gebruik de volgende stappen om een aangepaste vaardigheid te maken.

Vaardigheidsgegevens definiëren

1. Open in de zijbalk Activiteit het uitbreidingsvenster gitHub Copilot-modernisering , beweeg de muisaanwijzer over de sectie TAKEN en selecteer vervolgens Een aangepaste vaardigheid maken.

   

2. Er wordt een SKILL.md bestand geopend. Vul de volgende velden in. Zie de specificatie van de agentvaardigheden voor de volledige specificatie van de vaardigheidsindeling.

   • Vaardigheidsnaam: Een beschrijvende identifier met een koppelteken voor de vaardigheid. Bijvoorbeeld 'Custom-skill-migrate-rabbitmq'.
   • Beschrijving van vaardigheid: een beknopt overzicht van het doel van de vaardigheid. Bijvoorbeeld 'RabbitMQ-berichten migreren naar Azure Service Bus voor Spring Boot-toepassingen'.
   • Vaardigheidsinhoud: gedetailleerde instructies die Copilot tijdens de codemigratie begeleiden. U kunt verwijzen naar bestanden uit de sectie Resources op naam in dit veld. Bijvoorbeeld: 'U bent een Spring Boot-ontwikkelaarsassistent, volgt guide.md om te migreren van RabbitMQ naar Azure Service Bus'.

Resources toevoegen

Resources bieden referentiekennis die Copilot gebruikt wanneer deze de vaardigheid toepast. Selecteer Resources toevoegen en kies een resourcetype:

• Bestanden: Selecteer afzonderlijke bestanden die migratie-instructies, configuratievoorbeelden of ander referentiemateriaal bevatten. Als u een Git-doorvoeringsverschil als een resource wilt opnemen, selecteert u het bijbehorende diff-bestand.

• Mappen: Selecteer een map om alle bestanden erin op te nemen als resources. Deze optie is handig wanneer naslagkennis meerdere gerelateerde bestanden omvat.

  

De geselecteerde bestanden worden gekopieerd naar in uw project. Resourcebestanden en -mappen worden samen met SKILL.md opgeslagen in de skillsmap. De totale resourcegrootte is beperkt. Zorg ervoor dat u naar deze bestanden of mappen verwijst op naam in het veld Vaardigheidsinhoud , zodat Copilot weet wanneer ze moeten worden gebruikt.

De vaardigheid opslaan

Nadat u alle velden hebt voltooid en resources hebt toegevoegd, selecteert u Opslaan. De aangepaste vaardigheid wordt weergegeven in de sectie Mijn vaardigheden .

Uw eigen vaardigheid delen

Deel een vaardigheid met anderen door de map uit uw project te kopiëren:

1. Kopieer de vaardigheidsmap onder .github/skills/ en deel deze met de beoogde ontvanger.

   

2. Plaats de map onder .github/skills/ in de projectroot van de ontvanger. Maak de directory indien deze niet bestaat.

3. Selecteer Vernieuwen in het extensiedeelvenster. De vaardigheid wordt weergegeven in de sectie Mijn vaardigheden , klaar om te gebruiken.

Uw eigen vaardigheid toepassen

Gebruik de volgende stappen om uw eigen vaardigheid toe te passen:

1. Selecteer Uitvoeren onderaan het SKILL.md bestand of zoek de vaardigheid in de sectie Mijn vaardigheden en selecteer Vaardigheid uitvoeren.

2. Het Copilot-chatvenster wordt geopend in de agentmodus en voert automatisch de volgende stappen uit:

   1. Hiermee maakt u plan.md en progress.md.
   2. Controleert de status van het versiebeheer en controleert een nieuwe migratiebranch.
   3. Voert codemigratie uit.
   4. Voert validaties en fixes uit voor build- en eenheidstests, CVE, consistentiecontrole en volledigheidscontrole.
   5. Hiermee wordt een summary.md-bestand gegenereerd.

3. Als de agent pauzeert voor bevestiging of wordt onderbroken, voert u Doorgaan in om verder te gaan.

4. Nadat alle stappen zijn voltooid, controleert u de codewijzigingen en selecteert u Behouden in het chatvenster om te bevestigen.

Kopiëren naar Mijn Skills

Als u een Microsoft-taak wilt aanpassen, kunt u deze als uitgangspunt exporteren naar Mijn vaardigheden en deze vervolgens aanpassen aan uw behoeften:

1. Zoek in de sectie TAKEN de Microsoft-taak die u wilt aanpassen.

2. Klik met de rechtermuisknop op het item en selecteer Kopiëren naar Mijn vaardigheden.

   

3. Er wordt een nieuw SKILL.md bestand geopend, vooraf gevuld met de inhoud van het geselecteerde item. Bewerk indien nodig de velden Vaardigheidsnaam, Beschrijving, Inhoud en Resources .

4. Selecteer Opslaan. De vaardigheid wordt weergegeven in de sectie Mijn vaardigheden .

Uw eigen vaardigheid bijwerken of verwijderen

Klik in de sectie Mijn vaardigheden met de rechtermuisknop op de vaardigheid die u wilt wijzigen en kies een van de volgende opties:

• Bewerken om de vaardigheid bij te werken.
• Verwijder om de vaardigheid te verwijderen.

Veelgestelde vragen

Als ik handmatig een vaardigheidsmap in .github/skills/plaats, herkent de extensie deze dan?

Ja. Als u een geldige vaardigheidsmap met een SKILL.md bestand in .github/skills/ de hoofdmap van uw project plaatst, herkent de extensie deze nadat u Vernieuwen hebt geselecteerd in het extensiedeelvenster. De vaardigheid wordt weergegeven in de sectie Mijn vaardigheden van het deelvenster TAKEN en u kunt deze op dezelfde manier uitvoeren, bewerken of verwijderen als elke andere aangepaste vaardigheid.

Alleen bronbestanden waarnaar expliciet wordt verwezen SKILL.md , worden echter weergegeven in de gebruikersinterface van de extensie. Wanneer u de knop Resources toevoegen gebruikt, kopieert de extensie de geselecteerde bestanden naar de vaardigheidsmap en voegt u een koppelingsvermelding toe onder SKILL.md de sectie Resources , bijvoorbeeld:

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

Als u handmatig extra bestanden in de vaardigheidsmap plaatst zonder deze koppelingsvermeldingen toe te voegen, worden deze niet weergegeven in de extensie. Als u ervoor wilt zorgen dat resourcebestanden worden weergegeven in de gebruikersinterface en beschikbaar zijn voor Copilot, voegt u deze altijd toe via de knop Resources toevoegen of voegt u de bijbehorende koppelingsvermeldingen handmatig toe in SKILL.md.

Volgende stap

Vooraf gedefinieerde taken voor modernisering van GitHub Copilot