Pular para o conteúdo
NovidadesIA

Projetos de Código Aberto

GitHub detalha quatro formas de ensinar regras de repositórios ao Copilot

Guia técnico mostra como configurar instruções, rotinas, agentes e servidores MCP em arquivos locais do projeto.

Edição: Anderson Gomes
· 3 min de leitura

GitHub detalha quatro formas de ensinar regras de repositórios ao Copilot
Imagem: Reprodução · GitHub · reprodução · licença não declarada

O GitHub publicou em 12 de outubro de 2026 um guia com quatro métodos para alimentar o Copilot com padrões internos de projetos de software. O autor do texto, Christopher Harrison (@geektrainer), explica como guardar regras de arquitetura e rotinas de teste diretamente na pasta do código para o assistente consultar sem intervenção manual. A documentação interessa a quem programa em equipe e gasta tempo repetindo comandos básicos em cada janela de conversa. O processo elimina a digitação contínua de parâmetros.

Antes desse formato estruturado, quem usava o assistente precisava reescrever convenções de nomenclatura e passos de compilação a cada nova tarefa iniciada. O guia centraliza essas definições em arquivos de texto dentro da pasta .github. O arquivo .github/copilot-instructions.md recebe as regras gerais do repositório, como padrões de teste e arquitetura preferida. Regras específicas ficam em .github/instructions e trazem o campo applyTo para filtrar diretórios. O modelo cruza os dois arquivos quando edita o código. A leitura acontece sem intervenção externa.

Arquivos no repositório guardam rotinas e perfis dedicados

Procedimentos repetitivos que exigem passos coordenados ganham o nome de habilidades de agente no ecossistema da ferramenta. Essas rotinas ficam em subpastas de .github/skills, onde cada item recebe um documento SKILL.md. O exemplo citado por Christopher Harrison organiza verificações de qualidade na pasta .github/skills/quality-checks. O documento lista quando carregar a habilidade, quais scripts executam testes e linters, o que cada rotina valida e como resolver erros frequentes. A descrição impede que o Copilot chute comandos no terminal.

Para trabalhos que pedem visão global, o repositório recebe perfis especializados em .github/agents. Esse arquivo configura agentes dedicados a funções pontuais, como uma auditoria de acessibilidade que percorre componentes, folhas de estilo e arquivos de interface. O perfil define objetivo, ferramentas permitidas e contexto da tarefa. O material do GitHub não apresenta dados de latência nem limites de consumo de memória durante essas varreduras complexas. O texto foca apenas na estrutura sintática das pastas.

Servidores MCP conectam o assistente a navegadores externos

A integração com recursos fora do repositório depende de servidores construídos sob o protocolo Model Context Protocol (MCP). Esses conectores ligam o Copilot a ferramentas de terceiros, como servidores de documentação e servidores de automação web. O tutorial destaca o servidor MCP do Playwright, que abre páginas em navegadores e aciona botões diretamente pela linha de comando. Harrison instrui o usuário a pedir a validação manual de interfaces após mudanças no código. O assistente simula cliques humanos para checar o funcionamento real da tela.

A empresa trata os quatro recursos como engrenagens complementares, mas o texto oficial opera como vitrine do próprio aplicativo Copilot. Harrison não lista requisitos mínimos de assinatura do serviço nem detalha o suporte a repositórios em plataformas concorrentes. As instruções exigem que o time mantenha a documentação interna rigorosamente atualizada em Markdown, transferindo para quem desenvolve o trabalho contínuo de calibrar regras e manter servidores de terceiros em operação. O texto assume que o repositório já mantém padrões claros.

  • GitHub
  • Projetos de Código Aberto

Fonte: Comunicado oficial · Como produzimos as matérias