Criando habilidades de agente para CLI do GitHub Copilot

Modifique o comportamento e as habilidades do Copilot quando ele atua em tarefas específicas.

Neste artigo

As habilidades do agente são pastas de instruções, scripts e recursos que o Copilot pode carregar quando relevante para melhorar seu desempenho em tarefas especializadas. Para saber mais, confira Sobre as habilidades do agente.

Criando e adicionando uma habilidade

Para criar uma habilidade de agente, você escreve um SKILL.md arquivo e, opcionalmente, outros recursos, como arquivos markdown suplementares ou scripts, que você faz referência nas SKILL.md instruções.

Para adicionar uma habilidade, você salva o arquivo SKILL.md e todos os recursos subsidiários em um local onde Copilot sabe procurar habilidades. Isso pode estar dentro de um repositório ou em seu diretório base.

  1. Crie um skills diretório para armazenar sua habilidade e quaisquer outras que você queira criar no futuro.

    Para habilidades de projeto, específicas para um único repositório, armazene sua habilidade em .github/skills ou .claude/skills.

    Para habilidades pessoais, compartilhadas entre projetos, armazene sua habilidade em ~/.copilot/skills ou ~/.claude/skills.

  2. Crie um subdiretório para sua nova habilidade. Cada habilidade deve ter seu próprio diretório (por exemplo, .github/skills/webapp-testing).

    Os nomes de subdiretórios para habilidades devem ser minúsculos e substituir espaços por hifens.

  3. Em seu subdiretório de habilidades, crie um SKILL.md arquivo que contenha as instruções de sua habilidade.

    Importante

    Os arquivos de skill devem ser nomeados SKILL.md.

           `SKILL.md` arquivos são arquivos Markdown com página inicial YAML. Em sua forma mais simples, eles incluem:
    • Front matter YAML * nome (obrigatório): um identificador exclusivo para a habilidade. O texto deve estar em minúsculas, usando hifens para espaços. Normalmente, isso corresponde ao nome do diretório da habilidade. * Descrição (obrigatório): uma descrição do que a função faz e quando Copilot deve usá-la. * licença (opcional): uma descrição da licença que se aplica a essa habilidade.
    • Um corpo em Markdown, com as instruções, exemplos e diretrizes para Copilot a seguir.

  4. Opcionalmente, adicione scripts, exemplos ou outros recursos ao diretório da sua habilidade.

    Por exemplo, se você estiver escrevendo uma habilidade para converter imagens entre formatos diferentes, poderá incluir um script para converter imagens SVG em PNG. As instruções sobre habilidades devem informar Copilot quando e como usar esses recursos.

Arquivo de exemplo SKILL.md

Para uma habilidade de projeto, esse arquivo estaria localizado em um .github/skills/github-actions-failure-debugging diretório do repositório.

Para uma experiência pessoal, esse arquivo estaria localizado em um ~/.copilot/skills/github-actions-failure-debugging diretório.

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.

Usando habilidades de agente

Ao executar tarefas, Copilot decidirá quando usar suas habilidades com base na sua solicitação e na descrição da habilidade.

Quando Copilot opta por usar uma habilidade, o arquivo SKILL.md será injetado no contexto do agente, dando ao agente acesso às suas instruções. Em seguida, ele pode seguir essas instruções e usar scripts ou exemplos que você possa ter incluído no diretório da habilidade.

Para instruir Copilot a usar uma habilidade específica, inclua o nome da habilidade em seu prompt, precedido por uma barra. Por exemplo, se você tiver uma habilidade chamada "front-end-design", poderá usar um prompt como:

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

Comandos de habilidades na CLI

  •         **Listar as habilidades disponíveis no momento:** use o comando `/skills list` ou o prompt:

    What skills do you have?

  •         **Habilitar ou desabilitar habilidades específicas:** use o comando `/skills` e, em seguida, use as teclas para cima e para baixo no teclado e a barra de espaço, para ativar ou desativar as habilidades.

  •         **Saiba mais sobre uma habilidade** (incluindo sua localização): use o comando `/skills info`.

  •         **Adicione um local de habilidades:** para adicionar um local alternativo no qual armazenar habilidades, use o comando `/skills add`.

  •         **Recarregar habilidades:** se você adicionou uma habilidade durante uma sessão da CLI, poderá adicioná-la usando o comando `/skills reload` para evitar a necessidade de reiniciar a CLI para usá-la.

  •         **Remova as habilidades:** para remover uma habilidade que você adicionou diretamente, não por meio de um plug-in, use o comando `/skills remove SKILL-DIRECTORY`. Para remover as habilidades adicionadas como parte de um plug-in, você deve gerenciar o plug-in em si. Use o `info` subcomando para descobrir de qual plug-in uma habilidade veio.

Habilidades versus instruções personalizadas

Você pode usar habilidades e instruções personalizadas para ensinar Copilot como trabalhar em seu repositório e como executar tarefas específicas.

É recomendável usar instruções personalizadas para instruções simples relevantes para quase todas as tarefas (por exemplo, informações sobre os padrões de codificação do repositório) e habilidades para instruções mais detalhadas que Copilot só devem ser acessadas quando forem relevantes.

Para saber mais sobre instruções personalizadas do repositório, consulte Como adicionar instruções personalizadas de repositório no GitHub Copilot.

Para saber mais sobre como as habilidades diferem de outros recursos de personalização, consulte Comparando os recursos de personalização da CLI do GitHub Copilot.