Note
As diretrizes de codificação personalizadas são limitadas a participantes selecionados na versão prévia pública da Revisão de código do Copilot e só estão disponíveis como parte de uma assinatura do GitHub Copilot Enterprise.
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.
Note
- As diretrizes de codificação só funcionam com as linguagens com suporte na revisão de código do Copilot. Para ver uma lista de linguagens com suporte, confira “Como usar a revisão de código do GitHub Copilot”.
- As diretrizes de codificação só se aplicam às revisões de código realizadas pelo Copilot. As diretrizes não afetam as sugestões de preenchimento de código do Copilot nem o código sugerido nas respostas do Chat do Copilot.
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 quer 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 tratadas pela ferramenta de análise estática ou pelo 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
-
Em GitHub, acesse a página principal do repositório.
-
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.
-
Na seção “Código e automação” da barra lateral, selecione Copilot e depois Revisão de código.
-
Selecione Criar diretriz.
-
Em “Nome”, dê um nome à diretriz de codificação.
-
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.
-
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 sintaxeFile.fnmatch
, o curinga*
não corresponde aos separadores de diretório (/
). Por exemplo,qa/*
corresponderá a todos os branches que começam comqa/
e que contêm uma barra "/", mas não corresponderá aqa/foo/bar
. Você pode incluir qualquer quantidade de barras "/" apósqa
comqa/**/*
, o que corresponderá, por exemplo, aqa/foo/bar/foobar/hello-world
. Você também pode estender a cadeia de caracteresqa
comqa**/**/*
para tornar a regra mais inclusiva.Para obter mais informações sobre as opções de sintaxe, confira a documentação de fnmatch.
-
Teste a diretriz de codificação para verificar se ela funciona conforme o esperado.
- Selecione Adicionar amostra.
- 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.
- Selecione Salvar para salvar o código de exemplo.
- Teste a diretriz de codificação em relação à amostra pressionando Executar.
-
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