Kontextsteuerung (@file, @folder, @codebase)

1. Überblick über das Konzept und den Zweck

Wenn Sie an einem großen Projekt mit 100 Dateien arbeiten und in den Chat schreiben: „Behebe den Login-Button“, gerät das Modell oft ins Stolpern. In welcher der zehn Dateien befindet sich dieser Button? Welchen Stil verwendet er? Wo werden Passwörter gespeichert?

Kontext-Mentions (Symbol @) sind das Skalpell im Vibe-Coding. Ähnlich wie Sie Freunde in Telegram oder Instagram über das Zeichen @ taggen, können Sie in den Editoren Cursor und Windsurf Ressourcen Ihres Projekts taggen.

Durch Drücken von @ öffnen Sie eine Vorschlagsliste und weisen das Modell präzise an: „Schau dir @Header.tsx an und verwende die Farben aus @theme.ts“.

Praktische Analogie: Die Kernkompetenz, die vor Halluzinationen schützt und die Antwortzeit auf ein Drittel verkürzt.

2. Vollständige Liste der Mentions und ihre Bestimmung

┌─────────────────────────────────────────────────────────────┐
│                 МЕНЮ МЕНШЕНІВ У РЕДАКТОРАХ КОДУ             │
├─────────────────────────────────────────────────────────────┤
│ 📄 @Files:                                                  │
│    Прикріплює точний файл: наприклад `@Button.tsx`          │
│    (Найкраща точність, мінімум зайвих токенів)              │
├─────────────────────────────────────────────────────────────┤
│ 📁 @Folders:                                                │
│    Прикріплює всю папку: наприклад `@src/components`        │
│    (Коли потрібно переглянути всі суміжні компоненти разом) │
├─────────────────────────────────────────────────────────────┤
│ 🌐 @Codebase:                                               │
│    Сканує весь проект через векторний пошук                 │
│    (Ідеально для запитань: «Де в проекті обробляється API?»)│
├─────────────────────────────────────────────────────────────┤
│ 📚 @Docs:                                                   │
│    Підключає офіційну свіжу документацію фреймворків        │
├─────────────────────────────────────────────────────────────┤
│ 💻 @Terminal:                                               │
│    Передає в чат текст останньої помилки з консолі          │
└─────────────────────────────────────────────────────────────┘

3. Richtige Verwendung von Mentions (Beispiele)

01. Korrektur einer spezifischen Komponente

Vermeiden Sie vage Formulierungen. Schreiben Sie stattdessen:

„Analysiere @LoginForm.tsx. Sorge dafür, dass bei einem falschen Passwort eine rote Warnung unter dem Eingabefeld erscheint.“

02. Erstellung neuen Codes basierend auf bestehenden Vorlagen

Wenn Sie eine neue Seite im gleichen Stil wie eine bestehende erstellen möchten:

„Erstelle eine neue Seite @src/app/about/page.tsx mit exakt derselben Struktur und denselben Stilen wie in @src/app/contact/page.tsx definiert.“

03. Analyse eines Terminal-Fehlers

Falls in der Konsole ein roter Fehlerblock erscheint, geben Sie im Chat ein:

„Hier ist der Fehler aus @Terminal. Erkläre, in welcher Datei der Absturz aufgetreten ist und wie man ihn behebt.“

4. Warum gezielter Kontext besser ist als ein globales @codebase

Je weniger irrelevante Dateien Sie an das Modell übergeben, desto fokussierter bleibt dessen Aufmerksamkeit. Wenn die Aufgabe nur einen einzelnen Button betrifft, liefert die explizite Nennung von @Button.tsx ein zehnmal besseres Ergebnis als eine Suche im gesamten Code-Repository.