Lezione gratuita

Dare contesto e un compito limitato

Dare contesto e un compito limitato — Agenti di coding: modifiche verificabili. Scrivere le istruzioni del repository; Chiedere un comportamento concreto; Confermare l’ambito proposto. Esercitazione pratica: Prove del laboratorio.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Scrivere le istruzioni del repository
  • Chiedere un comportamento concreto
  • Confermare l’ambito proposto

Scrivere le istruzioni del repository

AGENTS.md indica test, file consentiti e confini esterni. Fornisce contesto, senza sostituire permessi reali o autorizzazioni dell’utente.

Il repository inventato calcola il totale di prenotazioni. È piccolo abbastanza da controllare ogni riga e ripetere i test. Una proposta dell’assistente dimostra una modifica suggerita, non che il codice funzioni o un’azione esterna sia autorizzata. Escludi segreti e repository estranei. Verifica i permessi reali dello strumento: un prompt da solo non crea isolamento né limita il processo.

# AGENTS.md
Training repository only.
Change total.mjs and total.test.mjs only.
Use node --test. No new dependencies.
Do not deploy, publish, send data, or change billing.

Chiedere un comportamento concreto

Chiedi di rifiutare posti negativi, frazionari e non numerici mantenendo totali validi. Fornisci input e criteri invece di “migliora il codice”.

Il prezzo resta invariato per rendere la riparazione circoscritta. È un confine didattico, non una dichiarazione di sicurezza dei prezzi in produzione. Se la revisione rivela quel bisogno, apri un compito distinto con contratto e test propri senza ampliare silenziosamente la patch.

Lavora su un ramo dedicato in un repository didattico pulito. Salva i file indicati ed esegui dalla radice. Prima di modificare registra comportamento errato e risultato atteso. Esplicita file consentiti e dipendenze. Controlla i comandi generati, soprattutto installazioni, richieste a servizi o scarti di file. Dopo ogni piccola modifica ispeziona il diff per evitare cambiamenti collaterali.

Inspect total.mjs first. Change only seat validation.
Accept total(3,20) = 60 and total(0,20) = 0.
Reject seats -1, 1.5 and "3" with RangeError.
Keep price behavior unchanged in this exercise.
Add meaningful tests and report actual results.

Confermare l’ambito proposto

Controlla refactoring estranei, dipendenze e azioni di rete nel piano. Restringi la patch se non servono al comportamento richiesto.

Un rapporto utile indica comportamento cambiato, controlli realmente eseguiti e incertezze. Scrivere un comando non dimostra un test superato: conserva l’esito reale. Prima del commit esamina patch e qualità dei test. Un test unitario riuscito non autorizza deploy, modifiche di fatturazione o invio del repository a terzi. Sono azioni distinte, con un proprio ambito da verificare.

Esercitazione pratica

Prove del laboratorio

Vai alla lezione

Programma del corso

  1. Creare un repository verificabile
  2. Dare contesto e un compito limitato
  3. Applicare la modifica minima utile
  4. Provare difetto e confini
  5. Gestire approvazioni e istruzioni sospette
  6. Rivedere, committare e annullare