Bot de Revisão de PR do GitHub
Bot de Revisão de PR do GitHub — guia fácil de entender com base na documentação oficial
Imagine ter um colega incansável que revisa cada pull request no momento em que chega — sem pausas para café, sem “deixo para depois”. É exatamente isso que você pode construir com o Hermes Agent.
O Que Vamos Construir
Um bot que monitora seus repositórios no GitHub e revisa automaticamente novos pull requests. Quando alguém abre um PR, o bot entra em ação, verifica o diff e publica feedback — tudo pelo WeChat, para você ver as revisões direto no seu aplicativo de mensagens.
Passo 1: Deixe Seu Gateway do WeChat Pronto
Primeiro, precisamos conectar o Hermes ao WeChat. Isso usa o iLink Bot, que permite receber e enviar mensagens sem precisar rodar um servidor.
# Instale o Hermes Agent
pip install hermes-agent
# Configure o adaptador do WeChat
hermes gateway setup
Você verá um QR code — escaneie com seu WeChat para fazer login. As credenciais são salvas automaticamente.
Passo 2: Configure Seu Bot
Crie um arquivo config.yaml e adicione suas configurações do WeChat:
platforms:
weixin:
extra:
account_id: seu-account-id
dm_policy: open
Agora adicione a integração com o GitHub. Você vai precisar de um token de acesso pessoal do GitHub:
integrations:
github:
token: seu-token-do-github
repos:
- seu-usuario/seu-repositorio
Passo 3: Escreva a Lógica de Revisão
Crie um script simples que dispara em novos PRs:
from hermes import Agent
agent = Agent()
@agent.on("github.pull_request.opened")
async def review_pr(event):
pr = event.pull_request
diff = await pr.get_diff()
# Verificação simples: sinalizar PRs grandes
if len(diff.splitlines()) > 500:
await pr.comment("⚠️ Este PR é bem grande. Considere dividi-lo.")
# Verificar se há testes
if "test" not in diff.lower():
await pr.comment("Atenção: nenhuma alteração de teste detectada.")
Passo 4: Inicie o Gateway
hermes gateway
Pronto! Seu bot já está no ar. Quando alguém abrir um PR, ele automaticamente publica comentários no PR e envia uma notificação para você no WeChat.
Por Que Isso é Incrível
- Sem webhooks ou servidores — o Hermes faz long-polling no GitHub, então não precisa de endpoint público
- Manipulação inteligente de mensagens — revisões longas ficam em um único balão, sem quebras estranhas
- Indicadores de digitação — você vê “digitando…” no WeChat enquanto o bot trabalha
- Retry embutido — erros temporários não derrubam seu bot
Resumo & Dica de Profissional
Você acabou de construir um bot de revisão de PR que funciona pelo WeChat, com zero infraestrutura. Comece simples — sinalize PRs grandes, verifique testes ausentes ou lembre sobre atualizações de changelog.
Dica prática: Comece com apenas uma verificação (como a detecção de testes acima). Rode por uma semana, veja o que seu time realmente precisa e então adicione mais regras. Um bot que faz três coisas bem feitas vence um que tenta fazer tudo e irrita todo mundo.
📖 Documentação oficial
この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › guides/github-pr-review-agent