GitHub explica a iniciantes como ensinar o Copilot sobre a base de código: 4 mecanismos

O GitHub lançou um material de aprendizado para iniciantes no aplicativo Copilot. O tema é restrito, mas prático: como explicar ao assistente de IA do que o seu projeto é feito e quais regras valem nele. O guia detalha quatro mecanismos: instruções personalizadas, skills, agentes personalizados e servidores MCP, incluindo o Playwright.

O anúncio é curto, então a descrição abaixo apresenta a lógica geral dessas ferramentas com base na documentação atual do GitHub. Os nomes exatos de arquivos e os itens de menu no próprio aplicativo podem ser diferentes.

O problema que o guia resolve

Por padrão, qualquer assistente de IA conhece a linguagem de programação, mas não conhece o seu projeto. Ele não sabe que os testes rodam via pnpm, que os estilos ficam em uma camada separada e que acessar o banco diretamente a partir dos controllers é proibido. O resultado é um código plausível que não passa na revisão. Corrigir isso manualmente no chat a cada vez toma tempo, e o conhecimento não se acumula.

A abordagem do GitHub é tirar o contexto da cabeça do desenvolvedor e levá-lo para o repositório. Regras e descrições ficam junto do código, são versionadas no git e funcionam da mesma forma para todos que abrem o projeto.

Quatro alavancas de configuração

O guia monta a configuração do mais simples ao mais complexo.

• Instruções. Um arquivo de texto no repositório, geralmente em Markdown. Ele descreve a stack, os comandos de build e de testes, o estilo de código e as proibições. É a camada mínima, que deve ser feita primeiro.
• Skills (habilidades). Pacotes de conhecimento e roteiros para uma tarefa específica, como preparar um release ou escrever uma migração. Elas são carregadas quando a tarefa exige e não ocupam o contexto o tempo todo.
• Agentes personalizados. Perfis separados, cada um com papel, conjunto de ferramentas e regras próprios: revisor, autor de testes, redator técnico. Em tarefas recorrentes, não é preciso reescrever o prompt toda vez.
• Servidores MCP. O protocolo Model Context Protocol conecta ferramentas externas ao Copilot. O exemplo do material é o Playwright. Com ele, o agente pode abrir uma página no navegador, percorrer um fluxo de usuário e verificar o resultado, em vez de adivinhar a partir do código.

Por que isso importa justamente agora

As ferramentas de programação com IA estão deixando o autocompletar para trás e migrando para agentes que alteram arquivos e executam comandos por conta própria. Quanto mais autonomia o agente tem, mais caro custa a falta de contexto: um erro em uma linha vira um commit errado com vinte arquivos. Configurar pelo repositório sai mais barato do que lidar com as consequências.

A abordagem também tem um lado negativo. As instruções ficam desatualizadas como qualquer documentação. Se a equipe trocou o linter e o arquivo de regras continuou o mesmo, o agente seguirá com confiança as regras antigas. Além disso, um servidor MCP com acesso ao navegador ou a sistemas externos amplia a superfície de ataque, e as permissões dele precisam ser restringidas com o mesmo cuidado que as do CI.

Por onde começar na prática

1. Escreva um arquivo de instruções curto: stack, comandos de instalação, build e testes, e de três a cinco regras rígidas. O agente aproveita pior textos longos do que textos curtos e precisos.

2. Teste o resultado em uma tarefa real e pequena, como a correção de um bug. Se o Copilot erra sempre no mesmo ponto, adicione essa regra ao arquivo.

3. Transforme processos repetitivos, como revisão ou escrita de testes, em agentes ou skills separados. 4.

Conecte os servidores MCP um por vez. Comece pelo Playwright, para verificar a interface, e defina logo de início a quais domínios e ações ele tem acesso. 5.

Inclua o arquivo de instruções na revisão de código. As regras devem mudar junto com o código.

A conclusão para o iniciante é simples: em uma noite dá para ter um assistente que conhece os seus comandos e as convenções do projeto. Todo o valor do guia está em mostrar a ordem dos passos, e não funções isoladas.