Una revisione utile non è un elenco generico di «possibili miglioramenti». Deve individuare problemi fondati, separare errori reali da preferenze stilistiche e spiegare quali verifiche servono. BestPrompt ti guida nella preparazione di un prompt per una code review focalizzata sul comportamento e sui rischi del codice che deciderai di fornire all'assistente AI.
Imposta priorità e criteri di review prima di usare l'AI.
Rischi prioritari: distingui problemi di sicurezza, errori logici e rifiniture.
Osservazioni motivate: chiedi il riferimento al passaggio di codice interessato.
Meno refactoring superfluo: evita di trasformare la review in una riscrittura completa.
Come funziona in breve
Indica linguaggio e scopo. Spiega a che cosa serve il codice e in quale contesto gira.
Scegli i criteri. Correttezza, sicurezza, leggibilità, prestazioni o test.
Prepara il prompt. Fornisci il codice all'AI e verifica le segnalazioni prima di intervenire.
Che cosa puoi creare
Prompt per esaminare una funzione PHP, un componente JavaScript, una query o una modifica destinata a una pull request. Il builder non certifica il codice come sicuro né sostituisce test automatici e review umane quando sono necessari.
Definisci il tipo di revisione
Una code review può concentrarsi su correttezza, leggibilità, sicurezza, performance o testabilità: chiedere 'controlla tutto' produce spesso osservazioni poco selettive. Indica linguaggio, versione, standard del progetto e comportamento previsto della funzione. Fornisci il contesto necessario, per esempio firma del metodo e test associati, evitando di condividere file estranei. Se il codice è legacy, chiarisci le parti che non possono essere riscritte.
Fatti restituire rilievi verificabili
Genera un prompt che chieda una revisione per priorità: prima bug dimostrabili, poi rischi plausibili, infine consigli di stile. Per ogni rilievo richiedi posizione nel codice, motivo, condizione in cui emerge e proposta minima di correzione. Se l'AI parla di SQL injection o di una funzione deprecata, chiedi quale istruzione la espone e come riprodurre il problema. Le segnalazioni non verificate devono restare ipotesi, non essere presentate come vulnerabilità già confermate.
Dal commento al miglioramento effettivo
Applica e testa una modifica alla volta. Se l'AI propone un grande refactoring, chiedi quale problema reale risolve e quali regressioni potrebbe introdurre. Esamina la differenza tra versione originale e proposta, controlla compatibilità con le dipendenze e aggiungi i test mancanti solo dove utili. Una revisione convincente produce osservazioni specifiche, non un elenco generico di 'best practice'.
Valutazione umana necessaria
L'AI può segnalare falsi positivi o trascurare bug importanti. Non sostituisce scanner di sicurezza, suite test o revisione specialistica quando necessaria. Prima di condividere codice proprietario verifica autorizzazioni e condizioni di trattamento del servizio AI.
Quale AI usare per questo compito?
Claude
Per discutere criticità e alternative di revisione su frammenti circoscritti.
Chiedi indicazioni di riga, severità e condizioni di riproduzione.
Esempio non esclusivo; nessuna integrazione, affiliazione o garanzia
Richiesta iniziale (illustrativa): «Voglio far revisionare una funzione PHP che salva dati di un modulo, con attenzione a validazione input, query SQL e gestione errori, ma senza rifare l'applicazione».
Che cosa deve chiarire il prompt: perimetro della review, formato delle osservazioni, evidenze e divieto di segnalare vulnerabilità non dimostrate come certezze.
Esempio di prompt completo (illustrativo, non generato dal sito)
Agisci come revisore senior PHP 8.2. Esamina soltanto la funzione che ti fornirò, usata per validare e salvare dati di un modulo. Concentrati su query parametrizzate, validazione lato server, autorizzazioni, gestione degli errori e rischio di esporre informazioni riservate. Restituisci una tabella con gravità, riga o frammento interessato, problema osservabile, motivo, correzione minima e test consigliato. Distingui chiaramente vulnerabilità verificabili, ipotesi che dipendono dal contesto e semplici suggerimenti stilistici. Se ti mancano informazioni su sessioni, database o chiamante, segnalale senza inventare il resto dell'applicazione. Non riscrivere interi file non richiesti.
Gli esempi sono illustrativi. Copia il prompt in un servizio AI esterno; verifica i dati e il risultato.
Domande frequenti
Posso richiedere solo una review di sicurezza?
Sì. Specifica quel criterio, ricordando però che una valutazione automatica non sostituisce una verifica specialistica completa.
L'AI deve sempre suggerire una riscrittura?
No. Puoi chiedere correzioni minime, compatibili con la struttura esistente e accompagnate da verifiche mirate.
Devo condividere credenziali o file di configurazione?
No. Rimuovi segreti e dati personali e condividi soltanto il codice indispensabile per l'analisi.