Guida introduttiva: Creare e applicare competenze personalizzate per la modernizzazione di GitHub Copilot

Questa guida introduttiva illustra come creare e applicare competenze personalizzate quando si usa la modernizzazione di GitHub Copilot.

La modernizzazione di GitHub Copilot supporta competenze personalizzate per codificare le conoscenze aziendali per l'aggiornamento della libreria personalizzata, gli aggiornamenti della configurazione, l'applicazione degli standard di codifica e altro ancora. È anche possibile copiare le attività Microsoft predefinite in competenze personalizzate per adattarle alle proprie esigenze. È possibile riutilizzare, condividere e migliorare le competenze personalizzate per migliorare l'efficienza del team.

Prerequisites

• Un account GitHub con una sottoscrizione di GitHub Copilot attiva in qualsiasi piano.
• Uno degli IDE seguenti:
  • Versione più recente di Visual Studio Code. Deve essere la versione 1.106 o successiva.
    • GitHub Copilot in Visual Studio Code. Per istruzioni sulla configurazione, vedere Configurare GitHub Copilot in Visual Studio Code. Assicurarsi di accedere all'account GitHub in Visual Studio Code.
    • Modernizzazione di GitHub Copilot. Riavviare Visual Studio Code dopo l'installazione.
  • La versione più recente di IntelliJ IDEA. Deve essere la versione 2023.3 o successiva.
    • GitHub Copilot. Deve essere la versione 1.5.59 o successiva. Per altre istruzioni, vedere Configurare GitHub Copilot in IntelliJ IDEA. Assicurarsi di accedere all'account GitHub all'interno di IntelliJ IDEA.
    • Modernizzazione di GitHub Copilot. Riavviare IntelliJ IDEA dopo l'installazione. Se GitHub Copilot non è installato, è possibile installare direttamente la modernizzazione di GitHub Copilot.
• Java 21 o versione successiva.
• Maven o Gradle per compilare progetti Java.

Crea la tua abilità

Usare la procedura seguente per creare una competenza personalizzata.

Definire le informazioni sulle competenze

1. Nella barra laterale Attività aprire il riquadro dell'estensione per la modernizzazione di GitHub Copilot , passare il puntatore del mouse sulla sezione ATTIVITÀ e quindi selezionare Crea una competenza personalizzata.

   

2. Verrà aperto un SKILL.md file. Compilare i campi seguenti. Per la specifica del formato completo della competenza, vedere la specifica delle competenze dell'agente.

   • Nome competenza: identificatore descrittivo e sillabato per la competenza. Ad esempio, "Custom-skill-migrate-rabbitmq".
   • Descrizione competenza: riepilogo conciso dello scopo della competenza. Ad esempio, "Eseguire la migrazione della messaggistica RabbitMQ al bus di servizio di Azure per le applicazioni Spring Boot".
   • Contenuto della competenza: istruzioni dettagliate che guidano Copilot durante la migrazione del codice. È possibile fare riferimento ai file dalla sezione Risorse in base al nome in questo campo. Ad esempio, "Si è un assistente per sviluppatori Spring Boot, seguire guide.md questa procedura per eseguire la migrazione da RabbitMQ al bus di servizio di Azure".

Aggiungere risorse

Le risorse forniscono informazioni di riferimento usate da Copilot quando applica la competenza. Selezionare Aggiungi risorse e scegliere un tipo di risorsa:

• File: selezionare singoli file che contengono istruzioni di migrazione, esempi di configurazione o altro materiale di riferimento. Per includere un diff di commit Git come risorsa, selezionare il file diff corrispondente.

• Cartelle: selezionare una cartella per includere tutti i file all'interno di esso come risorse. Questa opzione è utile quando le informazioni di riferimento si estendono su più file correlati.

  

I file selezionati vengono copiati .github/skills/<skill-name>/ nel tuo progetto. I file di risorse e le cartelle vengono archiviati nella cartella delle skill insieme a SKILL.md. Le dimensioni totali delle risorse sono limitate. Assicurarsi di fare riferimento a questi file o cartelle in base al nome nel campo Contenuto competenza in modo che Copilot sappia quando usarli.

Salvare la competenza

Dopo aver completato tutti i campi e aver aggiunto le risorse, selezionare Salva. La competenza personalizzata viene visualizzata nella sezione My Skills (Competenze personali).

Condividere le proprie competenze

Condividere una competenza con altri utenti copiandone la cartella dal progetto:

1. Copiare la cartella della skill situata in .github/skills/ e condividerla con il destinatario desiderato.

   

2. Sul lato del destinatario posizionare la cartella nella .github/skills/ radice del progetto. Creare la directory se non esiste.

3. Selezionare Aggiorna nel riquadro dell'estensione. La competenza viene visualizzata nella sezione My Skills (Competenze personali ) pronta per l'uso.

Applicare la propria competenza

Per applicare una competenza personalizzata, seguire questa procedura:

1. Selezionare Esegui nella parte inferiore del SKILL.md file oppure trovare la competenza nella sezione My Skills (Competenze personali ) e selezionare Run Skill (Esegui competenza).

2. La finestra della chat di Copilot viene aperta in modalità agente ed esegue automaticamente i passaggi seguenti:

   1. Crea plan.md e progress.md.
   2. Controlla lo stato del controllo della versione ed effettua il checkout di un nuovo ramo di migrazione.
   3. Esegue la migrazione del codice.
   4. Esegue convalide e correzioni per compilazione, unit test, CVE, verifica coerenza e verifica completezza.
   5. Genera un file summary.md .

3. Se l'agente viene sospeso per conferma o viene interrotto, immettere Continua per continuare.

4. Al termine di tutti i passaggi, esaminare le modifiche al codice e selezionare Mantieni nella finestra della chat per confermare.

Copia nelle mie competenze

Se si vuole personalizzare un'attività Microsoft, è possibile esportarla in My Skills come punto di partenza e quindi modificarla in base alle proprie esigenze:

1. Nella sezione ATTIVITÀ individuare l'attività Microsoft che si vuole personalizzare.

2. Fare clic con il pulsante destro del mouse sull'elemento e scegliere Copia nelle mie competenze.

   

3. Verrà aperto un nuovo SKILL.md file, precompilato con il contenuto dell'elemento selezionato. Modificare i campi Nome competenza, Descrizione, Contenuto e Risorse in base alle esigenze.

4. Seleziona Salva. La competenza viene visualizzata nella sezione My Skills (Competenze personali ).

Aggiornare o eliminare la tua propria competenza

Nella sezione My Skills (Competenze personali) fare clic con il pulsante destro del mouse sulla competenza da modificare e scegliere una delle opzioni seguenti:

• Modificare per aggiornare la competenza.
• Elimina per rimuovere la skill.

Domande frequenti

Se si inserisce manualmente una cartella delle competenze in .github/skills/, l'estensione lo riconosce?

Sì. Se si inserisce una cartella di skill valida contenente un file SKILL.md dentro .github/skills/ nella radice del progetto, l'estensione lo riconosce dopo aver selezionato Aggiorna nel riquadro dell'estensione. La competenza viene visualizzata nella sezione My Skills del pannello TASKS ed è possibile eseguirla, modificarla o eliminarla allo stesso modo di qualsiasi altra competenza personalizzata.

Tuttavia, nell'interfaccia utente dell'estensione vengono visualizzati solo i file di risorse a cui viene fatto riferimento in modo esplicito SKILL.md . Quando si usa il pulsante Aggiungi risorse, l'estensione copia i file selezionati nella cartella dell'abilità e aggiunge una voce di collegamento in SKILL.md nella sezione Risorse, ad esempio:

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

Se aggiungi manualmente file extra nella cartella della skill senza aggiungere le voci di collegamento per i link, l'estensione non li visualizza. Per assicurarsi che i file di risorse vengano visualizzati nell'interfaccia utente e siano disponibili per Copilot, aggiungerli sempre tramite il pulsante Aggiungi risorse o aggiungere manualmente le voci di collegamento corrispondenti in SKILL.md.

Passo successivo

Attività predefinite per la modernizzazione di GitHub Copilot