Cursor: контекст через @file, @folder, @web, @docs
Символ @ в чате Cursor задаёт агенту контекст. @file добавляет один файл, @folder целую папку, @web ищет свежее в сети, @docs тянет документацию конкретной библиотеки. Чем точнее вы задали контекст, тем меньше галлюцинаций и токенов впустую.
Что делает каждая команда
| Команда | Что добавляет в контекст |
|---|---|
| @file | один файл целиком |
| @folder | вся папка |
| @web | свежий поиск в сети |
| @docs | документация конкретной библиотеки |
@file и @folder
Это базовый способ сказать агенту, с чем он работает. Если задача касается пары файлов, добавьте именно их через @file. Если правка разбросана по модулю, добавьте папку через @folder. Так агент не будет гадать по названию функции и реже зайдёт не туда.
@web и @docs
@web полезен, когда нужна свежая информация, которой нет в обучении модели, текущая версия API, новости библиотеки. @docs тянет официальную документацию конкретной библиотеки и сильно снижает число галлюцинаций по её методам.
Чем меньше, тем лучше
Соблазн добавить в контекст всё сразу большой, но каждое лишнее упоминание раздувает запрос и путает агента. Давайте ровно то, что относится к задаче, и убирайте лишнее, когда перешли к новой теме.
Частые вопросы
Как дать Cursor контекст по конкретному файлу?
Напишите в чате @file и выберите нужный файл. Аналогично @folder для целой папки.
Чем @web отличается от @docs в Cursor?
@web ищет свежее в сети, @docs тянет официальную документацию конкретной библиотеки, что снижает число галлюцинаций по её методам.