Devin Review

​

Funzionalità

​

Per iniziare

• Webapp di Devin — Vai su app.devin.ai/review per vedere le tue PR (pull request) aperte, organizzate per categoria (assegnate a te, create da te, con richiesta di revisione). Quando Devin crea delle PR, vedrai un pulsante arancione “Review” nella chat.
• Commento alla PR — Inserisci il commento /devin review su qualsiasi PR GitHub in un repository connesso dalla tua organizzazione e Devin la esaminerà immediatamente. Vedi Avviare una review da un commento alla PR.
• Scorciatoia tramite URL — Per qualsiasi link a una PR su GitHub.com, sostituisci github.com con devinreview.com nell’URL. Per le PR private, accedi prima a Devin.
• GitHub Enterprise — Incolla l’URL completo della PR nella pagina Devin Review su app.devin.ai/review. Tutte le versioni di GitHub (GitHub.com, Enterprise Server, Enterprise Cloud) hanno le stesse funzionalità.
• Azure DevOps — Incolla l’URL completo della PR (ad esempio https://dev.azure.com/.../pullrequest/..., oppure il tuo host Azure DevOps Server) su app.devin.ai/review dopo aver connesso il repository a Devin.

​

Provider Git supportati

​

Leggere una review

​

Autorizzazioni

​

Governance

​

Controllo dei costi

​

Dashboard dei consumi

• Suddivisione per utente — Mostra quanti ACU di Review ha consumato ciascun utente nel ciclo di fatturazione corrente e in quello precedente.
• Suddivisione per repository — Mostra il consumo di ACU di Review, il numero di review e il numero di bug rilevati per repository nel ciclo di fatturazione corrente e in quello precedente, aiutando a individuare quali repo generano i costi di review più elevati e dove le review rilevano il maggior numero di problemi.

​

Indicatore delle dimensioni della revisione

​

Limite di spesa per la revisione automatica per PR

• Le revisioni manuali continuano a funzionare — il limite mette in pausa solo le revisioni automatiche. Puoi sempre avviare manualmente una revisione dalla pagina di revisione della PR.
• Riattivazione per singola PR — Riattivando la revisione automatica per la PR dal menu delle azioni (tre puntini nell’intestazione), le revisioni automatiche riprendono e quella PR viene esentata dal limite.

​

Azioni del flusso di lavoro delle PR

• Merge — Esegue il merge della PR utilizzando la strategia di merge configurata per il repository (merge commit, squash o rebase). Il pulsante di merge riflette lo stato corrente di merge della PR e i controlli richiesti.
• Close — Chiude la PR senza eseguire il merge. Disponibile nel menu a discesa accanto al pulsante di merge.
• Convert to draft — Converte una PR aperta in bozza. Disponibile nel menu a discesa quando la PR è aperta e non è già una bozza.
• Mark ready for review — Segna una PR in bozza come pronta per la revisione. Per le PR in bozza, nella barra di merge viene visualizzato un pulsante “Ready for review”.
• Auto-merge — Abilita o disabilita l’auto-merge di GitHub dal menu a discesa del pulsante di merge. Quando è abilitato, la PR verrà unita automaticamente non appena tutti i controlli richiesti saranno stati superati. La barra di merge mostra lo stato corrente dell’auto-merge, incluso chi lo ha abilitato.

​

PR impilate

• Pannello della pila — L’intestazione della PR mostra la pila con tutti gli elementi ordinati dal basso verso l’alto, fino al branch di base in cui viene eseguito il merge. Ogni elemento rimanda alla propria pagina di revisione, così puoi esaminare la pila livello per livello.
• Stato di preparazione per livello — Ogni elemento mostra un indicatore di stato che riflette il suo effettivo stato di merge: verde quando può effettivamente essere unito (tenendo conto di CI, revisioni richieste e protezione del branch), rosso in caso di verifiche non superate o conflitti e arancione per qualsiasi altro ostacolo al merge, incluso il caso in cui un livello è pronto singolarmente ma bloccato da una PR non unibile sottostante. Un indicatore aggregato riassume l’intera pila.
• Diff mirati — Ogni PR in una pila viene confrontata con il livello sottostante, quindi ogni revisione, inclusa la revisione automatica e il bug catcher, vede solo le modifiche di quel livello.
• Merge della pila — Le PR impilate vengono unite tramite il merge atomico delle pile di GitHub: il merge di una PR unisce anche tutte le PR aperte sottostanti nella pila, dal basso verso l’alto, in un’unica operazione. Il pulsante di merge mostra esattamente quante PR verranno integrate dall’azione e GitHub reindirizza poi le PR rimanenti al branch di base.

​

Revisione automatica

​

Quando viene eseguita la revisione automatica?

• Viene aperta una PR (non in bozza)
• Vengono effettuati nuovi commit su una PR
• Una PR in bozza viene contrassegnata come pronta per la revisione

​

Modalità di attivazione

• Revisione automatica (predefinita) — Le revisioni si attivano per tutti gli eventi: apertura della PR, push di nuovi commit e bozza contrassegnata come pronta.
• Alla creazione della PR — Le revisioni si attivano solo quando una PR viene aperta per la prima volta o quando una PR in bozza viene contrassegnata come pronta per la revisione. I push successivi alla PR non attivano una nuova revisione.
• Manuale — Nessuna revisione viene eseguita automaticamente. Puoi avviare tu una revisione dalla pagina di revisione della PR ogni volta che lo desideri. Questo è il livello base dell’iscrizione personale.

​

Autoiscrizione (Tutti gli utenti)

1. Vai a Settings > Preferences
2. In Devin Review, imposta Review trigger su alla creazione della PR o revisione automatica (lascialo su manuale se vuoi attivare le review solo manualmente)

​

Lingua dei commenti della review

• Usa la lingua di visualizzazione (predefinita) — I commenti della review useranno la lingua di visualizzazione impostata.
• Lingua specifica — Scegli tra inglese, spagnolo, portoghese, giapponese, cinese, coreano, francese, tedesco, russo, arabo, ebraico o indonesiano.

​

Configurazione dell’amministratore

• Repositories — Aggiungi repository per eseguire la revisione automatica di TUTTE le PR in quel repository. Usa il pulsante Add repo per cercare e selezionare tra i repository collegati e imposta la modalità di attivazione di ciascun repository dall’elenco.
• Users — Visualizza tutti gli utenti iscritti dell’intera organizzazione insieme alla modalità di attivazione di ciascun utente. Gli utenti si iscrivono autonomamente tramite autoiscrizione; gli amministratori non possono iscrivere direttamente altri utenti.
• Add “Devin Review” link in PR description — Quando è attivata (impostazione predefinita), Devin aggiunge un link alla revisione nella descrizione della PR.

​

Pubblicazione su GitHub

• Post GitHub CI checks — Quando è attivata (impostazione predefinita), Devin crea un controllo dello stato del commit sulla PR per ogni revisione. Questo ti consente di vedere i risultati della revisione direttamente nell’elenco dei controlli della PR.
• Bugs — Pubblica i bug (probabili errori o comportamenti non corretti) come commenti alla PR.
• Sicurezza — Pubblica le vulnerabilità di sicurezza e i suggerimenti di hardening come commenti alla PR.
• Flags (investigate) — Pubblica i flag di indagine (potenziali problemi che meritano un esame più approfondito) come commenti alla PR.
• Flags (note) — Pubblica i flag informativi (osservazioni che potrebbero non richiedere alcuna azione) come commenti alla PR.

​

Bug Catcher

​

Bug

• Grave — Problemi ad alta probabilità che richiedono attenzione immediata
• Non grave — Problemi di gravità inferiore che dovrebbero comunque essere rivisti

​

Flag

• Da esaminare — Il Bug Catcher ha individuato qualcosa che richiede la tua attenzione. Dovresti rivedere direttamente il codice contrassegnato e verificare se si tratta effettivamente di un bug o di un problema.
• Informativo — Il Bug Catcher ha stabilito che qualcosa è corretto oppure sta spiegando come funziona. Questi flag ti aiutano a comprendere le modifiche al codice senza richiedere alcun intervento.

​

Sicurezza

• Injection (SQL, XSS, command, template)
• Difetti di autenticazione (controllo degli accessi assente/difettoso, escalation dei privilegi, bypass dell’autenticazione)
• Esposizione di secret (chiavi hardcoded, token nei log, credenziali nel codice sorgente)
• SSRF e path traversal
• Deserializzazione non sicura, prototype pollution
• Mancata validazione degli input su dati non attendibili
• Crittografia debole (algoritmi, gestione delle chiavi)
• Sicurezza di transport/cookie (mancato uso obbligatorio di HTTPS, CORS permissivo, flag dei cookie non sicuri)
• Impostazioni predefinite non sicure o configurazioni errate introdotte dalla PR

• Critico — Vulnerabilità rilevate con alta attendibilità che devono essere corrette prima del merge
• Avviso — Potenziali debolezze di sicurezza che vale la pena analizzare

​

Risoluzione dei rilievi

​

Azioni di revisione

​

Avviare una review da un commento alla PR

• Commenta esattamente /devin review all’inizio del commento. Il comando non distingue tra maiuscole e minuscole e funziona sia nei commenti della conversazione della PR sia nei commenti della review inline.
• È richiesto l’accesso in scrittura: chi commenta deve disporre dell’autorizzazione write o admin sul repository e il proprio account GitHub deve essere collegato al proprio account Devin. I collaboratori esterni non possono attivare le review.
• Solo PR aperte: i commenti su PR chiuse o sottoposte a merge vengono ignorati.
• Solo GitHub: inclusi GitHub Enterprise Server e Enterprise Cloud. GitLab supporta la revisione automatica, ma non l’attivazione tramite commento.

​

Avviare una revisione

​

Risoluzione dei commenti

​

Indicatori del proprietario del codice

​

Correzione automatica

​

Come abilitarla

1. Dalla barra laterale di revisione — In qualsiasi PR creata da Devin, la barra laterale Analysis mostra una sezione correzione automatica con un pulsante Enable correzione automatica. Facendo clic su di esso, abiliti la correzione automatica per tutte le PR di Devin nella tua organizzazione. Ciò richiede autorizzazioni di amministratore dell’organizzazione.
2. Dalle impostazioni globali di Devin — Vai a Settings > Devin > Pull requests > Responding to bots, quindi:
   • imposta la modalità su Selected only e aggiungi devin-ai-integration[bot] alla allowlist, oppure
   • imposta la modalità su All bots.

​

Risultati sulle PR aperte da Devin

1. La PR mostra lo stato Devin is addressing Devin Review findings.
2. Se Auto-fix review findings è attivo, la sessione corregge ciò che può. Se è disattivato, la sessione riceve solo una notifica e riporta l’esito.
3. Vengono pubblicati come commenti della review solo i risultati che Devin non è riuscito a correggere, mentre lo stato elenca ciò che è stato corretto.

​

Autorizzazioni e vincoli

• Solo gli amministratori dell’organizzazione possono modificare questa impostazione.
• Se la modalità bot è impostata su Tutti i bot, correzione automatica risulta attivato e non può essere modificato dalla barra laterale della revisione. Usa le impostazioni di personalizzazione per modificare la modalità bot.
• I commenti riepilogativi No Issues Found di Devin Review vengono sempre ignorati. Solo i commenti con effettive segnalazioni attivano correzione automatica.

​

Attribuzione di commit e commenti

• Le segnalazioni di bug, i flag e le annotazioni automatizzate compaiono sempre come Devin bot.
• Quando un utente scrive un commento o una revisione tramite Devin Review, questo appare con l’identità GitHub dell’utente.
• Quando un utente chiede all’agente di chat di effettuare una modifica al codice, il commit risultante viene eseguito come Devin bot.
• Le GitHub Suggested Changes seguono il comportamento standard di GitHub: qualsiasi revisore (incluso Devin) può lasciare una modifica suggerita in un commento di revisione. Quando un utente fa clic su “Apply suggestion”, il commit è attribuito a quell’utente, così come avviene in GitHub.
• Devin non creerà mai commit o commenti per conto di un utente senza che l’utente avvii esplicitamente l’azione.

​

AGENTS.md / File di istruzioni

• **/REVIEW.md
• **/AGENTS.md
• **/CLAUDE.md (senza distinzione tra maiuscole e minuscole)
• **/CONTRIBUTING.md (senza distinzione tra maiuscole e minuscole)
• .cursorrules
• .windsurfrules
• .cursor/rules
• *.rules
• *.mdc
• .coderabbit.yaml / .coderabbit.yml
• greptile.json

​

Regole di revisione personalizzate

1. Vai a Settings > Review
2. In Review Rules, inserisci un pattern glob per i file (ad es. docs/**/*.md)
3. Fai clic su Add

​

REVIEW.md

• Aree della codebase che richiedono un controllo più approfondito
• Trappole comuni o anti-pattern da tenere d’occhio
• Convenzioni specifiche del progetto che i revisori devono far rispettare
• File o directory che possono essere tranquillamente ignorati durante la revisione
• Considerazioni di sicurezza o di prestazioni specifiche per il tuo progetto

# Review Guidelines

## Critical Areas
- All changes to `src/auth/` must be reviewed for security implications.
- Database migration files should be checked for backward compatibility.

## Conventions
- API endpoints must include input validation and proper error handling.
- All public functions require TypeScript return types — do not use `any`.
- React components should use functional components with hooks, not class components.

## Ignore
- Auto-generated files in `src/generated/` do not need review.
- Lock files (package-lock.json, yarn.lock) can be skipped unless dependencies changed.

## Performance
- Flag any database queries inside loops.
- Watch for N+1 query patterns in API resolvers.