Quickstart: cria e aplica as tuas próprias competências para a modernização do GitHub Copilot

Este quickstart mostra-te como criar e aplicar as tuas próprias competências personalizadas quando usas a modernização do GitHub Copilot.

A modernização do GitHub Copilot suporta competências personalizadas para codificar o seu conhecimento organizacional para atualização personalizada de bibliotecas, atualizações de configuração, aplicação de padrões de programação e muito mais. Também pode copiar as tarefas Microsoft predefinidas para criar habilidades personalizadas e ajustá-las às suas necessidades. Pode reutilizar, partilhar e melhorar competências personalizadas para aumentar a eficiência da sua equipa.

Prerequisites

• Uma conta GitHub com uma subscrição ativa GitHub Copilot em qualquer plano.
• Um dos seguintes IDEs:
  • A versão mais recente de Visual Studio Code. Deve ser a versão 1.106 ou posterior.
    • GitHub Copilot em Visual Studio Code. Para instruções de configuração, veja configurar GitHub Copilot em Visual Studio Code. Certifique-se de iniciar sessão na sua conta GitHub dentro do Visual Studio Code.
    • GitHub Copilot modernização. Reinicie o Visual Studio Code após a instalação.
  • A última versão do IntelliJ IDEA. Deve ser a versão 2023.3 ou posterior.
    • GitHub Copilot. Deve ser versão 1.5.59 ou posterior. Para mais instruções, veja configurar GitHub Copilot no IntelliJ IDEA. Certifique-se de iniciar sessão na sua conta GitHub dentro da IntelliJ IDEA.
    • GitHub Copilot modernização. Reinicie o IntelliJ IDEA após a instalação. Se não tiveres o GitHub Copilot instalado, podes instalar a modernização do GitHub Copilot diretamente.
• Java 21 ou posterior.
• Maven ou Gradle para construir projetos Java.

Cria a tua própria habilidade

Use os passos seguintes para criar uma competência personalizada.

Defina informação de competência

1. Na barra lateral Activity, abra o painel de extensão Modernização do GitHub Copilot, coloque o cursor sobre a secção TAREFAS e depois selecione Criar uma Habilidade Personalizada.

   

2. Abre-se um SKILL.md ficheiro. Preencha os campos seguintes. Para a especificação completa do formato de competência, consulte a especificação de Competências do Agente.

   • Nome da Habilidade: Um identificador descritivo e hifenizado para a habilidade. Por exemplo, "Custom-skill-migrate-rabbitmq".
   • Descrição da Habilidade: Um resumo conciso do propósito da habilidade. Por exemplo, "Migrar as mensagens RabbitMQ para o Azure Service Bus em aplicações Spring Boot".
   • Skill Content: Instruções detalhadas que orientam o Copilot durante a migração de código. Pode referenciar ficheiros da secção de Recursos pelo nome neste campo. Por exemplo, "És um assistente de programador Spring Boot, segue guide.md para migrar do RabbitMQ para o Azure Service Bus."

Adicionar recursos

Os recursos fornecem conhecimento de referência que o Copilot usa quando aplica a habilidade. Selecione Adicionar Recursos e escolha um tipo de recurso:

• Ficheiros: Selecione ficheiros individuais que contenham instruções de migração, exemplos de configuração ou outro material de referência. Para incluir um diff de commit Git como recurso, selecione o ficheiro diff correspondente.

• Pastas: Selecione uma pasta para incluir todos os ficheiros nela como recursos. Esta opção é útil quando o conhecimento de referência abrange vários ficheiros relacionados.

  

Os ficheiros selecionados são copiados para .github/skills/<skill-name>/ no seu projeto. Ficheiros de recursos e pastas são armazenados juntamente SKILL.md com a pasta de habilidades. O tamanho total dos recursos é limitado. Certifique-se de referenciar estes ficheiros ou pastas pelo nome no campo Skill Content para que Copilot saiba quando os deve usar.

Guarda a habilidade

Depois de completares todos os campos e adicionares recursos, seleciona Guardar. A habilidade personalizada aparece na secção Minhas Habilidades .

Partilha a tua própria habilidade

Partilhe uma habilidade com outros ao copiar a sua pasta do seu projeto:

1. Copie a pasta de habilidades localizada abaixo .github/skills/ e partilhe-a com o destinatário pretendido.

   

2. Do lado do destinatário, coloque a pasta dentro de .github/skills/ na raiz do projeto. Crie o diretório se ele não existir.

3. Selecione Atualizar no painel de extensão. A habilidade aparece na secção Minhas Habilidades , pronta a usar.

Aplica a tua própria habilidade

Use os seguintes passos para aplicar a sua própria habilidade:

1. Selecione Executar no final do SKILL.md ficheiro, ou encontre a habilidade na secção Minhas Competências e selecione Executar Habilidade.

2. A janela de chat do Copilot abre-se no Modo Agente e executa automaticamente os seguintes passos:

   1. Cria plan.md e progress.md.
   2. Verifica o estado do controlo de versões e verifica uma nova ramificação de migração.
   3. Realiza migração de código.
   4. Executa validações e correções para build, testes unitários, CVE, verificação de consistência e verificação de completude.
   5. Gera um ficheiro summary.md .

3. Se o agente fizer uma pausa para confirmação ou for interrompido, introduza Continuar para prosseguir.

4. Depois de todos os passos terminarem, revê as alterações ao código e seleciona Guardar na janela de chat para confirmar.

Copiar para Minhas Competências

Se quiseres personalizar uma tarefa Microsoft, podes exportá-la para Minhas Competências como ponto de partida e depois modificá-la para se adequar às tuas necessidades:

1. Na secção TAREFAS, localiza a tarefa Microsoft que queres personalizar.

2. Clique com o botão direito no item e selecione Copiar para as Minhas Habilidades.

   

3. Abre-se um novo SKILL.md ficheiro, pré-preenchido com o conteúdo do item selecionado. Edite os campos Nome da Perância, Descrição, Conteúdo e Recursos conforme necessário.

4. Selecione Guardar. A habilidade aparece na secção Minhas Habilidades .

Atualiza ou elimina a tua própria habilidade

Na secção Minhas Habilidades , clique com o botão direito na habilidade que pretende modificar e escolha uma das seguintes opções:

• Edit para atualizar a habilidade.
• Apagar para remover a habilidade.

Perguntas frequentes

Se eu colocar manualmente uma pasta de habilidades em .github/skills/, a extensão reconhece-a?

Yes. Se colocares uma pasta de skill válida contendo um SKILL.md ficheiro na .github/skills/ raiz do teu projeto, a extensão reconhece-a depois de selecionares Atualizar no painel de extensões. A habilidade aparece na secção Minhas Habilidades do painel TAREFAS , e podes executá-la, editar ou eliminá-la da mesma forma que qualquer outra habilidade personalizada.

No entanto, apenas ficheiros de recursos que são explicitamente referenciados em SKILL.md são exibidos na interface de extensão. Quando usa o botão Adicionar Recursos , a extensão copia os ficheiros selecionados para a pasta de habilidades e adiciona uma entrada SKILL.md de link na secção de Recursos , por exemplo:

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

Se colocares manualmente ficheiros extra na pasta de habilidades sem adicionar estas entradas de links, a extensão não os apresenta. Para garantir que os ficheiros de recursos aparecem na interface e estão disponíveis para Copilot, adicione-os sempre através do botão Adicionar Recursos ou adicione manualmente as correspondentes entradas do link em SKILL.md.

Próximo passo

Tarefas pré-definidas para modernização GitHub Copilot