Eseguire la revisione di una pull request
Avviare una revisione da un commento alla PR
- In una pull request GitHub o in una merge request GitLab aperta, pubblica un nuovo commento:
/devin review. - Segui il collegamento nella risposta di Devin. Leggi la panoramica, quindi apri un gruppo di modifiche correlate per capire come si collegano tra loro.
- Nella Barra laterale di analisi o nella vista Bug, seleziona un risultato e confrontalo con il codice. Se ti serve più contesto, citalo nella chat. Puoi correggere il codice tu stesso oppure chiedere a Devin di apportare una modifica.
/devin review richiede un’analisi. Un commento come /devin fix the failing test, invece, chiede a una sessione Devin di lavorare sulla PR. Consulta Avvia Devin da un commento alla PR per GitHub e Avvia Devin da un commento sulla MR per GitLab.
Altri modi per aprire una revisione
- Da Devin: apri Devin Review e scegli una PR di cui sei autore, che ti è stata assegnata o per cui ti è stata chiesta una revisione. Puoi anche incollare l’URL di una PR nel campo del collegamento alla PR, anche per GitHub Enterprise o Azure DevOps. Per una PR di GitHub.com puoi omettere
https://oppure usareowner/repo#123. - Da GitHub.com: sostituisci
github.comcondevinreview.comnell’URL della PR. Puoi visualizzare una PR pubblica anche senza un account Devin. Per una PR privata, accedi con un account che abbia i permessi di accesso. - Da una sessione Devin: seleziona Analyze sulla scheda della PR. Se la scheda offre sia Analyze once sia Analyze, scegli Analyze once per una revisione singola. Analyze abilita anche le revisioni sui push successivi a questa PR.
Cmd-clic o Ctrl-clic, invece, la PR si apre in una nuova scheda del browser.
Nell’elenco, premi j o k per selezionare la PR successiva o precedente, o o l per aprirla nel pannello oppure Enter per aprirne la pagina di revisione completa. Se la PR lo consente, a la approva e passa alla PR successiva, mentre m esegue il merge o aggiunge la PR alla coda e passa alla successiva. Queste scorciatoie dell’elenco sono diverse dalle scorciatoie della pagina della PR.
Devin Review in azione
Leggere una revisione
Inizia dalla panoramica per capire quale comportamento modifica la PR. Nella Guide view, leggi il diff per gruppo: un gruppo può riunire modifiche correlate provenienti da file diversi. Quando Devin rileva codice copiato o spostato, mostra lo spostamento anziché una rimozione seguita da un’aggiunta identica. I risultati del Rilevatore di Bug compaiono nella barra laterale di analisi o nella vista Bug. Fai domande sulla PR nella chat e ottieni risposte con il contesto pertinente dal resto della codebase; puoi anche interpellare Devin direttamente da qualsiasi commento, bug o segnalazione nella vista diff. Su dispositivi mobili, la revisione si apre sulla scheda Changes. Passa a Bug per vedere bug, segnalazioni e risultati dell’analisi di sicurezza, oppure usa Description, Discussion e Commits per gli altri dettagli della PR. Quando un collegamento a un commento o a una revisione di GitHub viene aperto in Devin Review, la pagina scorre fino all’elemento di destinazione e lo evidenzia. Lo stesso vale per la scheda della revisione all’interno di una sessione Devin, dove un collegamento GitHub a un file nel diff della PR apre direttamente quel file. Quando vengono inviati nuovi commit dopo l’ultima revisione e nessuna regola li prende in carico, un banner Devin hasn’t analyzed the latest changes indica l’ultimo commit revisionato e quanti sono i nuovi commit. Analyze latest esegue un’ulteriore revisione del commit attuale senza attivare l’auto-review; Analyze automatically la attiva per questa pull request, per tutte le pull request che apri oppure, se puoi gestire le Review settings del repository, per tutte le pull request del repository. Nella scheda della revisione all’interno di una sessione Devin, See changes mostra le modifiche inviate dall’ultima revisione. Quando è disponibile una revisione più recente, New commit passa a un commit inviato mentre la revisione era aperta, View latest commit passa a un diff più recente per un commit che Review conosceva già e New analysis aggiorna l’analisi senza cambiare il commit visualizzato.Navigare tra le modifiche e la cronologia delle revisioni
- Contrassegna i file come Viewed per monitorare i tuoi progressi, oppure contrassegna tutti i file come visualizzati o non visualizzati dall’elenco dei file.
- Espandi le righe di contesto attorno a una modifica, oppure usa Expand all lines nell’intestazione di un file per mostrare l’intero file e Collapse expanded lines per richiuderlo. Per i file Markdown puoi passare dal diff renderizzato al sorgente e viceversa.
- Seleziona le righe sul lato nuovo di un diff per usare Add to Chat, oppure scegli Suggest change per aprire un commento della review su quelle righe, precompilato con un blocco di suggerimento che ne contiene il testo attuale.
- Nascondi le modifiche che riguardano solo gli spazi bianchi per concentrarti su quelle sostanziali.
- Per impostazione predefinita, i conteggi delle righe nell’intestazione della PR e nell’elenco Review escludono i test e il codice generato. Passa il mouse su un conteggio per vederne la suddivisione per categoria e, da lì, scegli Relevant, Both o Full per cambiare il conteggio mostrato. Facendo clic sul conteggio si passa ciclicamente tra le stesse tre visualizzazioni. La tua scelta si applica in entrambi i punti.
- Premi
Cmd+FoCtrl+Fper cercare nella revisione. L’icona del filtro nel campo di ricerca offre le opzioni Match case, Changed lines only e Skip collapsed files. Per impostazione predefinita, la ricerca ignora il contenuto dei file chiusi, indipendentemente dal fatto che siano contrassegnati come visualizzati. I nomi di file e cartelle rientrano comunque nei risultati. - Usa Analysis history nel menu delle azioni dell’intestazione per esaminare un’analisi precedente. In Select commits to view puoi invertire l’ordine dei commit revisionati. Su GitHub, il selettore mostra anche le approvazioni e le richieste di modifica associate a quei commit. Un collegamento bloccato su un commit meno recente non mostra automaticamente i risultati più recenti; usa Switch to latest o Run analysis on latest, se disponibili.
- Consulta la vista Checks per lo stato della CI. Con i fornitori che lo supportano, puoi gestire revisori, etichette e assegnatari senza uscire da Review.
- Il menu delle impostazioni del diff include l’opzione Layout: File tree view mostra i diff non raggruppati insieme all’albero dei file, mentre Guide view raggruppa le modifiche correlate e ne fornisce una spiegazione.
File generati e limiti di dimensione del diff
I file contrassegnati comelinguist-generated nel file .gitattributes alla root del tuo repository Git non vengono conteggiati nel limite di dimensione del diff di Devin Review. La revisione mostra il numero di righe aggiunte ed eliminate, ma non analizza le modifiche in quei file.
Devin Review legge .gitattributes dal commit di head della PR, quindi una regola aggiunta in una PR si applica alla revisione di quella stessa PR. I revisori personalizzati e Autoapprover rispettano solo le regole già presenti nella merge base (l’antenato comune usato per il diff della PR), quindi una PR non può escludere i propri file dalla loro analisi. Ad esempio, per contrassegnare come generati i file in src/generated/, aggiungi questa regola al file .gitattributes alla root:
Rilevatore di Bug
Il Rilevatore di Bug analizza la tua pull request (PR) alla ricerca di potenziali problemi. I risultati includono Bug, Segnalazioni e Sicurezza. I revisori personalizzati in beta generano risultati propri, attribuiti a ciascun revisore. Se la PR è stata aperta da una sessione Devin per correggere un problema rilevato dalla scansione del codice, la revisione integrata include una scheda separata Finding o Findings dedicata ai risultati collegati. Se hai accesso ai risultati, la scheda è visibile nel pannello Review o Inbox e nella scheda PR della sessione.Bug
Devin contrassegna come bug i probabili errori. Esamina per primi i bug gravi, contrassegnati da un’icona rossa a forma di insetto. I bug meno gravi sono indicati da un’icona di avviso arancione. Se disponibile, espandi Learn more per visualizzare lo scenario di errore e la soluzione consigliata. Il pulsante di copia copia la posizione, la spiegazione ed eventuali modifiche suggerite.Segnalazioni
Una segnalazione Da approfondire solleva un dubbio sul codice: verifica le righe segnalate prima di decidere se sia necessaria una soluzione. Una segnalazione Informativo spiega una modifica senza richiedere alcuna correzione da parte tua.Sicurezza
Devin Review esegue una scansione delle vulnerabilità di sicurezza e le mostra insieme agli altri risultati. La scansione di sicurezza fa parte di una revisione completa; usa le impostazioni di pubblicazione per controllare se i risultati dell’analisi di sicurezza vengono pubblicati come commenti alla PR. Un’analisi limitata al solo diff, ad esempio quando la revisione automatica è sospesa a causa di un limite di spesa, non costituisce una revisione di sicurezza completa. Lo scanner verifica le seguenti categorie di vulnerabilità:- 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
REVIEW.md per orientare ciò che lo scanner cerca.
Se è disponibile il contesto sul modello di sicurezza del repository, la revisione integrata e i revisori personalizzati contrassegnati come Security-related leggono anche SECURITY_MODEL.md, THREAT_MODEL.md e le sezioni di SECURITY.md dedicate al modello di minaccia o di sicurezza presenti nella directory radice del repository.
Cosa succede al push successivo?
Quando Devin esamina un nuovo push su una PR che ha già revisionato, di solito cerca i bug introdotti o influenzati dalle modifiche apportate dopo l’ultima revisione. Mantiene i risultati precedenti e verifica se i nuovi commit li hanno risolti. Se i nuovi commit cambiano in modo sostanziale il comportamento della PR, oppure se il nuovo diff è troppo grande per una revisione incrementale, Devin può revisionare di nuovo l’intera PR. Il limite di spesa di auto-review per PR si applica all’insieme delle revisioni, non a ogni singolo push. Al raggiungimento di questo limite, le successive revisioni automatiche sulla PR vengono sospese, mentre quelle manuali restano disponibili.Lingua dei commenti della revisione
Puoi scegliere la lingua che Devin Review usa per i commenti e l’analisi da Impostazioni > Preferenze, nella sezione Devin Review.- Segui la lingua di visualizzazione (predefinita) — I commenti della revisione useranno la lingua di visualizzazione impostata.
- Una lingua specifica — Scegli una lingua dal menu a discesa Comment language per usarla nei commenti della revisione al posto della lingua di visualizzazione.
Intervenire su una revisione
Risolvere i risultati
La scheda Bug elenca i risultati in base a ciò che resta da fare:- Needs your attention — Risultati aperti di cui devi eseguire il triage.
- Devin is fixing — Risultati su cui sta lavorando la sessione Devin della PR. Vedi Correzione automatica.
- Fixed — Risultati chiusi come corretti, da te o da Devin.
- Invalidated — Risultati chiusi perché non richiedono correzioni, da te o da Devin.
Commenti e revisioni
Su GitHub puoi lasciare commenti, approvare la PR o richiedere modifiche da Devin Review. Per gli altri host, verifica il riferimento ai provider.Avviare una revisione
Quando scrivi un commento top-level, un nuovo commento inline o una risposta a un thread esistente, il pulsante di invio offre due azioni: Start a review raggruppa i tuoi commenti in una revisione in sospeso anziché pubblicarli uno alla volta, mentre Comment li pubblica subito. Devin Review ricorda l’ultima azione scelta e la imposta come predefinita, anche per la scorciatoia da tastieraCmd+Enter o Ctrl+Enter. Quando una revisione è in corso, il pulsante diventa Add to review e i commenti successivi vengono aggiunti alla revisione finché non la invii. Si tratta della tua revisione per l’autore, non di una richiesta di nuova analisi a Devin.
Risoluzione dei commenti
Risolvi un thread di discussione dopo averlo gestito. Su GitHub, Devin comprime una revisione creata da un bot quando tutti i suoi thread sono stati risolti e la mostra di nuovo se un thread viene riaperto.Indicatori dei code owner
Un’icona a forma di scudo accanto a un revisore nella barra laterale indica che la sua revisione è stata richiesta in qualità di code owner.Modifiche al codice dalla chat
Chiedi all’agente della chat di apportare modifiche al codice. Rivedi le modifiche suggerite, quindi applicale come commit al branch della PR senza lasciare Devin Review. Questa funzionalità è diversa dalla Correzione automatica, che usa una sessione Devin per risolvere i risultati.Azioni del flusso di lavoro delle PR
Devin Review ti consente di agire sulle PR direttamente dalla pagina di revisione, senza dover passare a GitHub.- Merge — Esegue il merge della PR con qualsiasi metodo di merge consentito dal repository (merge commit, squash o rebase). Se ne è consentito più di uno, sceglilo dal menu a discesa del pulsante di merge; Devin Review memorizza nel tuo browser l’ultima scelta effettuata per quel repository e quel branch di base. 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”; il relativo menu offre anche Review draft, che avvia una revisione senza segnare la PR come pronta.
- 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.
Scorciatoie da tastiera
m e n agiscono immediatamente, come i pulsanti corrispondenti: m, quindi, esegue il merge senza chiedere conferma. Per modificare un’associazione, vai a Settings > Keyboard shortcuts.
PR impilate
Devin Review considera le PR impilate elementi di primo livello. Quando una PR fa parte di una pila, la pagina di revisione mostra l’intera serie e gestisce correttamente il merge:- 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. L’opzione Reverse stack order accanto al conteggio della pila elenca invece per primo il branch di base, e la tua scelta viene memorizzata.
- 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 controlli non superati 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 l’auto-review e il Rilevatore di Bug, 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.
- Auto-merge — Puoi abilitare l’Auto-merge di GitHub su una PR impilata. Quando la pila è pronta, GitHub esegue il merge della PR e di tutte le PR sottostanti non ancora unite.
Attribuzione di commit e commenti
- I risultati relativi ai bug, le segnalazioni 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 della review. Applicare un suggerimento è un’operazione distinta dall’avvio di una sessione di Correzione automatica.
- Devin non creerà mai commit o commenti per conto di un utente senza che l’utente avvii esplicitamente l’azione.
Correzione automatica
La Correzione automatica usa una sessione Devin per risolvere i risultati emersi dalla revisione di una PR. È una funzione diversa dall’applicazione di una singola modifica suggerita o dalla richiesta all’agente della chat di Review di preparare un commit.Come abilitarla
Per una PR già gestita da una sessione Devin, la Correzione automatica segue l’impostazione Automatically fix Devin Review findings: “Devin will automatically triage the findings and decide whether to fix, validate, or escalate them to you.” Prevede un’impostazione predefinita dell’organizzazione e una scelta personale:- Per l’organizzazione: gli Amministratori dell’organizzazione la attivano o disattivano in Settings > Devin, nella sezione Pull requests. Come indicato nella riga, “This option configures the default for all users.” Gli altri membri non possono modificarla. In un account Enterprise, ogni organizzazione ha la propria impostazione predefinita.
- Per te: attivala o disattivala per le PR delle tue sessioni in Impostazioni > Preferenze, nella sezione sessioni Devin. Finché non la modifichi, l’interruttore riflette l’impostazione predefinita dell’organizzazione. Se la tua scelta è diversa da quella predefinita, compare un pulsante Reset to organization default, con una spiegazione al passaggio del mouse; per tornare a seguire l’organizzazione, fai clic sul pulsante oppure riporta l’interruttore al valore dell’organizzazione. La tua scelta prevale in entrambi i sensi, anche quando la attivi in un’organizzazione in cui l’impostazione predefinita è disattivata.
Correzione automatica con Devin attiva anche Automatically fix Devin Review findings
per te, se è disattivata.
Risultati sulle PR di Devin
Una sessione idonea che ha aperto la PR prende in carico i nuovi risultati prima che vengano pubblicati singolarmente. Su GitHub:- La PR mostra lo stato Devin is fixing per i risultati, che vengono spostati in Devin is fixing nella scheda Bug.
- Se l’opzione Automatically fix Devin Review findings è attivata per il proprietario della sessione e il monitoraggio della PR è attivo, la sessione corregge ciò che può e registra una decisione per ciascun risultato.
- Devin pubblica un’unica revisione che riepiloga le correzioni apportate, con i dettagli nella sezione Fixed by Devin. I risultati che restano da gestire a te vengono pubblicati come commenti della revisione, in base alle tue impostazioni di pubblicazione. I risultati invalidati da Devin non vengono pubblicati.
Autorizzazioni e vincoli
- Per modificare l’impostazione predefinita dell’organizzazione per Automatically fix Devin Review risultati sono necessarie le autorizzazioni di amministratore dell’organizzazione. Per le proprie sessioni, la scelta di ciascun membro prevale sull’impostazione predefinita.
- Responding to bots in Settings > Devin > Pull requests continua a regolare i commenti degli altri bot, ma non controlla più la correzione automatica.
- I commenti riepilogativi No Issues Found di Devin Review vengono sempre ignorati. Solo i commenti con effettivi risultati attivano correzione automatica.
Se Automatically fix Devin Review risultati è disattivato quando Devin Review pubblica dei risultati, vedrai un messaggio nella timeline della sessione che ti invita ad abilitarlo.
Revisione automatica
Per revisionare le PR di cui sei autore, usa le tue preferenze personali. Per revisionare le PR del tuo team, aggiungi una regola nelle impostazioni di revisione. In entrambi i casi, il repository deve essere connesso a Devin, anche se è pubblico.I nuovi account includono una regola a livello di account che revisiona le PR aperte dalle sessioni di Devin
quando sono pronte e a ogni push. Inoltre, Automatically fix Devin
Review findings è attivo per impostazione predefinita, quindi quelle sessioni correggono i
risultati. Puoi modificare o rimuovere la regola nelle impostazioni di revisione. Gli account
Non-Enterprise esistenti con una sola organizzazione hanno ricevuto la stessa regola e la stessa
impostazione, a meno che un amministratore non avesse disattivato l’impostazione o rimosso la regola. In
tutte le altre organizzazioni esistenti le regole restano invariate e l’impostazione
è attiva solo dove Risposta ai bot consentiva già a Devin di intervenire sui commenti di Devin
Review.
Modalità di attivazione
Scegli quando si avvia una regola:- PR is created — Quando la PR viene aperta, anche come bozza.
- PR is ready — Quando la PR viene aperta già pronta o viene contrassegnata come pronta.
- Only once — Una sola revisione quando vengono soddisfatte le condizioni di attivazione.
- Every push — Nuova revisione a ogni push successivo. Richiede il tier completo di utilizzo per la revisione automatica. Quando si usano i diritti di accesso ai repository, una regola di repository rende disponibile Every push se un’organizzazione che ti concede l’accesso in modifica a quel repository consente a sua volta Every push, anche se stai visualizzando Settings da un’altra organizzazione. Consulta Cosa succede al push successivo? per sapere cosa copre una revisione successiva.
Autoiscrizione (tutti gli utenti)
Quando l’iscrizione personale è abilitata per il tuo account, gli utenti con un’identità del provider Git collegata e il tier di utilizzo di Review appropriato possono iscriversi autonomamente senza autorizzazioni di amministratore.- Vai su Impostazioni > Preferenze.
- In Devin Review, imposta Analysis trigger su Analyze PRs automatically when opened o Analyze PRs automatically when ready for review.
- Imposta Analysis frequency su Only once o Every push, se le tue autorizzazioni lo consentono.
Regole con ambito ed esclusioni
I responsabili delle revisioni configurano le regole di revisione automatica nella scheda Review di Impostazioni > Revisione. La pagina include anche le schede Sicurezza, revisori personalizzati, Autoapprover e fatturazione; la scheda Sicurezza è visibile ai responsabili delle revisioni dell’account. Apri il menu di aggiunta sotto Automatic analysis (Add repositories or users quando l’elenco è vuoto, Add repository in seguito) e scegli a cosa si applica la regola: Add GitHub organization, Add GitLab group, Add Azure DevOps project, Add Bitbucket workspace o Add Bitbucket project per tutti i repository di quel namespace; Add single repository per un singolo repository; Add user per tutte le PR create da un membro dell’account; oppure Add advanced rule per combinare più condizioni. Nella finestra di dialogo della regola, scegli come destinazione un Repository o un’Organization, quindi restringila con le condizioni:
is e is not confrontano il testo esatto; scegli matches o does not match per usare un pattern glob nelle condizioni su repository, titolo, branch e file modificati. Scegli poi l’evento di avvio e la cadenza della regola. Il livello di approfondimento dell’analisi della regola può usare il valore predefinito dell’account oppure sostituirlo con Normal o Ultra.
Per le regole automatiche con una condizione Originated by Devin, il tier di utilizzo della persona che ha avviato la sessione Devin determina quando la condizione può trovare corrispondenza. Un tier limitato alla creazione consente la prima revisione idonea, ma non le revisioni sui push successivi; un tier solo manuale o l’assenza dell’autorizzazione Review impediscono alla condizione di trovare corrispondenza.
Usa le esclusioni per le PR che la funzionalità non deve elaborare. Le esclusioni corrispondenti hanno la precedenza sulle regole di iscrizione.
Quando un’esclusione blocca l’auto-review su una PR, espandi Automatic analysis skipped by an exception per visualizzare le regole corrispondenti a cui hai accesso. Puoi comunque eseguire una revisione una tantum; i push successivi restano esclusi.
La revisione automatica, ciascun revisore personalizzato e Autoapprover hanno regole distinte. Abilitare la normale revisione automatica non abilita Autoapprover né un revisore personalizzato privo di regole corrispondenti. Un’esclusione di Autoapprover non disabilita la normale revisione automatica.
Le regole sostituiscono i precedenti elenchi di iscrizione per repository e personali. Le vecchie voci di iscrizione legacy non avviano più revisioni: configura al loro posto le regole corrispondenti.
In Git provider interaction, i responsabili delle revisioni dell’account possono anche disattivare Let Devin Review edit the PR description (attiva per impostazione predefinita), che aggiunge un collegamento e lo stato della revisione alla descrizione della PR. Se l’opzione è disattivata, la descrizione resta invariata e, su GitHub, il collegamento e lo stato compaiono invece in un unico commento alla PR.
Pubblicazione su GitHub
I responsabili delle revisioni a livello di account possono configurare cosa Devin pubblica sul Provider Git collegato da Impostazioni > Revisione. La sezione Post findings to, che prende il nome dai provider collegati, consente di scegliere quali tipi di risultato vengono pubblicati come commenti: bug e segnalazioni nella scheda Review e risultati dell’analisi di sicurezza nella scheda Sicurezza. Git provider interaction, nella scheda Review, contiene i toggle per il Controllo CI e per il collegamento nella descrizione della PR:- Post Controllo CI — Quando è attivata (impostazione predefinita), Devin crea uno stato del commit
Devin Reviewsui provider supportati per ogni revisione. Condizione di superamento stabilisce quando il controllo risulta riuscito: revisione completata (impostazione predefinita), thread risolti oppure nessun risultato. Su Azure DevOps lo stato viene pubblicato sia sul commit sia sulla pull request, quindi compare nell’elenco degli stati della pull request e può essere reso obbligatorio con una policy di branch Status (genredevin, nameDevin Review). Imposta l’Authorized identity della policy sull’account con cui Devin pubblica, in modo che nessun’altra identità possa soddisfarla. - 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.
- Segnalazioni (investigate) — Pubblica le segnalazioni di indagine (potenziali problemi che meritano un esame più approfondito) come commenti alla PR.
- Segnalazioni (note) — Pubblica le segnalazioni informative (osservazioni che potrebbero non richiedere alcuna azione) come commenti alla PR.
Account Enterprise: le impostazioni si applicano a tutte le organizzazioni
nell’account Enterprise. I controlli di pubblicazione a livello di account richiedono l’autorizzazione Manage
Review a livello di account; la gestione delle regole a livello di organizzazione non concede l’autorizzazione a
modificare questi valori predefiniti. La pagina delle impostazioni di revisione di un’organizzazione riguarda solo
i repository di quell’organizzazione e blocca le impostazioni enterprise-wide,
contrassegnate come Enterprise-level setting; per modificarle, usa le impostazioni di revisione
dell’account Enterprise.
File di istruzioni
Devin Review rispetta i file di istruzioni presenti nel tuo repository. Se uno di questi file è presente, verrà usato come contesto durante l’analisi della tua PR (pull request):**/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.ymlgreptile.json
.agents/, .devin/, agents/, .cursor/, .github/) sono trattati come appartenenti alla directory padre ai fini dell’ambito di applicazione. Ad esempio, src/.agents/REVIEW.md si applica ai file sotto src/.
Questi file forniscono contesto per una revisione. Se ti serve un controllo con un nome proprio che segnali i propri risultati, configura invece un revisore personalizzato.
REVIEW.md
REVIEW.md è un file di istruzioni dedicato per Devin Review. Posizionalo in qualsiasi punto del repository per personalizzare il modo in cui Devin esamina le pull request (PR) nel tuo progetto. Devin rileva automaticamente i file REVIEW.md a qualsiasi livello di directory (**/REVIEW.md), così puoi limitare le linee guida di revisione a specifiche sottodirectory, se necessario.
Usa REVIEW.md per definire linee guida specifiche per la revisione come:
- 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.md:
Regole di revisione personalizzate
Puoi configurare file aggiuntivi da usare come contesto di revisione in Impostazioni > Revisione, nella sezione Context. Questi pattern di file sono distinti dai revisori personalizzati: forniscono informazioni di contesto anziché definire un revisore che produce i propri risultati. Per aggiungere file del repository:- Individua la sezione Context nella scheda Review delle impostazioni di revisione.
- Seleziona Add context. Si apre direttamente Add repository files, oppure compare un menu in cui puoi scegliere Repository files.
- Inserisci un pattern glob di file, ad esempio
docs/architecture/**/*.md, e aggiungilo.
Istruzioni per il contesto di revisione (Beta)
Le istruzioni scritte per il contesto di revisione sono in Beta e richiedono l’accesso alla beta.
I file di istruzioni del repository restano comunque disponibili, indipendentemente da questa funzionalità.
- Apri Impostazioni > Revisione e individua la sezione Context.
- Apri il menu di aggiunta e scegli Managed instructions, contrassegnata come Beta.
- Inserisci un titolo e le indicazioni per la revisione.
- Scegli All repositories o un ambito di repository più ristretto.
- Seleziona Add context.
Revisori personalizzati (Beta)
I revisori personalizzati sono in Beta. Se non riesci a creare o configurare un revisore, rivolgiti a un Review manager della tua organizzazione o del tuo account.
Creare un revisore
- Apri Impostazioni > Revisione e seleziona la scheda revisori personalizzati.
- Seleziona Add reviewer e inserisci un Name e, facoltativamente, una descrizione.
- In Instructions, scegli Plain text e descrivi cosa verificare e cosa ignorare, oppure scegli Repository skill o Organization skill (Enterprise skill in un’azienda) per basarti su una skill esistente.
- Scegli Finding urgency: Severe per i problemi che devono essere corretti, Moderate per le segnalazioni che vale la pena approfondire oppure Info per suggerimenti e contesto.
- Seleziona Create and enable, oppure Save as draft per completare la configurazione in un secondo momento.
- Apri il revisore e controlla Rules. Se puoi gestire Review per l’intero account, un nuovo revisore ha già Run with Devin Review attivo e quindi partecipa a ogni revisione. Per limitarlo a determinate PR, disattiva questa opzione e seleziona Add reviewer rule. In caso contrario, il revisore non ha regole iniziali e devi aggiungerne una per scegliere quali PR deve verificare.
Riutilizzare una skill
Un revisore creato da una Repository skill, Organization skill o Enterprise skill ha l’opzione Keep the reviewer in sync with the skill selezionata per impostazione predefinita: le sue istruzioni sono in sola lettura nel revisore e si aggiornano a ogni modifica della skill. Una skill di repository viene letta dal branch predefinito del repository (di solitomain o master).
Le skill di repository vengono proposte dalle directory delle skill dell’agente (come .agents/skills/ o .devin/skills/) e da qualsiasi plugin presente nel repository, usando le directory elencate in skills nel relativo .devin-plugin/plugin.json o .claude-plugin/plugin.json oppure, per impostazione predefinita, la sua directory skills/.
Se deselezioni l’opzione, il revisore mantiene il testo attuale e gli aggiornamenti della skill restano in attesa della tua approvazione. Per modificare personalmente le istruzioni, seleziona Change source… e passa a Plain text: il revisore viene così scollegato dalla skill e mantiene il testo attuale.
In un’azienda, i revisori sono condivisi. Il testo della skill di un’organizzazione,
comprese le sue modifiche future, è visibile solo ai membri di quell’organizzazione;
gli altri Review manager possono comunque modificare le altre impostazioni del revisore.
Risultati e controlli CI
I risultati riportano il nome del revisore e l’urgenza configurata. View runs mostra la cronologia delle run di ciascun revisore, con il numero di risultati corretti e ignorati, e consente di filtrare le run in base all’esito dei risultati. Ogni revisore dispone anche di una sezione Controllo CI. L’impostazione Post Controllo CI determina se i risultati del revisore confluiscono nel controllo Devin Review (Part of Devin Review) oppure se viene pubblicato un controllo separato (Separate check) con il nome del revisore, ad esempioDevin Review / API compatibility. La condizione di superamento (Passing condition) di un controllo separato può essere:
- Reviewer finishes — basta che il revisore completi l’analisi, anche se ha rilevato problemi.
- All comments are resolved — tutti i commenti pubblicati dal revisore sono stati risolti.
- There are no open findings — tutti i risultati del revisore sono stati chiusi.
Limite di spesa
La sezione Spend limit di ciascun revisore stabilisce quanto può spendere per le revisioni automatiche di una singola PR. Budget offre due opzioni:- Part of Devin Review limit (predefinito) — La spesa del revisore viene conteggiata nel limite di spesa per PR dell’auto-review. Facoltativamente, puoi impostare Limit per pull request per fissare per il revisore un limite inferiore a quella soglia.
- Separate budget — Il revisore attinge dal proprio Limit per pull request, che è obbligatorio, e continua a essere eseguito anche dopo il raggiungimento del limite di Devin Review. Solo i Review manager a livello di account possono selezionare questa opzione.
Cronologia delle versioni e archiviazione
Seleziona Last updated on … nella pagina del revisore per aprirne la cronologia delle versioni. Qui sono elencate le 20 versioni più recenti delle istruzioni, ciascuna con le modifiche apportate rispetto alla versione precedente. Restore salva le istruzioni di una versione precedente come nuova versione. Un revisore che segue una skill non può ripristinare una versione precedente finché non smette di seguirla. Disabilita un revisore per bloccarne le run future senza perderne la configurazione. L’archiviazione lo sposta in Archived reviewers, sotto l’elenco dei revisori, e ne interrompe le run; i risultati già pubblicati vengono conservati. Restore ripristina un revisore archiviato come disabilitato, quindi non verrà più eseguito finché non lo abiliti.Autoapprover (Beta)
Autoapprover è in Beta e richiede l’accesso alla beta.
- Intento: la modifica corrisponde all’intento dichiarato dall’autore della PR?
- Qualità del codice: la modifica mantiene la codebase manutenibile e facile da revisionare?
- Rischio di incidente: un problema nella modifica potrebbe causare un incidente di affidabilità o di sicurezza?
Configurazione di Autoapprover
- Apri Impostazioni > Revisione e seleziona la scheda Autoapprover. Se nella scheda compare il messaggio che Autoapprover non è ancora disponibile per il tuo account, significa che il tuo account non ha accesso alla beta.
- Aggiungi una regola di Autoapprover, selezionando il repository e le condizioni delle PR da valutare.
- Facoltativamente, aggiungi delle esclusioni di Autoapprover per le PR che non vuoi mai sottoporre a valutazione.
Istruzioni personalizzate facoltative
Per adattare la rubrica predefinita, seleziona Add instructions in Instructions e scegli dove applicarle. Descrivi cosa il tuo team si sente di approvare automaticamente e cosa richiede sempre l’intervento di una persona. Per i criteri che trattano, queste istruzioni hanno la precedenza sulla rubrica predefinita; in caso di conflitto tra istruzioni, prevale quella con l’ambito più ristretto. Autoapprover ignora le istruzioni che non può verificare, ad esempio quelle che dipendono dallo stato della CI, e nel verdetto indica quali ha ignorato. Quando Autoapprover usa la rubrica per valutare una PR, legge anche i fileAPPROVAL_POLICY.md e i file AUTOAPPROVE.md (il nome precedente) presenti nella directory radice del repository, nelle directory dei file modificati e nelle relative directory padre. Autoapprover legge i file dal branch di destinazione della PR, quindi una PR non può definire le proprie regole di approvazione, e ne passa il testo al revisore come istruzioni. Una PR che modifica un file APPROVAL_POLICY.md o AUTOAPPROVE.md richiede sempre una revisione umana.
Le istruzioni orientano le decisioni, ma da sole non includono le PR nel processo. Ad esempio, dopo aver aggiunto una regola limitata a un repository di documentazione, potresti facoltativamente aggiungere:
.github/ o i diff che superano un limite di dimensione. Mantieni attivi la protezione dei branch e i controlli di accesso.
Comprendere il risultato
La sezione Autoapprover della PR mostra il risultato e la relativa motivazione:- Autoapproved — Devin ha approvato la PR.
- Not autoapproved — la PR richiede una revisione umana.
- Approved by a person — una persona ha fornito un’approvazione.
Autorizzazioni e costi
Autorizzazioni
L’accesso a Devin Review è controllato dalle autorizzazioni di Devin Review nell’editor dei ruoli. I tier di utilizzo distinguono tra revisione manuale, revisione alla creazione della PR e revisione automatica completa. Per la configurazione account-wide è necessaria l’autorizzazione Manage Review (visualizzata come Manage Devin Review in alcuni editor dei ruoli); per le regole che copre, può bastare una concessione di accesso a livello di repository, come descritto di seguito. Gli amministratori Enterprise possono usare i ruoli personalizzati per limitare l’utilizzo o concedere l’accesso alla configurazione. Le autorizzazioni a livello di account regolano la configurazione account-wide, mentre le autorizzazioni di revisione organization-level regolano l’accesso all’interno delle organizzazioni enterprise. Se si utilizzano concessioni di accesso a livello di repository, una concessione per configurare Review su un repository o una connessione Git può darti accesso anche a Impostazioni > Revisione per le regole interessate. L’autoiscrizione, se abilitata, non richiede Manage Review, ma le modalità di attivazione disponibili dipendono dal tuo tier di utilizzo. Consulta Ruoli a livello di account per l’elenco completo dei tier di autorizzazione di Devin Review e dei diritti concessi da ciascuno. Per gestire le regole di revisione automatica e le esclusioni di un’organizzazione è necessaria l’autorizzazione dell’organizzazione Manage analysis rules, che il ruolo di organizzazione integrato Review manager concede in aggiunta alle autorizzazioni di membro.Account enterprise: i responsabili delle revisioni dell’organizzazione possono configurare gli
ambiti consentiti senza essere amministratori dell’organizzazione principale. I controlli account-wide,
come le impostazioni predefinite di pubblicazione e le istruzioni sul contesto della revisione, richiedono comunque
Manage Review a livello di account. La policy aziendale può impedire le modifiche organization-level.
Controllo dei costi
Devin Review consuma ACU (Agent Compute Units) dal pool di ACU della tua Enterprise, lo stesso pool utilizzato dalle sessioni di Devin e dagli altri prodotti Devin. Gli amministratori Enterprise dispongono di diversi strumenti per monitorare e controllare i costi delle revisioni.I controlli sul consumo e sulle organizzazioni Enterprise richiedono un account Devin
Enterprise. I limiti di spesa per singola PR delle revisioni automatiche si applicano anche
ai piani basati su quota. Per i piani Enterprise, contatta il team commerciale.
Dashboard dei consumi
Il dashboard dei consumi Enterprise in Settings > Consumption suddivide l’utilizzo degli ACU per prodotto, inclusa una voce Revisione dedicata nel grafico dei consumi giornalieri. Gli amministratori dell’organizzazione possono visualizzare il consumo delle revisioni della propria org in Settings > Consumption Analytics. Il dashboard include:- Suddivisione per utente — Mostra quanti ACU di revisione ha consumato ciascun utente nel ciclo di fatturazione corrente e in quello precedente.
- Suddivisione per repository — Mostra il consumo di ACU di revisione, il numero di revisioni 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 revisione più elevati e dove le revisioni rilevano il maggior numero di problemi.
Indicatore delle dimensioni della revisione
Ogni PR in Devin Review mostra un badge di consumo che indica la taglia della revisione in base all’utilizzo totale di ACU in tutti i job di revisione di quella PR:
Passa il cursore sul badge della dimensione per vedere il totale esatto di ACU, il numero di job di revisione eseguiti e il costo della revisione attualmente visualizzata. Questo aiuta i revisori a comprendere l’impatto sui costi della riesecuzione delle revisioni o dell’abilitazione della revisione automatica sulle PR con modifiche frequenti.
Limite di spesa per l’auto-review per PR
Gli amministratori possono impostare un limite alla spesa di Devin Review per le revisioni automatiche di una singola PR da Impostazioni > Revisione, nella scheda fatturazione, sotto Limiti dell’analisi automatica. Il limite è misurato in ACU nei piani basati sulle ACU oppure in dollari di spesa a consumo nei piani basati su quota. Se lasci il campo vuoto, viene usato il valore predefinito gestito da Cognition indicato nelle impostazioni; non significa assenza di limite. Quando la spesa totale di revisione di una PR, sommata su tutti i relativi job di revisione, raggiunge il limite, l’auto-review viene disattivata per quella PR e le future auto-review vengono ignorate. Il raggiungimento del limite è un blocco non definitivo:- 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 l’auto-review dal menu delle azioni della PR, le revisioni riprendono e viene aggiunta un’ulteriore quota di budget. La spesa registrata non viene azzerata e le revisioni automatiche possono essere di nuovo messe in pausa quando il nuovo budget si esaurisce.
Impegno della revisione e organizzazione di fatturazione
L’opzione Impegno dell’analisi nelle impostazioni di revisione consente a un responsabile delle revisioni dell’account di scegliere il livello di impegno predefinito tra Normal e Ultra. Normal privilegia il rapporto prezzo-prestazioni; Ultra esegue una revisione più approfondita a un costo maggiore. Gli account enterprise dispongono inoltre dell’impostazione Default billing organization for automatic analysis nella scheda fatturazione, che si applica alle revisioni la cui organizzazione di fatturazione non può essere determinata in altro modo. Questa impostazione richiede l’autorizzazione per le impostazioni dell’account. Se l’attribuzione all’organizzazione è abilitata, la visualizzazione del consumo delle revisioni può indicare a quale organizzazione, o all’account stesso, è stata fatturata la revisione più recente. Se nella scheda fatturazione sono disponibili le Repository billing rules, i responsabili delle revisioni dell’organizzazione possono modificare le regole per i repository delegati e addebitare i costi di Review a un’organizzazione o a un budget idoneo da loro gestito. Non possono invece modificare una regola che addebita già i costi a un pagatore che non gestiscono.Provider Git supportati
dev.azure.com) e Azure DevOps Server 2020/2022. Connettiti tramite l’integrazione con Azure DevOps, un service principal di Microsoft Entra o una raccolta di Azure DevOps Server con un token di accesso personale, quindi registra i repository da Impostazioni > Revisione per l’auto-review. Devin pubblica i risultati automatici tramite l’identità di servizio connessa. Per commentare, rispondere, risolvere thread, votare una PR o abbandonarla a tuo nome, collega a Devin il tuo account Azure DevOps personale. Le azioni attribuite all’utente richiedono un’identità Microsoft delegata supportata, che un PAT del server condiviso non fornisce. Le modifiche dalla chat possono essere applicate come singolo commit e gli account collegati possono visualizzare l’elenco delle proprie PR in Review. Merge, azioni di bozza e Auto-merge non sono disponibili.
Bitbucket Data Center richiede la versione 8.16 o successiva, connessa tramite l’integrazione con Bitbucket. Per commentare, aggiungere o rimuovere revisori, approvare o rifiutare una PR da Devin Review, collega il tuo account Bitbucket. Merge, etichette, assegnatari e reazioni non sono disponibili e le modifiche al codice dalla chat vengono salvate in commit un file alla volta.
Bitbucket Cloud (bitbucket.org) è supportato tramite l’integrazione con Bitbucket. Connetti il tuo workspace con un token di accesso o un Account Devin dedicato collegato tramite OAuth che amministri i repository (Devin installa autonomamente i webhook necessari per l’auto-review), quindi aggiungi le regole di revisione automatica da Impostazioni > Revisione. Commenti, risposte e rifiuti di una PR da Devin Review vengono pubblicati a tuo nome tramite il tuo account Bitbucket. Richiesta di revisori, merge, azioni di bozza, Auto-merge, etichette, assegnatari e reazioni non sono disponibili. Le modifiche al codice dalla chat vengono salvate in un unico commit.
Perforce Swarm supporta l’analisi delle revisioni e i risultati automatici tramite l’identità di servizio della connessione. Con questo provider, la UI di Devin Review è in sola lettura per i commenti degli utenti e le azioni di approvazione, e non può applicare le modifiche dalla chat come commit. Le revisioni di Swarm non compaiono nella inbox personale delle PR. Le connessioni Perforce sono disponibili solo per alcuni account.
