Mniejszenie kontekstu (@file, @folder, @codebase)
Mechanizm precyzyjnego zarządzania kontekstem w nowoczesnych edytorach AI (Cursor, Windsurf). Umożliwia szybkie dołączanie do zapytania konkretnych plików (@file), całych folderów (@folder), dokumentacji (@docs) lub całego projektu (@codebase) za pomocą symbolu @.
1. Przegląd koncepcji i przeznaczenia
Gdy pracujesz nad dużym projektem liczącym 100 plików i wpisujesz w czacie: «Napraw przycisk autoryzacji», model wpada w konsternację. W którym z 10 plików znajduje się ten przycisk? Jakiego stylu używa? Gdzie przechowywane są hasła?
Mentiony kontekstu (symbol @) to narzędzie chirurga w vibe codingu. Podobnie jak oznaczasz znajomych na Telegramie czy Instagramie za pomocą znaku @, w edytorach Cursor i Windsurf możesz oznaczać zasoby swojego projektu.
Naciśnięcie @ otwiera listę podpowiedzi, pozwalając precyzyjnie wskazać modelowi: «Spójrz na @Header.tsx i użyj kolorów z @theme.ts».
Praktyczna analogia: kluczowa umiejętność, która chroni przed halucynacjami i skraca czas oczekiwania na odpowiedź trzykrotnie.
2. Pełna lista mentionów i ich przeznaczenie
┌─────────────────────────────────────────────────────────────┐
│ MENUS ZMIENNYCH W EDYTORACH KODU │
├─────────────────────────────────────────────────────────────┤
│ 📄 @Files: │
│ Dołącza konkretny plik, np. `@Button.tsx` │
│ (Najlepsza precyzja, minimalna liczba zbędnych tokenów) │
├─────────────────────────────────────────────────────────────┤
│ 📁 @Folders: │
│ Dołącza cały folder, np. `@src/components` │
│ (Gdy trzeba przeanalizować wszystkie powiązane komponenty)│
├─────────────────────────────────────────────────────────────┤
│ 🌐 @Codebase: │
│ Skanuje cały projekt za pomocą wyszukiwania wektorowego │
│ (Idealne do pytań typu: „Gdzie w projekcie obsługuje się API?”)│
├─────────────────────────────────────────────────────────────┤
│ 📚 @Docs: │
│ Łączy z oficjalną, aktualną dokumentacją frameworków │
├─────────────────────────────────────────────────────────────┤
│ 💻 @Terminal: │
│ Przekazuje do czatu tekst ostatniego błędu z konsoli │
└─────────────────────────────────────────────────────────────┘
3. Jak prawidłowo korzystać z mentionów (przykłady)
01. Naprawa konkretnego komponentu
Nie pisz ogólnikowych fraz. Zamiast tego napisz:
«Sprawdź
@LoginForm.tsx. Spraw, aby przy błędnym haśle pojawiało się czerwone ostrzeżenie pod polem input».
02. Tworzenie nowego kodu na wzór istniejącego
Jeśli chcesz stworzyć nową stronę w tym samym stylu co stara:
«Utwórz nową stronę
@src/app/about/page.tsxo dokładnie takiej samej strukturze i stylach jak te zastosowane w@src/app/contact/page.tsx».
03. Analiza błędu z terminala
Jeśli w konsoli pojawił się czerwony tekst błędu, wpisz w czacie:
«Oto błąd z
@Terminal. Wyjaśnij, w którym pliku wystąpiła awaria i jak ją naprawić».
4. Dlaczego punktowy kontekst jest lepszy niż pełny @codebase
Im mniej zbędnych plików przekazujesz do modelu, tym czystsza jego uwaga. Jeśli zadanie dotyczy jednego przycisku, wskazanie konkretnego @Button.tsx da dziesięciokrotnie lepsze rezultaty niż przeszukiwanie całego repozytorium kodu.
FAQ: Mniejszenie kontekstu (@file, @folder, @codebase)
Powiązane pojęcia
Kontekstowa kuracja i higiena reguł
Praktyka inżynieryjna polegająca na projektowaniu, regularnym audycie i czyszczeniu plików konfiguracyjnych zachowań agenta (.cursorrules, .clinerules, AGENTS.md) w celu zapobiegania degradacji uwagi modelu.
Cursor Composer (Wieloplikowa edycja agentowa)
Flagowy tryb agenta w edytorze kodu Cursor (Ctrl+I / Cmd+I). Pozwala sztucznej inteligencji jednoczesne tworzenie, modyfikowanie i łączenie dziesiątek plików projektu, wykonywanie poleceń w terminalu oraz sprawdzanie błędów.
Rozmiar okna kontekstowego (Pamięć bieżącej rozmowy)
Maksymalna objętość tekstu (w tokenach), którą model językowy jest w stanie jednoczesnie utrzymać w pamięci podczas bieżącej sesji. Określa, jaką długość dokumentów można załadować jednorazowo bez utraty treści.