Specificați contextul
Pe această pagină
Contextul face diferența
Calitatea răspunsurilor oferite de grok-build-0.1 depinde direct de calitatea contextului pe care îl furnizați. Un prompt vag generează un răspuns generic. Un prompt însoțit de contextul potrivit produce un răspuns pe care îl puteți aplica imediat în codul dumneavoastră.
Problema prompturilor fără context
Iată un exemplu concret. Dumneavoastră întrebați:
„Îmbunătățește gestionarea erorilor“
Modelul nu știe:
- În ce fișier să lucreze
- Ce tip de erori gestionați
- Care sunt codurile de eroare existente
- Cum arată structura proiectului
- Ce dependențe utilizați
Va produce un răspuns generic cu blocuri standard try/catch care, probabil, nu se vor potrivi arhitecturii dumneavoastră.
Cum să specificați contextul eficient
Menționați fișierele relevante
Editoare precum Cline și Cursor vă permit să faceți referire la fișiere folosind @. Utilizați această funcționalitate în mod constant:
„Codurile mele de eroare sunt definite în @errors.ts. Folosiți-le ca referință pentru a adăuga o gestionare adecvată a erorilor în @sql.ts, acolo unde execut interogări“
Modelul vede acum fișierele reale, înțelege convențiile dumneavoastră și generează cod coerent cu baza de cod existentă.
Descrieți structura proiectului
Când lucrați la un proiect nou sau la o parte din cod pe care modelul nu o cunoaște încă, descrieți pe scurt structura:
„Proiectul folosește Express cu TypeScript. Routele se află în src/routes/, serviciile în src/services/, iar tipurile în src/types/. Lucrez la serviciul de autentificare.“
Specificați dependențele
Dacă codul dumneavoastră utilizează librării specifice, menționați-le:
„Folosesc Zod pentru validare, Drizzle pentru ORM și Pino pentru logging. Adăugați validarea schemei de intrare în @api/users.ts“
Excludeți ce nu este relevant
Excluderea informațiilor irelevante este la fel de importantă ca includerea contextului potrivit. Dacă faceți referire la 15 fișiere pentru o modificare simplă, modelul se poate pierde. Concentrați-vă doar pe fișierele direct implicate.
Exemple înainte/după
Generarea de teste
Fără context: „Scrie teste pentru funcția mea de validare“
Cu context: „Scrie teste Vitest pentru funcția validateUser din @src/validators/user.ts. Datele de test (fixtures) se află în @tests/fixtures/users.json. Folosește același model ca în @tests/validators/product.test.ts“
Refactorizarea
Fără context: „Refactorizează acest cod pentru a-l face mai curat“
Cu context: „Extrage logica de reîncercare din @src/api/client.ts (liniile 45-78) într-un helper reutilizabil în @src/utils/retry.ts. Și ceilalți clienți API din @src/api/ ar trebui să o poată folosi“
Puncte cheie
- Faceți întotdeauna referire la fișierele relevante folosind
@ - Descrieți structura proiectului atunci când este necesar
- Menționați dependențele și convențiile pe care le utilizați
- Excludeți informațiile irelevante pentru a evita zgomotul
- Cu cât contextul este mai precis, cu atât puteți aplica mai direct răspunsul obținut