Lezione gratuita

Creare un repository verificabile

Creare un repository verificabile — Agenti di coding: modifiche verificabili. Controllare account e modalità; Creare i file didattici; Ispezionare prima del prompt. Esercitazione pratica: Prove del laboratorio.

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

Argomenti trattati

  • Controllare account e modalità
  • Creare i file didattici
  • Ispezionare prima del prompt

Controllare account e modalità

Usa disponibilità già inclusa oppure procedi manualmente. Non attivare eccedenze a pagamento e non considerare l’abbonamento come API illimitata.

Usa Codex CLI installato o il quickstart ufficiale: installazione e accesso sono distinti. Esamina l’installer, scegli manualmente account e verifica limiti/fatturazione prima del compito. Da agent-lab controlla versione e avvia read-only. Chiedi prima spiegazione di total.mjs; verifica directory e permessi con /status e /permissions. Abilita modifiche limitate soltanto per la riparazione autorizzata successiva.

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.

# After official installation and choosing the intended account
# Run from the agent-lab directory created in the next step:
codex --version
codex --sandbox read-only --ask-for-approval on-request
# In the interactive session: /status then /permissions
# Prompt: Explain total.mjs. Do not edit files or install dependencies.

Creare i file didattici

Crea un repository vuoto e total.mjs con la funzione indicata. L’implementazione iniziale accetta volutamente posti negativi. Committa soltanto questa base sintetica.

L’identità Git è inventata e configurata solo nel repository didattico. Permette il commit iniziale senza cambiare impostazioni globali. In un progetto reale con cronologia o modifiche pendenti ispeziona lo stato, evitando di applicare alla cieca lo scenario della cartella vuota.

Crea total.mjs alla radice col JavaScript seguente senza marcatore commento shell. Salva prima di git add. Il blocco shell configura Git e registra il file, non ne costituisce il contenuto.

export function total(seats,price){return seats*price;}

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.

# Terminal
mkdir agent-lab
cd agent-lab
git init
git config user.name "Training Learner"
git config user.email "learner@example.test"
# Save total.mjs:
# export function total(seats,price){return seats*price;}
git add total.mjs
git commit -m "Training baseline"
git switch -c fix-seat-validation

Ispezionare prima del prompt

Controlla stato, cronologia e file prima del contesto. Se esistono modifiche, preservale e restringi il compito invece di sovrascrivere la cartella.

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.

git status --short
git log -3 --oneline
git diff

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