GitHub Copilot oferece vários recursos de personalização que permitem adaptar seu comportamento ao fluxo de trabalho, aos padrões da sua equipe e às necessidades do projeto. Use as tabelas abaixo para encontrar a correta para seu caso de uso.
Visão geral do recurso
Esta tabela mostra o que é cada recurso de personalização e onde ele reside.
| Característica | O que é | Nome e local do arquivo |
|---|---|---|
| Instruções personalizadas | Contexto sempre ativo que se aplica automaticamente a cada interação dentro de seu escopo definido | .github/copilot-instructions.md (nível do repositório), .github/instructions/*.instructions.md (específico por caminho), AGENTS.md (agentes de terceiros) ou configurações pessoais/da organização via interface no GitHub |
| Arquivos de prompt | Modelo de prompt autônomo reutilizável com variáveis de entrada | .github/prompts/*.prompt.md |
| Agentes personalizados | Persona especializada com suas próprias instruções, restrições de ferramenta e contexto |
`.github/agents/AGENT-NAME.md` (repo), `agents/AGENT-NAME.md` no `.github-private` repo (org/enterprise) ou perfil de usuário |
| Subagentes | Agente separado gerado pelo agente principal para lidar com o trabalho delegado em um contexto isolado | N/A (processo de runtime, não um arquivo configurado pelo usuário) |
| Habilidades do agente | Pasta de instruções, scripts e recursos que Copilot carrega quando for relevante para uma tarefa |
.github/skills/<skill-name>/SKILL.md, .claude/skills/<skill-name>/SKILL.mdou .agents/skills/<skill-name>/SKILL.md (projeto); ~/.copilot/skills/<skill-name>/SKILL.md, ~/.claude/skills/<skill-name>/SKILL.mdou ~/.agents/skills/<skill-name>/SKILL.md (pessoal) |
| Ganchos | Comandos de shell personalizados que são executados deterministicamente em pontos específicos no fluxo de trabalho de um agente | .github/hooks/*.json |
| Servidores MCP | Conexão com sistemas externos, APIs e bancos de dados |
mcp.json (o caminho varia de acordo com a IDE), configurações de repositório em GitHub (agente de nuvem) ou a propriedade mcp-servers nas configurações agente personalizado |
Comparação de uso
Esta tabela ajuda você a decidir qual recurso de personalização usar.
| Característica | Como acionar | Mais adequado para | Exemplos de casos de uso |
|---|---|---|---|
| Instruções personalizadas | Automático | Padrões, diretrizes ou expectativas que se aplicam amplamente em um contexto | Impor padrões de codificação, regras de acessibilidade, listas de verificação de revisão |
| Arquivos de prompt | Manual: referenciar diretamente no chat ou usar o seletor de arquivos de prompt | Tarefas individuais focadas que você executa uma vez com entradas diferentes a cada vez | Gerar testes de unidade, executar uma lista de verificação de revisão de código |
| Agentes personalizados | Manual: selecione no menu suspenso de agentes na sua IDE, no GitHub ou no CLI do Copilot | Projetos ou processos com estágios distintos que precisam de recursos especializados ou entregas estritas | Agente revisor do React, agente de auditoria em modo somente leitura |
| Subagentes | Automático ou faça referência a um Subagente diretamente no seu prompt | Subtarefas complexas que devem ser executadas isoladamente do agente principal | Pesquisa da base de código, executando suítes de testes |
| Habilidades do agente | Automático: será escolhido pelo Copilot quando for relevante para o seu prompt. | Fluxos de trabalho de várias etapas com ativos empacotados que devem ser carregados conforme necessário |
GitHub Actions depuração de falhas, procedimentos de implantação, redação de nota de versão |
| Ganchos | Automático: em eventos de ciclo de vida configurados | Tarefas que precisam ser executadas em um ponto específico no ciclo de vida do agente, com execução garantida | Executar um formatador após cada edição de arquivo, aprovar ou negar execuções de ferramenta, evitar vazamentos de credenciais com secret scanning | | Servidores MCP | Automático ou peça uma ferramenta específica por nome | Tarefas que exigem acesso a ferramentas externas ou dados em tempo real | Gerenciar problemas e PRs (servidor MCP GitHub), automatizar o teste de navegador (servidor MCP Playwright) |
Suporte a IDE e Surface
Esta tabela mostra quais recursos de personalização têm suporte em cada IDE e superfície. Para obter a matriz de recursos completa Copilot , consulte matriz de recursos Copilot.
GitHub recomenda usar a versão mais recente e estável do IDE CLI do Copilot e da extensão Copilot para obter a melhor experiência Copilot.
**Chave:**
- ✓ = com suporte
- ✗ = sem suporte
- P = em versão prévia
| Característica | VS Code | Visual Studio | IDEs JetBrains | Eclipse | Xcode | GitHub .com | CLI do Copilot | |---------|:-------:|:-------------:|:---------:|:-------:|:-----:|:-------:|:---:| | Instruções personalizadas | ✓ | ✓ | P | P | P | ✓ | ✓ | | Arquivos de prompt | ✓ | ✓ | P | ✗ | P | ✗ | ✓ | | Agentes personalizados | ✓ | ✗ | P | P | P | ✓ | ✓ | | Subagentes | ✓ | ✗ | P | P | P | ✗ | ✓ | | Habilidades do agente | ✓ | ✗ | P | ✗ | ✗ | ✓ | ✓ | | Ganchos | P | ✗ | ✗ | ✗ | ✗ | ✓ | ✓ | | Servidores MCP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Para obter um detalhamento de quais tipos de instruções personalizadas têm suporte em cada IDE e superfície, consulte Suporte para diferentes tipos de instruções personalizadas.
Leitura adicional
- Biblioteca de personalização — uma coleção de exemplos curada
