Pular para o conteúdo principal

​
Modelos de Pull Request

Devin pode usar modelos de pull request no estilo do GitHub. Ele procura no seu repositório pelo primeiro arquivo de modelo correspondente e o utiliza ao gerar ou regenerar a descrição de um PR. Além dos nomes de arquivo padrão do GitHub, o Devin também é compatível com uma variante específica para ele, para que você possa definir para o Devin um modelo diferente daquele que seus autores humanos usam.

​
1. Ordem de descoberta

A primeira correspondência encontrada é utilizada (de cima para baixo): 
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE.md
pull_request_template.md
docs/PULL_REQUEST_TEMPLATE.md
docs/pull_request_template.md
.github/PULL_REQUEST_TEMPLATE.md
.github/pull_request_template.md
As entradas com DEVIN_PR_TEMPLATE.md e devin_pr_template.md são substituições opcionais específicas do Devin (ambas as variantes em maiúsculas e minúsculas são suportadas). Se nenhuma delas existir, serão usados os arquivos padrão PULL_REQUEST_TEMPLATE.md e pull_request_template.md. Se nada corresponder, o Devin recorre à sua estrutura padrão incorporada.

​
2. Template personalizado do Devin (opcional)

Adicione um template exclusivo do Devin criando um dos seguintes: 
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
Use isto se você quiser que o Devin inclua estrutura adicional (por exemplo, dicas para checklists de risco) sem alterar o que as pessoas veem nos seus arquivos PULL_REQUEST_TEMPLATE.md ou pull_request_template.md habituais. As variantes em maiúsculas e minúsculas são aceitas. Se você preferir um único template compartilhado, basta manter (ou adicionar): 
.github/pull_request_template.md
Placeholders e comentários HTML serão removidos automaticamente.

​
3. Padrão interno (se nenhum arquivo for encontrado)

Se nenhum arquivo de modelo existir, Devin usa um padrão interno com seções para:
  • Resumo
  • Checklist de revisão e testes
  • (Opcional) diagrama Mermaid
  • Notas
Você não precisa copiar isso, a menos que queira personalizá-lo; fornecer qualquer um dos arquivos compatíveis listados acima substitui completamente o padrão.

​
4. Referência do GitHub

Devin segue as regras do GitHub para resolução de templates de arquivo único. Para saber mais sobre templates de PR do GitHub (incluindo fluxos de trabalho com vários templates), veja aqui.
Configuração mínima para que o Devin tenha seu próprio template: 
mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [título]\n\n## Resumo\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
Pronto — abra ou regenere o PR e o Devin vai usá-lo.