Apri una pull request con la maggior parte degli strumenti IA di code review e ottieni un muro di commenti. Uno per ogni segnalazione. Uno per ogni piccola imprecisione. Uno per “valuta di estrarre questo in una funzione di supporto.” Fai il push di una correzione, riesegui la review, e ottieni un secondo muro impilato sopra il primo. A questo punto il tuo collega deve scorrere due muri per trovare il commento che conta davvero.
Surmado Code Review funziona diversamente. Una PR, un commento. Riesegui la review e lo stesso commento viene modificato sul posto.
Come funziona
Quando Scout esegue la review di una pull request, ogni segnalazione confluisce in un unico commento strutturato. Le fasce di gravità in alto. I problemi veri e propri sotto. Un breve riepilogo alla fine così il revisore umano sa da dove iniziare a guardare.
Quando fai il push di una correzione e commenti /rerun-review, Scout legge due cose:
- Il nuovo diff.
- La review precedente che ha pubblicato.
Poi modifica lo stesso commento sul posto. I problemi che hai corretto vengono segnati come risolti. Quelli che non hai corretto vengono ri-segnalati con una nota che indica che erano già stati indicati in precedenza. I nuovi problemi del nuovo codice finiscono in fondo.
Il thread di commenti sulla tua PR non cresce. La singola review diventa semplicemente più accurata a ogni push.
Perché è importante
Un thread di commenti su una PR dovrebbe essere una conversazione, non un cartellone pubblicitario. Ogni commento in più che un bot pubblica è un commento che un collega deve scorrere per trovare quello che conta. Dopo qualche ciclo, nessuno legge più nessuno di essi.
È lo stesso compromesso emerso nel nostro approfondimento sulle alternative a CodeRabbit e nella nostra analisi di Greptile. Il tasso di rilevamento non è l’unica metrica. Il rapporto segnale-rumore lo è. Un revisore che rileva tutto ma lo seppellisce in 40 commenti ha lo stesso valore pratico di un revisore che non rileva nulla.
La parte “consapevole di cosa ha detto prima”
Modificare sul posto è una cosa. La parte più difficile è rendere il rerun utile, non solo più breve.
Il rerun di Scout è ancorato alla review precedente. Se al primo passaggio ti ha segnalato che a una funzione mancava la redazione dei dati PII, il rerun controlla specificamente se ora quella funzione redige i dati PII. Non “c’è qualche problema di PII da qualche parte,” ma “la cosa che ho segnalato è stata corretta.” Se sì, quella segnalazione passa a una sezione risolta. Se no, resta aperta con un indicatore che segnala che è la seconda volta che viene evidenziata.
Questo ciclo di feedback è il motivo per cui “un commento” funziona. Il commento porta con sé la propria storia. Non hai bisogno di un thread cronologico di commenti del bot per ricordare cosa è stato segnalato prima. Il commento attuale lo sa già.
Come si presenta in pratica
Fai il push di una PR. Ricevi un commento da Scout, ancorato alle regole del tuo file STANDARDS.MD. Lo leggi. Correggi ciò che conta. Fai di nuovo il push. Commenti /rerun-review. Lo stesso commento si aggiorna con ciò che è risolto, ciò che è ancora aperto e ciò che è nuovo. Nessun thread nuovo. Nessun “sei stato notificato 17 volte.”
Se vuoi la storia più lunga di come è stato costruito lo strumento, il nostro racconto sul vibe coding copre le parti che abbiamo realizzato a mano e quelle che abbiamo lasciato costruire a Scout.
La conclusione
Lo spam di commenti sulle PR non è una funzionalità. È un’abitudine che altri strumenti hanno preso perché pubblicare più commenti è più facile che sapere quali contano davvero.
Surmado Code Review la evita. Un commento. Modificato a ogni rerun. Consapevole di ciò che ha già detto.
Prova Surmado Code Review per $15 al mese. 100 PR. Il tuo STANDARDS.MD. Ogni PR, prima che i tuoi colleghi la aprano.