Como configurar diretrizes de codificação para a revisão de código do GitHub Copilot

Sobre as diretrizes de codificação

Você pode personalizar a Revisão de código do Copilot com diretrizes de codificação personalizadas escritas em linguagem natural. Para obter mais informações sobre a Revisão de código do Copilot, confira “Como usar a revisão de código do GitHub Copilot”.

Com as diretrizes de codificação, o Copilot pode fornecer comentários com base no estilo de codificação e nas melhores práticas específicas da sua organização.

Como a Revisão de código do Copilot é alimentada por um grande modelo de linguagem, ela pode ajudar na imposição de diretrizes de codificação que não são cobertas pela sua ferramenta de análise estática ou pelo linter.

As diretrizes de codificação são configuradas no repositório. Você pode criar e habilitar até seis diretrizes de codificação por repositório.

Recomendações para as diretrizes de codificação

• Use uma linguagem simples, clara e concisa para descrever a diretriz de codificação.
• Seja o mais específico possível sobre o que Copilot deve procurar – ou seja, o que você *quer ou não ver no código.
• Confira os “Exemplos de diretrizes de codificação” *abaixo para ter inspiração.
• Não tente usar diretrizes de codificação para impor diretrizes de estilo que podem ser abordadas *na ferramenta de análise estática ou no linter.
• Não use palavras ambíguas ou que possam ser interpretadas de maneiras diferentes.
• Não tente colocar várias ideias diferentes em uma só diretriz de codificação.*

Como criar uma diretriz de codificação

1. Em GitHub, acesse a página principal do repositório.

2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

3. Na seção “Código e automação” da barra lateral, selecione Copilot e depois Revisão de código.

4. Selecione Criar diretriz.

5. Em “Nome”, dê um nome à diretriz de codificação.

6. Em “Descrição”, forneça uma descrição da diretriz de codificação de até 600 caracteres. Isso será usado pelo Copilot para entender seu estilo de codificação e decidir quando deixar um comentário.

   A forma como você escreve a descrição tem um grande impacto na qualidade dos comentários que serão gerados pelo Copilot. Para obter ajuda com a escrita de diretrizes de codificação eficazes, confira “Recomendações para as diretrizes de codificação” acima e “Exemplos de diretrizes de codificação” abaixo.

7. Opcionalmente, limite a diretriz de codificação a tipos de arquivo ou caminhos específicos selecionando Adicionar caminho de arquivo e adicionando padrões de caminho.

   Você pode usar a sintaxe fnmatch para definir os caminhos de destino, com * como um curinga para corresponder a qualquer cadeia de caracteres.

   Como o GitHub usa o sinalizador File::FNM_PATHNAME para a sintaxe File.fnmatch, o curinga * não corresponde aos separadores de diretório (/). Por exemplo, qa/* corresponderá a todos os branches que começam com qa/ e que contêm uma barra "/", mas não corresponderá a qa/foo/bar. Você pode incluir qualquer quantidade de barras "/" após qa com qa/**/*, o que corresponderá, por exemplo, a qa/foo/bar/foobar/hello-world. Você também pode estender a cadeia de caracteres qa com qa**/**/* para tornar a regra mais inclusiva.

   Para obter mais informações sobre as opções de sintaxe, confira a documentação de fnmatch.

8. Teste a diretriz de codificação para verificar se ela funciona conforme o esperado.

   1. Selecione Adicionar amostra.
   2. Adicione uma amostra própria ou pressione Generate code sample para gerar automaticamente um código de exemplo com base no título e na descrição.
   3. Selecione Salvar para salvar o código de exemplo.
   4. Teste a diretriz de codificação em relação à amostra pressionando Executar.

9. Salve a diretriz de codificação e ative-a selecionando Salvar diretriz.

Como executar uma revisão com diretrizes de codificação

Quando você solicita uma revisão do Copilot, ele usará automaticamente as diretrizes de codificação habilitadas do repositório para revisar seu código. Para obter mais informações, confira "Como usar a revisão de código do GitHub Copilot".

Os comentários gerados com base em uma diretriz de codificação incluirão uma mensagem, realçando a origem dela.

Exemplos de diretrizes de codificação

Exemplo 1: evite usar números mágicos

Título: Avoid using magic numbers

Descrição: Don't use magic numbers in code. Numbers should be defined as constants or variables with meaningful names.

Padrões de caminho: **/*.py

Exemplo 2: não use SELECT * em consultas SQL

Título: Don't use `SELECT *` in SQL queries

Descrição: Don't use `SELECT *` in SQL queries. Always specify the columns you want to select. `COUNT(*)` is allowed.

Padrões de caminho: nenhum (aplica-se a todos os tipos de arquivo, pois as consultas SQL podem ser inseridas no código).

Exemplo 3: use fetch para solicitações HTTP

Título: Use `fetch` for HTTP requests

Descrição: Use `fetch` for HTTP requests, not `axios` or `superagent` or other libraries.

Padrões de caminho: **/*.ts, **/*.js, **/*.jsx, **/*.tsx

Exemplo 4: sempre adicione tags às métricas com o ambiente atual

Título: Always tag metrics with the current environment

Descrição: Always include a `env` tag with the current environment when emitting metrics, for example, `env:prod` or `env:dev`.

Padrões de caminho: */*.go, */*.java