agentkitco/agentkit-dev-skills

Escreva um título e uma descrição de pull request a partir do diff e dos commits reais, com o que mudou, por que, como foi testado e o que revisar. Use quando for solicitado a escrever ou melhorar uma descrição de PR.

O que é agentkit-dev-skills?

Esta skill (agente) é projetada para gerar descrições de Pull Request (PR) úteis e acionáveis a partir do diff real e do histórico de commits. Ela vai além de uma simples listagem de arquivos alterados, focando em produzir um resumo que permita a um revisor entender rapidamente o que mudou, por que mudou, como foi testado e quais partes merecem atenção especial. A skill extrai automaticamente a branch base, os commits e as estatísticas do diff, analisa o código alterado em busca de motivações (como issues vinculadas ou comentários no código), verifica a existência de arquivos de teste e comandos executados pelo usuário, e, se disponível, preenche um template de PR do repositório. O resultado é uma estrutura padronizada com seções de por que, o que mudou, como revisar, teste e rollout, garantindo que nenhuma informação crítica seja omitida. É ideal para desenvolvedores que usam plataformas como Claude Code, Cursor, Codex, ou qualquer assistente de IA focado em engenharia de software, pois automatiza uma tarefa repetitiva e propensa a erros, economizando tempo e melhorando a qualidade da comunicação em projetos colaborativos.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/agentkitco/agentkit-dev-skills/tree/HEAD/skills/pr-description

Documentação

Escreva uma descrição de PR que um revisor possa usar

Objetivo: permitir que um revisor decida em dois minutos o que olhar, e que um futuro leitor entenda por que a mudança existe.

Coletar

Encontre a branch base e execute git log --oneline <base>..HEAD e git diff --stat <base>...HEAD, depois leia o diff.
Procure pelo motivo: número de issue ou ticket vinculado nos commits ou no nome da branch, a solicitação do usuário, comentários adicionados no diff. Se o motivo não estiver em nenhum desses lugares, pergunte ao usuário; não invente uma motivação.
Verifique o que foi testado: arquivos de teste no diff e comandos que o usuário executou. Se os testes não foram executados, diga isso claramente.
Procure por um .github/pull_request_template.md ou PULL_REQUEST_TEMPLATE. Se existir um, preencha-o em vez de usar a estrutura abaixo.

Estrutura

<Título: imperativo, menos de 70 caracteres, nomeia a mudança de comportamento, não os arquivos>

## Por que
<O problema ou solicitação, em 1 a 3 frases. Vincule a issue se houver uma.>

## O que mudou
- <Itens de nível de comportamento agrupados por área, não uma lista de arquivos.>

## Como revisar
- Comece por <arquivo ou área>; o restante flui a partir daí.
- Parte arriscada: <a parte com maior probabilidade de estar errada e por que>.
- Não alterado propositalmente: <qualquer coisa que um revisor pode esperar e não encontrará>.

## Testes
- <Comandos exatos executados e resultados.>
- <Passos manuais e o que foi observado. "Não testado: ..." se aplicável.>

## Rollout / risco
<Migrações, configuração, feature flags, compatibilidade, como reverter. "Nenhum" somente se for verdade.>

Regras

Descreva o que o diff faz, não o que você gostaria que ele fizesse. Releia o diff após rascunhar e remova qualquer afirmação que ele não suporte.
Não liste todos os arquivos. Liste mudanças de comportamento, nova configuração, novas dependências e código removido.
Sem enrolação ("Este PR tem como objetivo..."). Sem emojis, a menos que o repositório os use.
Capturas de tela ou exemplos de saída: diga onde um ajudaria; nunca descreva uma captura de tela que você não viu.
Produza o título e o corpo em um bloco de código para que possam ser copiados. Não execute gh pr create a menos que seja solicitado.