Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Revisione del codice automatizzata

Lezione 11 di 20 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Migliora la qualità del codice con le revisioni AI
  2. Esegui una revisione su una PR
  3. Indirizza le revisioni a un dominio specifico
  4. Automatizza le revisioni in GitHub
  5. Auto-revisione prima di aprire la PR
  6. Definisci i tuoi standard in AGENTS.md
  7. Punti chiave

Aggiornato il 3 novembre 2026 in base alle pagine Code Review e Use Codex in GitHub della documentazione di Codex e alla versione 0.166.0 dell’aiuto CLI: le revisioni si attivano tramite @codex review o abilitando la revisione automatica nelle impostazioni, localmente tramite codex review --uncommitted o /review; la sezione AGENTS.md è intitolata ## Code Review Rules. Il comando dell’estensione “Codex: Review Changes” e l’URL codex.openai.com sono stati rimossi; l’esempio di report è presentato a scopo illustrativo. Fonti: Code review · Use Codex in GitHub.

Migliora la qualità del codice con le revisioni AI

Nella maggior parte dei team, la revisione del codice è diventata il collo di bottiglia della pipeline di rilascio: le pull request si accumulano perché i revisori esperti sono impegnati a scrivere codice loro stessi. Codex non sostituisce i revisori umani; gestisce il primo passaggio, individuando sviste evidenti, deviazioni dall’architettura esistente e casi limite non testati. Quando uno sviluppatore apre finalmente la PR, non deve più segnalare test mancanti sui percorsi di errore: può concentrare l’attenzione sulle decisioni che richiedono giudizio aziendale.

Esegui una revisione su una PR

Su GitHub, l’approccio più diretto è menzionare Codex in un commento alla pull request: @codex review. Codex reagisce (👀) e pubblica la sua revisione nella PR. Nell’app desktop, il modulo Code Review mostra la descrizione della PR, i file modificati, i commenti e i check, permettendoti di interrogare Codex sulla modifica. In entrambi i casi, la qualità del report dipende dalla precisione della richiesta: indica le aree da coprire.

"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"

Codex analizza il diff, ma legge anche il contesto dei file modificati, non solo le righe cambiate, fornendo poi un report strutturato. Ecco un esempio del tipo di report che potresti ricevere per una PR che aggiunge un sistema di notifiche:

## Review PR #142 — Notification System Addition

### Security
⚠️ src/api/routes/notifications.ts:34
  The userId parameter comes from the request body without 
  validation. A user could send notifications on behalf of 
  another. Use req.user.id from the authentication middleware.

### Architecture
✅ The service follows the same pattern as other services
⚠️ The notification.service.ts file is already 200 lines.
  Consider separating channels (email, webhook) into 
  distinct files.

### Tests
❌ No test for when the email service is 
   unavailable (timeout/network error)
⚠️ Tests mock the DB but not the email service

### Code quality
💡 The sendBatch function could use Promise.allSettled 
   instead of Promise.all to avoid failing if one 
   notification out of 50 fails.

Presta attenzione alla natura dei commenti piuttosto che alla loro formattazione. La vulnerabilità userId è esattamente ciò che un revisore frettoloso rischia di perdere un venerdì sera: il codice compila, i test passano, eppure qualsiasi utente può scrivere per conto di un altro. Il suggerimento Promise.allSettled riflette una comprensione del comportamento atteso: un invio in batch non dovrebbe fallire perché un indirizzo su cinquanta rimbalza, non è una mera applicazione meccanica di una regola di stile.

Indirizza le revisioni a un dominio specifico

Le revisioni generiche diluiscono l’attenzione su cinque argomenti contemporaneamente. Quando prepari un rilascio sensibile in produzione, richiedi invece un passaggio specializzato su un ambito ristretto. Per la sicurezza, il prompt appare così:

"Security review on files modified in 
src/api/ over the last 5 commits. Look for:
- SQL injections
- Potential XSS  
- Missing authentication
- Exposed sensitive data
- Unchecked permissions"

Codex conosce i pattern di vulnerabilità comuni e può individuarli nel tuo codice, anche quando sono nascosti dietro un livello di astrazione personalizzato. Lo stesso principio vale per le prestazioni, tranne per il fatto che cerchi sintomi molto diversi: non un difetto, ma una query eseguita cento volte quando ne basterebbe una:

"Analyze performance of src/services/report.service.ts.
Identify:
- N+1 database queries
- Loops that could be parallelized
- Loaded but unused data
- Calculations that could be cached"

Automatizza le revisioni in GitHub

Una volta consolidata la pratica nel team, rendila sistematica invece di affidarla alla memoria individuale. La documentazione di Codex descrive la configurazione come segue:

  1. Collega il tuo repository GitHub a Codex (devi avere diritti di push o di amministratore sulle sue impostazioni).
  2. Apri le impostazioni di code review.
  3. Seleziona il repository, quindi abilita Automatic review sotto Review code.

Tutti possono anche abilitare la revisione automatica per le proprie PR nelle preferenze personali e scegliere quando attivarsi (Review trigger), senza dover digitare @codex review. Questa revisione cloud non richiede la creazione di un ambiente Codex Cloud. I commenti appaiono direttamente nella PR di GitHub, nello stesso punto dei commenti dei revisori umani: un dettaglio che favorisce l’adozione, perché un’osservazione che costringe ad aprire un altro strumento non verrà letta. Esiste anche la revisione delle merge request di GitLab, in anteprima.

Auto-revisione prima di aprire la PR

Il momento migliore per risolvere un problema è prima che qualcun altro lo veda. Dall’IDE o dalla CLI, un’auto-revisione sulle modifiche non ancora sottoposte a commit richiede pochi secondi e ti risparmia un intero ciclo di revisione:

# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted

# Or review a branch against main
codex review --base main

In una sessione interattiva, il comando /review fa la stessa cosa sul tuo working tree; nell’app desktop, Code Review offre anche la possibilità di revisionare le modifiche locali.

Provalo sul tuo prossimo branch prima del push: scoprirai che metà dei commenti che ricevi solitamente dai colleghi sono già stati affrontati e la conversazione di revisione parte da un livello più interessante.

Definisci i tuoi standard in AGENTS.md

Una revisione ha valore solo se applica i criteri del tuo team, non quelli di un progetto immaginario. Codex cerca i file AGENTS.md nel repository e segue le loro regole di revisione: aggiungi una sezione ## Code Review Rules al file più vicino al codice interessato, con sottotitoli ### per raggruppare i controlli.

## Code Review Rules

### API
- Every API route must verify authentication
- User data must be validated with Zod
- No TypeScript any (use unknown + type guard)
- Errors must be logged with context
- Functions > 50 lines must be broken down
- TODO comments must have an associated ticket

Codex applica questi standard a ogni revisione, con una coerenza che nessun revisore umano mantiene attraverso trecento pull request consecutive.

Punti chiave

  • Codex esegue una revisione di primo passaggio per filtrare i problemi evidenti
  • Le revisioni possono essere specializzate: sicurezza, prestazioni, architettura
  • L’integrazione con GitHub abilita revisioni automatiche su ogni PR
  • Usa la revisione prima di creare la PR per risparmiare tempo
  • Documenta i tuoi standard in AGENTS.md per revisioni coerenti