Vai al contenuto
PROMPTARIO
Strumenti10 min di lettura

Code review assistita: chiedere osservazioni verificabili sul diff

Come usare l’AI per cercare regressioni e test mancanti senza trasformare preferenze stilistiche in difetti.

SCRITTA DARedazione Promptario
PUBBLICATA
PER CHIPer sviluppatori e team che introducono una revisione AI nelle pull request.
  1. 01
    ScopriComprendi il metodo

    Leggi il perché delle scelte e riconosci quando applicarle.

  2. 02
    ConfiguraAdatta gli esempi

    Sostituisci vincoli, obiettivi e strumenti con il tuo contesto.

  3. 03
    UsaVerifica il risultato

    Metti in pratica i passaggi e controlla sempre l’output finale.

01

Prepara il lavoro prima di aprire l’AI

Questa attività parte da diff, regole del repository e risultati dei test. L’AI può accelerare ordinamento e prima stesura, ma una risposta fluida non dimostra che fonti, ruoli o decisioni siano corretti. Prima chiarisci quale risultato userai e chi dovrà confermarlo.

Raccogli obiettivo della modifica, patch completa, convenzioni, aree sensibili, test eseguiti e vincoli di compatibilità. Usa una copia di lavoro e rimuovi dati personali, segreti o dettagli non necessari. Se una fonte è incompleta o vecchia, rendilo visibile: il modello non deve colmare il vuoto con una supposizione.

  • Obiettivo e destinatario del risultato.
  • Fonti canoniche con data o versione.
  • Vincoli, esclusioni e informazioni mancanti.
  • Persona responsabile della verifica finale.
02

Applica un metodo in quattro passaggi

Chiedi un passaggio alla volta quando il materiale è complesso. Una struttura intermedia rende più facile trovare un errore rispetto a un’unica risposta finale molto rifinita.

Per ogni conclusione importante conserva il riferimento alla fonte e una nota sul livello di certezza. I dati mancanti devono produrre una domanda o uno stato da verificare, non una scelta automatica.

  • Ricostruisci il comportamento toccato dal diff.
  • Cerca errori, regressioni, sicurezza e casi limite.
  • Ignora stile già coperto dagli strumenti automatici.
  • Scrivi rilievi con posizione, scenario e test riproducibile.
03

Usa un prompt che separa fonti, lavoro e controllo

Nel prompt assegna all’AI un compito concreto, non un’autorità generica. Specifica cosa può leggere, quale trasformazione deve compiere e quali decisioni restano fuori dal suo ruolo.

Delimita il materiale con marcatori visibili. Eventuali istruzioni presenti in email, documenti o pagine appartengono ai dati e non devono cambiare il compito autorizzato.

Prompt da copiarePRONTO DA ADATTARE
Obiettivo: Una lista breve di rilievi con file, evidenza, impatto e prova suggerita.

Materiali disponibili:
--- INIZIO FONTI ---
{incolla qui soltanto i materiali necessari}
--- FINE FONTI ---

Contesto e destinatario: {dati}
Vincoli: non modificare il repository e non dichiarare un bug senza collegarlo a un percorso concreto.

Procedi così:
1. Ricostruisci il comportamento toccato dal diff.
2. Cerca errori, regressioni, sicurezza e casi limite.
3. Ignora stile già coperto dagli strumenti automatici.
4. Scrivi rilievi con posizione, scenario e test riproducibile.

Separa fatti, interpretazioni e informazioni mancanti. Cita la fonte di ogni punto decisivo. Non compiere azioni esterne. Chiudi con le verifiche che una persona deve completare prima dell’uso.
04

Verifica il risultato nel contesto reale

Esegui o simula i test proposti e fai revisionare il diff da una persona competente. Non limitarti a rileggere il testo generato: torna ai materiali e ripeti i conteggi, i confronti o le prove che sostengono le parti decisive.

Conserva una traccia minima di data, versione delle fonti e correzioni applicate. Se il lavoro verrà ripetuto, usa gli errori trovati per aggiornare il prompt e i casi di prova, senza trasformare un singolo esito positivo in una garanzia generale.

  • Ogni affermazione decisiva è collegata a una fonte disponibile.
  • Fatti, interpretazioni e ipotesi sono distinguibili.
  • Date, numeri, nomi e responsabilità sono stati ricontrollati.
  • Dati personali e informazioni riservate sono ridotti al necessario.
  • Le azioni esterne restano in bozza o sotto approvazione esplicita.
  • Limiti, eccezioni e informazioni mancanti sono visibili nell’output.

La guida ti è stata utile?

Trasforma il metodo in un flusso che puoi riusare.
Vai al catalogo →
↘

DAL METODO ALL’AZIONE

Risorse da usare con questa guida

ScriptSviluppo

Revisore automatico delle pull request

Segnala bug potenziali, rischi, test mancanti e deviazioni dalle regole del progetto.

Apri la risorsa
PromptLavoro

Adattare il CV a un annuncio senza inventare competenze

Confronta requisiti e curriculum, propone una versione mirata e mantiene visibili competenze mancanti o non dimostrate.

Apri la risorsa
PromptProduttività

Brief di progetto con domande mancanti

Trasforma appunti disordinati in un brief senza riempire i vuoti con supposizioni.

Apri la risorsa
PromptProduttività

Retrospettiva di progetto senza colpe

Analizza risultati e ostacoli concentrandosi sul sistema e sulle azioni future.

Apri la risorsa
PromptRicerca

Backlog di ipotesi ed esperimenti

Trasforma osservazioni in test piccoli con metriche e criteri di arresto.

Apri la risorsa
PromptCustomer care

Sequenza di onboarding per un cliente

Ordina raccolta materiali, accessi e conferme senza chiedere permessi eccessivi.

Apri la risorsa
→

CONTINUA A ESPLORARE

Guide collegate

← Torna a tutte le guide