Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Specifica il contesto

Lezione 5 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Il contesto fa la differenza
  2. Il problema dei prompt privi di contesto
  3. Come specificare efficacemente il contesto
  4. Esempi prima/dopo
  5. Punti chiave

Il contesto fa la differenza

La qualità delle risposte di grok-build-0.1 dipende direttamente dalla qualità del contesto che fornisci. Un prompt vago genera una risposta generica. Un prompt con il contesto giusto produce una risposta applicabile immediatamente al tuo codice.

Il problema dei prompt privi di contesto

Ecco un esempio concreto. Chiedi:

“Migliora la gestione degli errori”

Il modello non sa:

  • Su quale file lavorare
  • Che tipo di errori stai gestendo
  • Quali sono i tuoi codici di errore esistenti
  • Com’è strutturato il tuo progetto
  • Quali dipendenze stai utilizzando

Produrrà una risposta generica con blocchi try/catch standard che probabilmente non corrisponderanno alla tua architettura.

Come specificare efficacemente il contesto

Menziona i file rilevanti

Editor come Cline e Cursor ti permettono di riferirti ai file usando @. Usa questa funzione costantemente:

“I miei codici di errore sono definiti in @errors.ts. Usali come riferimento per aggiungere una gestione degli errori appropriata in @sql.ts, dove sto eseguendo le query”

Il modello vede ora i file effettivi, comprende le tue convenzioni e produce codice coerente con la tua base di codice.

Descrivi la struttura del progetto

Quando lavori su un nuovo progetto o su una parte del codice che il modello non conosce ancora, descrivi brevemente la struttura:

“Il progetto usa Express con TypeScript. Le route sono in src/routes/, i servizi in src/services/ e i tipi in src/types/. Sto lavorando sul servizio di autenticazione.”

Specifica le dipendenze

Se il tuo codice utilizza librerie specifiche, menzionale:

“Sto usando Zod per la validazione, Drizzle per l’ORM e Pino per il logging. Aggiungi la validazione allo schema di input in @api/users.ts”

Escludi ciò che è irrilevante

Escludere ciò che non è rilevante è importante quanto includere il contesto giusto. Se riferisci 15 file per una modifica semplice, il modello potrebbe confondersi. Concentrati sui file direttamente coinvolti.

Esempi prima/dopo

Generazione di test

Senza contesto: “Scrivi test per la mia funzione di validazione”

Con contesto: “Scrivi test Vitest per la funzione validateUser in @src/validators/user.ts. I fixture di test sono in @tests/fixtures/users.json. Usa lo stesso pattern di @tests/validators/product.test.ts”

Refactoring

Senza contesto: “Rifattorizza questo codice per renderlo più pulito”

Con contesto: “Estrai la logica di retry in @src/api/client.ts (righe 45-78) in un helper riutilizzabile in @src/utils/retry.ts. Anche gli altri client API in @src/api/ dovrebbero poterlo usare”

Punti chiave

  • Riferisci sempre i file rilevanti con @
  • Descrivi la struttura del progetto quando necessario
  • Menziona le dipendenze e le convenzioni che utilizzi
  • Escludi le informazioni irrilevanti per evitare rumore
  • Più preciso è il contesto, più direttamente potrai applicare la risposta