Упоминания контекста (@file, @folder, @codebase)

1. Обзор концепции и системная проблема

Когда вы работаете над большим проектом из 100 файлов и пишете в чат: «Почини кнопку авторизации», модель оказывается в замешательстве. В каком из 10 файлов находится эта кнопка? Какой стиль она использует? Где хранятся пароли?

Упоминания контекста (символ @) — это инструмент хирурга в вайбкодинге. Подобно тому, как вы тегаете друзей в Telegram или Instagram через знак @, в редакторах Cursor и Windsurf вы можете тегать ресурсы вашего проекта.

Нажав @, вы открываете список подсказок и четко говорите модели: «Вот посмотри на @Header.tsx и используй цвета из @theme.ts».

Практическая аналогия: главный навык, который спасает от галлюцинаций и сокращает время ожидания ответа в три раза.

2. Полный список упоминаний и их назначение

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

3. Как правильно использовать упоминания (Примеры)

01. Исправление конкретного компонента

Не пишите общих фраз. Напишите:

«Посмотри на @LoginForm.tsx. Сделай так, чтобы при неправильном пароле появлялось красное предупреждение под полем ввода».

02. Создание нового кода по образцу существующего

Если вы хотите создать новую страницу в том же стиле, что и старая:

«Создай новую страницу @src/app/about/page.tsx по точно такой же структуре и стилям, как сделано в @src/app/contact/page.tsx».

03. Разбор ошибки из терминала

Если в консоли появилось красное сообщение об ошибке, напишите в чат:

«Вот ошибка из @Terminal. Объясни, в каком файле возник сбой и как его исправить».

4. Почему точечный контекст лучше полного @codebase

Чем меньше ненужных файлов вы передаете в модель, тем чище ее внимание. Если задача касается одной кнопки, указание конкретного @Button.tsx даст в 10 раз лучший результат, чем поиск по всему хранилищу кода.