Bot di Revisione PR GitHub

Immagina di avere un compagno di squadra instancabile che recensisce ogni pull request nel momento esatto in cui arriva—niente pause caffè, niente “lo faccio dopo.” È esattamente ciò che puoi costruire con Hermes Agent.

Cosa Stiamo Costruendo

Un bot che osserva i tuoi repository GitHub e recensisce automaticamente le nuove pull request. Quando qualcuno apre una PR, il bot interviene, controlla il diff e pubblica feedback—il tutto tramite WeChat, così vedi le recensioni direttamente nella tua app di messaggistica.

Passo 1: Prepara il Tuo Gateway WeChat

Prima di tutto, dobbiamo collegare Hermes a WeChat. Questo usa iLink Bot, che ti permette di ricevere e inviare messaggi senza dover gestire un server.

# Installa Hermes Agent
pip install hermes-agent

# Configura l'adattatore WeChat
hermes gateway setup

Vedrai un codice QR—scansionalo con il tuo WeChat per accedere. Le credenziali vengono salvate automaticamente.

Passo 2: Configura il Tuo Bot

Crea un file config.yaml e aggiungi le impostazioni WeChat:

platforms:
  weixin:
    extra:
      account_id: your-account-id
      dm_policy: open

Ora aggiungi l’integrazione GitHub. Ti servirà un personal access token da GitHub:

integrations:
  github:
    token: your-github-token
    repos:
      - your-username/your-repo

Passo 3: Scrivi la Logica di Recensione

Crea uno script semplice che si attiva sulle nuove PR:

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()
    
    # Controllo semplice: segnala PR troppo grandi
    if len(diff.splitlines()) > 500:
        await pr.comment("⚠️ Questa PR è piuttosto grande. Valuta di suddividerla.")
    
    # Controlla se mancano i test
    if "test" not in diff.lower():
        await pr.comment("Attenzione: nessuna modifica ai test rilevata.")

Passo 4: Avvia il Gateway

hermes gateway

Fatto! Il tuo bot è ora attivo. Quando qualcuno apre una PR, pubblica automaticamente commenti sulla PR e ti invia una notifica WeChat.

Perché È Fantastico

• Niente webhook o server—Hermes usa long-polling su GitHub, quindi non serve un endpoint pubblico
• Gestione intelligente dei messaggi—le recensioni lunghe restano in un unico fumetto, senza spezzarsi in modo strano
• Indicatori di digitazione—vedi “sta scrivendo…” su WeChat mentre il bot lavora
• Retry integrato—gli errori transitori non mandano in crash il bot

Riepilogo e Consiglio da Pro

Hai appena costruito un bot per recensioni PR che funziona tramite WeChat, con zero infrastruttura. Inizia semplice—segnala PR grandi, controlla i test mancanti o ricorda di aggiornare il changelog.

Consiglio pratico: Inizia con un solo controllo (come il rilevamento dei test qui sopra). Lascialo girare per una settimana, osserva di cosa ha davvero bisogno il tuo team, poi aggiungi altre regole. Un bot che fa tre cose bene batte uno che prova a fare tutto e infastidisce tutti.