Como usar o PR Summary
Edvaldo Freitas
Todo mundo já abriu um Pull Request e pensou: “O que mudou aqui afinal?”
O PR Summary da Kody resolve exatamente isso — ele escreve um resumo claro e objetivo das mudanças, sem você precisar gastar tempo descrevendo linha por linha.
Quando configurado direito, ele ajuda seu time a:
- Ganhar contexto mais rápido
- Reduzir idas e vindas nas revisões
- Padronizar a forma como PRs são descritos
Vamos ver como ativar, personalizar e tirar o máximo proveito dessa funcionalidade.
Ative a geração automática de resumos
Se o seu time abre PRs sem descrição ou com textos genéricos do tipo “fix” ou “update”, essa é a configuração que vai salvar vocês.
Para ativar:
- Vá em Configurações → PR Summary
- Ligue a opção Enable Automatic Summary Generation
A partir daí, todo PR já nasce com um resumo escrito pela Kody.
Isso garante que sempre exista uma descrição inicial — mesmo que depois você ajuste manualmente.
💡 Dica: Se o time já escreve boas descrições, mas quer completá-las com contexto adicional, pule para a seção de modos de comportamento.
Escolha como a Kody lida com descrições existentes
Nem todo PR começa do zero. Às vezes o autor já escreve uma descrição, mas você quer que a Kody complemente ou reorganize.
É aí que entram os modos de comportamento:
🔸 Replace (padrão) → Joga fora a descrição original e cria uma do zero. Ideal se o time não tem padrão ou quer uniformizar totalmente o estilo.
🔸 Concatenate → Mantém o que já estava lá e adiciona o resumo da Kody no final. Bom para quando o autor traz contexto humano (ex.: motivo da mudança) e você quer acrescentar um sumário técnico.
🔸 Complement → Mescla os dois textos, mantendo o que já faz sentido e adicionando só informações novas ou relevantes. Ótimo para enriquecer descrições já bem escritas sem deixá-las repetitivas.
💡 Dica prática: Se o seu time já escreve PRs detalhados, mas quer garantir que nada relevante fique de fora, use Complement.
Personalize o foco com instruções
A Kody é boa em escrever resumos, mas fica ainda melhor quando você diz exatamente o que quer.
No campo Custom Instructions, você pode guiar o foco da análise.
Alguns exemplos:
- “Foque em mudanças que afetam performance e segurança.”
- “Liste APIs públicas modificadas e mudanças de schema no banco.”
- “Destaque alterações que afetam o fluxo de checkout.”
Quanto mais claro você for, mais útil será o resultado.
💡 Pro tip: Se o seu time trabalha em áreas distintas (ex.: backend, frontend, data), é uma boa criar instruções diferentes para cada repositório.
Revise com o Preview do PR Summary
Antes de o resumo ir parar na sua ferramenta de git, você pode ver o Preview diretamente na Kodus.
Para isso:
- Vá até a aba de PRs na Kodus
- Clique no PR desejado
- Veja o resumo gerado antes de publicar
Isso é útil para:
- Ajustar o tom e o foco antes que todo mundo leia
- Corrigir eventuais interpretações erradas
- Garantir que as informações críticas estejam lá
O que isso muda no dia a dia
Com o PR Summary configurado, seu time vai gastar menos tempo tentando entender PRs e mais tempo revisando o que realmente importa.
Configure seu PR Summary agora