Utilize as Competências de Agente com o GitHub Copilot

As competências dos agentes são conjuntos reutilizáveis de instruções que ensinam os agentes do Copilot a executar tarefas específicas, como executar um pipeline de build, gerar boilerplate ou seguir os padrões de codificação da sua equipa. Ao definir competências uma vez, poupa tempo e assegura um comportamento consistente ao longo do seu fluxo de trabalho.

As habilidades complementam agentes personalizados e instruções personalizadas. Embora os agentes personalizados definam uma persona e um conjunto de ferramentas, e as instruções personalizadas definam preferências gerais de programação, as competências fornecem orientações focadas e específicas para tarefas, que qualquer agente pode descobrir e usar automaticamente.

Prerequisites

• Visual Studio 2026 versão 18.5 ou posterior
• Uma subscrição GitHub Copilot

Como funcionam as Competências de Agente

Quando usa o modo agente, Copilot descobre automaticamente competências no seu repositório e perfil de utilizador. O agente decide quando uma habilidade é relevante para o seu pedido e ativa-a. Quando uma habilidade é ativada, ela aparece no chat para te informar que está a ser aplicada.

Localização das competências

As competências são adquiridas nos seguintes locais:

As competências do espaço de trabalho são partilhadas com a sua equipa através do controlo de origem. As competências pessoais aplicam-se a todos os teus projetos e não estão comprometidas com nenhum repositório.

Criar uma competência

Podes criar uma skill a partir do painel de skills no Visual Studio, ou manualmente no teu sistema de ficheiros. Para criar uma competência a partir do painel de habilidades, deve ter o Visual Studio 2026 Insiders versão 18.6 ou posterior.

Crie uma competência a partir do painel de competências

1. Selecione o ícone Tools no canto inferior direito da Copilot Chat para abrir o painel de competências.

2. Selecione o + botão no canto superior direito do painel.

   

3. Escolha um destino (competência global ou ao nível da solução) e escolha um nome.

   

4. O Visual Studio gera um modelo de competências para preencheres. Podes usar o modo agente do Copilot para te ajudar a completar o modelo.

Cria uma competência manualmente

Cada competência é um diretório que contém um SKILL.md ficheiro que segue a especificação agentskills.io.

1. Crie um diretório de competências. Para uma competência de espaço de trabalho, usa .github/skills/ na raiz do teu repositório. Para uma competência pessoal, use ~/.copilot/skills/.

2. Cria um subdiretório para a tua competência. Cada habilidade deve ter o seu próprio diretório (por exemplo, .github/skills/github-issues/).

3. Cria um SKILL.md ficheiro na pasta de competências. O ficheiro contém cabeçalho YAML com metadados seguidos de instruções em Markdown.

4. Opcionalmente, adiciona scripts, exemplos ou outros recursos ao diretório da tua competência.

Estrutura de diretórios de competências

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

SKILL.md formato

O SKILL.md ficheiro deve conter material inicial YAML seguido de conteúdo Markdown:

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Propriedades do Frontmatter

Dicas para escrever competências eficazes

• Mantém a seção principal SKILL.md com menos de 500 linhas. Mover o material de referência detalhado para ficheiros separados no references/ diretório.
• Escreva um texto claro description que inclua palavras-chave específicas para ajudar os agentes a identificar quando a competência é relevante.
• Inclua instruções passo a passo, exemplos e casos extremos comuns.

Gerir competências a partir do painel de competências

Selecione o ícone Tools no canto inferior direito da Copilot Chat para abrir o painel de habilidades, uma vista dedicada a cada habilidade descoberta. O painel de Competências está disponível apenas no Visual Studio 2026 Insiders.

A partir do painel, pode:

• Edit: Abrir qualquer habilidade SKILL.md diretamente no editor no menu...
• Abrir a localização do ficheiro: Salta para o diretório de habilidades no disco.
• Pesquisar: Filtrar competências por nome ou palavra-chave.

O painel também apresenta diagnósticos para quaisquer erros de configuração de habilidades, para que possa rapidamente identificar e corrigir problemas.

Competências comunitárias

Veja o repositório awesome-copilot para exemplos de habilidades partilhadas pela comunidade.

Conteúdo relacionado

• Comece a usar o modo agente do Copilot do GitHub
• Usa agentes personalizados em GitHub Copilot
• Personalize as respostas do chat e defina o contexto
• Usar servidores MCP