Określ kontekst
Na tej stronie
Kontekst robi różnicę
Jakość odpowiedzi generowanych przez grok-build-0.1 zależy bezpośrednio od jakości kontekstu, który dostarczysz. Niejasny prompt skutkuje ogólnikową odpowiedzią. Prompt z odpowiednim kontekstem pozwala uzyskać rozwiązanie, które możesz natychmiast zastosować w swoim kodzie.
Problem z promptami bez kontekstu
Oto konkretny przykład. Pytasz:
„Popraw obsługę błędów“
Model nie wie:
- W którym pliku ma pracować
- Jakiego typu błędy obsługujesz
- Jakie są Twoje istniejące kody błędów
- Jak wygląda struktura Twojego projektu
- Z jakich zależności korzystasz
Wygeneruje ogólnikową odpowiedź ze standardowymi blokami try/catch, które prawdopodobnie nie będą pasować do Twojej architektury.
Jak skutecznie określać kontekst
Wskaż odpowiednie pliki
Edytory takie jak Cline i Cursor pozwalają odwoływać się do plików za pomocą znaku @. Korzystaj z tej funkcji konsekwentnie:
„Moje kody błędów są zdefiniowane w @errors.ts. Użyj ich jako odniesienia, aby dodać odpowiednią obsługę błędów w @sql.ts, gdzie wykonuję zapytania“
Model widzi teraz rzeczywiste pliki, rozumie Twoje konwencje i generuje kod spójny z Twoją bazą kodu.
Opisz strukturę projektu
Gdy pracujesz nad nowym projektem lub częścią kodu, której model jeszcze nie zna, krótko opisz jego strukturę:
„Projekt wykorzystuje Express z TypeScriptem. Trasy znajdują się w src/routes/, usługi w src/services/, a typy w src/types/. Pracuję nad usługą uwierzytelniania.“
Określ zależności
Jeśli Twój kod korzysta ze specyficznych bibliotek, wspomnij o nich:
„Używam Zod do walidacji, Drizzle jako ORM oraz Pino do logowania. Dodaj walidację do schematu wejściowego w @api/users.ts“
Wyklucz to, co nieistotne
Wykluczenie elementów nieistotnych jest równie ważne jak dostarczenie właściwego kontekstu. Jeśli wskażesz 15 plików przy wprowadzaniu drobnej zmiany, model może się zgubić. Skup się na plikach bezpośrednio zaangażowanych w zadanie.
Przykłady przed i po
Generowanie testów
Bez kontekstu: „Napisz testy dla mojej funkcji walidującej“
Z kontekstem: „Napisz testy Vitest dla funkcji validateUser w @src/validators/user.ts. Dane testowe (fixtures) znajdują się w @tests/fixtures/users.json. Zastosuj ten sam wzorzec, co w @tests/validators/product.test.ts“
Refaktoryzacja
Bez kontekstu: „Zrefaktoryzuj ten kod, żeby był czystszy“
Z kontekstem: „Wyodrębnij logikę ponawiania prób w @src/api/client.ts (linijki 45-78) do wielokrotnego użytku jako helper w @src/utils/retry.ts. Pozostali klienci API w @src/api/ również powinni móc z niego korzystać“
Kluczowe wnioski
- Zawsze odwołuj się do odpowiednich plików za pomocą
@ - W razie potrzeby opisz strukturę projektu
- Wspomnij o używanych zależnościach i konwencjach
- Wyklucz informacje nieistotne, aby uniknąć szumu
- Im precyzyjniejszy kontekst, tym łatwiej zastosować uzyskaną odpowiedź