A kontextus meghatározása
Ezen az oldalon
A kontextus teszi a különbséget
A grok-build-0.1 válaszainak minősége közvetlenül függ az általad megadott kontextus minőségétől. Egy bizonytalan prompt általános választ eredményez. Ezzel szemben a megfelelő kontextussal ellátott prompt olyan választ generál, amelyet azonnal alkalmazhatsz a kódodban.
A kontextus nélküli promptok problémája
Íme egy konkrét példa. Azt kérdezed:
„Javítsd a hibakezelést“
A modell nem tudja:
- Melyik fájlon dolgozzon
- Milyen típusú hibákat kezelsz
- Mik a meglévő hibakódjaid
- Hogyan néz ki a projekted felépítése
- Milyen függőségeket használsz
Egy általános választ fog adni szabványos try/catch blokkokkal, amelyek valószínűleg nem illeszkednek az architektúrádhoz.
Hogyan határozd meg hatékonyan a kontextust
Hivatkozz a releváns fájlokra
Az olyan szerkesztők, mint a Cline és a Cursor, lehetővé teszik a fájlokra való hivatkozást a @ karakter használatával. Használd ezt a funkciót következetesen:
„A hibakódjaim az @errors.ts fájlban vannak definiálva. Használd őket referenciaként a megfelelő hibakezelés hozzáadásához az @sql.ts fájlhoz, ahol lekérdezéseket végzek“
A modell így látja a tényleges fájlokat, megérti a konvencióidat, és a kódrendszereddel konzisztens kódot hoz létre.
Írd le a projekt felépítését
Amikor egy új projekten vagy a kód olyan részén dolgozol, amelyet a modell még nem ismer, írd le röviden a struktúrát:
„A projekt Express-t használ TypeScriptkel. Az útvonalak a src/routes/ mappában, a szolgáltatások a src/services/ mappában, a típusok pedig a src/types/ mappában találhatók. Jelenleg a hitelesítési szolgáltatáson dolgozom.”
Add meg a függőségeket
Ha a kódod specifikus könyvtárakat használ, említsd meg őket:
„Validációhoz Zod-ot, ORM-hez Drizzle-t, naplózásra pedig Pino-t használok. Adj validációt a bemeneti sémához az @api/users.ts fájlban“
Zárd ki a nem releváns elemeket
A nem releváns információk kizárása ugyanolyan fontos, mint a megfelelő kontextus bevitele. Ha egy egyszerű módosításhoz 15 fájlt hivatkozol meg, a modell elveszítheti a fonalat. Csak a közvetlenül érintett fájlokra fókuszálj.
Előtte/utána példák
Tesztgenerálás
Kontextus nélkül: „Írj teszteket a validáló függvényemhez“
Kontextussal: „Írj Vitest teszteket a validateUser függvényhez az @src/validators/user.ts fájlban. A teszt adatállományok az @tests/fixtures/users.json fájlban találhatók. Használd ugyanazt a mintát, mint az @tests/validators/product.test.ts fájlban”
Refaktorálás
Kontextus nélkül: „Refaktoráld ezt a kódot, hogy tisztább legyen“
Kontextussal: „Emeld ki az újrapróbálkozási logikát az @src/api/client.ts fájlból (45-78. sorok) egy újrahasználható segédfüggvénybe az @src/utils/retry.ts fájlba. A többi API kliensnek az @src/api/ mappában szintén képesnek kell lennie használni ezt”
Főbb megállapítások
- Mindig hivatkozz a releváns fájlokra a
@karakterrel - Szükség esetén írd le a projekt felépítését
- Említsd meg a használt függőségeket és konvenciókat
- Zárd ki a nem releváns információkat a zaj elkerülése érdekében
- Minél pontosabb a kontextus, annál közvetlenebbül alkalmazható a válasz