Specifica il contesto
In questa pagina
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