Pular para o conteudo
MODULO 4.5

🤖 Pull Requests e Code Review

Crie PRs com gh CLI, use Claude como reviewer automatizado, integre CI checks e adote best practices para PRs que fazem merge rapido.

6
Topicos
~45
Minutos
4.4
Pre-requisito
Pratico
Tipo
Progresso:0%0 de 6
1

Criar PRs com gh CLI

O Claude Code usa o gh (GitHub CLI) para criar PRs diretamente do terminal. Ele analisa os commits, gera titulo e descricao, e abre o PR com um unico comando. Voce pode pedir: "cria um PR com essas mudancas" e ele faz tudo.

criar-pr.sh
# Claude gera e executa algo como:
gh pr create \
  --title "feat(auth): add JWT refresh token rotation" \
  --body "## Summary
- Add automatic JWT refresh token rotation
- Implement token blacklist for revoked tokens
- Add tests for token refresh flow

## Test plan
- [ ] Run auth test suite
- [ ] Manual test with expired tokens"

Em 1 frase: Claude usa gh pr create para abrir PRs com titulo e descricao gerados automaticamente.

2

Review automatizado

Claude pode atuar como code reviewer: le o diff do PR, identifica problemas de logica, seguranca, performance e estilo, e comenta diretamente. Voce pode pedir "revisa o PR #42" e ele usa gh api para buscar as mudancas e postar comentarios estruturados.

Em 1 frase: Claude le o diff de um PR e posta review comments via gh API.

3

CI checks integration

Antes de fazer merge, o Claude verifica se os CI checks passaram usando gh pr checks. Se algum falhou, ele le o log de falha, identifica o problema e tenta corrigir. Se nao conseguir, reporta o que encontrou e sugere o proximo passo.

ci-checks.sh
# Verificar status dos checks
gh pr checks 42

# Ver log de uma check que falhou
gh run view <run-id> --log-failed

Em 1 frase: Claude verifica CI checks e tenta corrigir falhas antes do merge.

4

Addressing feedback

Quando reviewers humanos deixam comentarios no PR, voce pode pedir ao Claude: "le os comentarios do PR #42 e faz as mudancas pedidas". Ele usa gh api repos/.../pulls/42/comments para ler, entende cada pedido, faz as alteracoes e comita com uma mensagem referenciando o feedback.

Em 1 frase: Claude le review comments e implementa as mudancas pedidas automaticamente.

5

Squash e rebase

Para manter o historico limpo, use squash merge: todos os commits do PR viram um unico commit na main. O Claude tambem pode fazer rebase antes do merge para evitar merge commits. Configure o GitHub para "Squash and merge" como default e o historico fica linear e legivel.

Em 1 frase: squash merge mantem o historico limpo com um commit por PR.

6

Best practices

PRs que fazem merge rapido seguem uma receita: pequenos (menos de 400 linhas), focados (uma unica mudanca logica), bem descritos (titulo claro + body com contexto), e com testes passando. O Claude naturalmente segue essas regras quando voce pede para criar PRs.

checklist-pr.txt
PR que faz merge rapido:
[ ] Menos de 400 linhas de diff
[ ] Uma mudanca logica por PR
[ ] Titulo semantico (feat/fix/refactor)
[ ] Body com Summary + Test Plan
[ ] Todos os CI checks passando
[ ] Sem segredos no diff
[ ] Reviewer atribuido

Em 1 frase: PRs pequenos, focados, bem descritos e com testes verdes fazem merge em minutos.

🧾 Resumo do Modulo

gh pr create — PRs automaticos com titulo e descricao semanticos.
Review automatizado — Claude como code reviewer via gh API.
CI + feedback loop — verifica checks e implementa mudancas pedidas.
PRs pequenos e focados — a receita do merge rapido.

Proximo modulo:

4.6 — CI/CD e GitHub Actions: automatize deploy, testes e seguranca.