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