Skip to main content
← Back

Правила

Правила задают для Agent постоянные инструкции для вашего проекта. Они помогают Agent всегда следовать вашему стилю кодирования, шаблонам и рабочим процессам, без необходимости повторять их в чате.

Что такое правило?

Правило — это постоянный набор инструкций, которым Agent следует при работе над вашим проектом. Правила можно задавать глобально, для проекта или для конкретных файлов.

Как создать правило проекта?

Правила проекта хранятся в вашей кодовой базе и находятся под контролем версий. Вся команда выигрывает, если добавить их в Git.

  1. Откройте палитру команд:
    • Mac: Нажмите CmdCtrl + Shift + P
    • Windows/Linux: Нажмите Ctrl + Shift + P
  2. Введите «New Cursor Rule» и выберите этот пункт
  3. Задайте имя правила (например, react-patterns)
  4. Напишите инструкции в Markdown. Например: 
    - Используйте TypeScript для всех новых файлов- Отдавайте предпочтение функциональным компонентам в React- Используйте snake_case для столбцов базы данных
  5. В выпадающем списке типа выберите, когда применять правило:
    • Применять всегда: включается в каждый диалог
    • Применять интеллектуально: Agent сам определяет, когда правило актуально
    • Применять к определённым файлам: применяется только к файлам, соответствующим шаблону (например, *.tsx)
    • Применять вручную: используется только при @упоминании в чате
  6. Сохраните файл. Он будет храниться в .cursor/rules/ вашего проекта.

Как настроить пользовательские правила?

Пользовательские правила — это глобальные настройки, действующие во всех ваших проектах. Они синхронизируются с вашим аккаунтом Cursor на разных устройствах.

  1. Откройте Customize на боковой панели
  2. Нажмите Правила
  3. Добавьте свои предпочтения. Например: «Отвечайте кратко. Избегайте ненужных повторов».

Как использовать AGENTS.md?

Создайте файл AGENTS.md в корне проекта. Добавьте инструкции в обычном формате Markdown. Cursor автоматически его обнаружит.

# Инструкции проекта- Use TypeScript for all new files- Follow the repository pattern for data access- Keep components under 200 lines

Чтобы точнее контролировать, когда применяются правила, используйте правила проекта в .cursor/rules/.

Рекомендации по написанию правил

  • Объём правил не должен превышать 500 строк. Разделяйте большие правила на небольшие тематические файлы.
  • Включайте в правила конкретные примеры или файлы-справочники с помощью @filename.
  • Начинайте с малого. Добавляйте правила, если Agent допускает одну и ту же ошибку несколько раз.
  • Добавляйте правила в git, чтобы ими могли пользоваться и ваши коллеги.

Как организовать файлы правил?

Храните все правила в одном каталоге .cursor/rules/ без вложенных папок. Cursor обнаруживает правила при сканировании этой папки: вложенные подпапки поддерживаются, но плоская структура проще и удобнее в управлении. Используйте понятные имена файлов (например, react-patterns.mdc, api-validation.mdc).

В больших проектах разбивайте правила на тематические файлы вместо одного длинного правила. Каждый файл должен охватывать один аспект, например соглашения по стилю, шаблоны тестирования или рекомендации по API.

Где хранятся правила?

  • Правила проекта хранятся в .cursor/rules/ в каталоге проекта. Они версионируются с помощью git.
  • Пользовательские правила в настройках Cursor хранятся в вашем аккаунте Cursor. Они действую�� во всех ваших проектах и синхронизируются при входе в систему на другом компьютере.
  • Файлы пользовательских правил в ~/.cursor/rules (Windows: %USERPROFILE%\.cursor\rules) остаются на компьютере и не синхронизируются.
  • Правила команды хранятся на серверах Cursor и управляются с панели управления командой. Они автоматически синхронизируются у всех участников команды. Правила команды поддерживают glob-шаблоны, поэтому можно ограничить действие правила определёнными типами файлов (например, **/*.py).

Пользовательские правила и правила команды не включаются в экспорт профиля. При входе в систему на новом компьютере синхронизируются пользовательские правила вашего аккаунта.

Как работают правила команды?

Тарифы Team и Enterprise позволяют создавать и применять правила для всей организации в дашборде Cursor.

  • Обязательные правила применяются ко всем участникам, и их нельзя отключить в настройках.
  • Необязательные правила включены по умолчанию, но участники могут отключить их в разделе Customize > Правила.
  • Правила команды поддерживают glob-шаблоны (например, **/*.py), чтобы ограничить правило определёнными типами файлов.
  • При конфликте правил приоритет следующий: правила команды > правила проекта > пользовательские правила.

Правила команды представляют собой текст произвольного формата. Они не используют структуру папок правил проекта и автоматически синхронизируются у всех участников.

Как перейти с .cursorrules?

Файл .cursorrules в корне проекта устарел и вскоре будет упразднён. Для перехода:

  1. Создайте новое правило с помощью палитры команд: найдите «New Cursor Rule»
  2. Скопируйте содержимое .cursorrules в новый файл правила
  3. Задайте тип правила Применять всегда (это соответствует прежнему поведению)
  4. Удалите файл .cursorrules из корня проекта

Как работает CLAUDE.md в Cursor?

Cursor читает файлы CLAUDE.md так же, как AGENTS.md. Поместите файл CLAUDE.md в корневую папку проекта — Cursor обнаружит его автоматически.

Файлы CLAUDE.md всегда применяются ко всем диалогам независимо от значения параметра фронтматтера alwaysApply. Это обеспечивает совместимость с проектами, в которых также используется Claude Code. Если вам нужны условные правила, используйте правила проекта в .cursor/rules/.

Как работают правила с одинаковыми именами в разных папках?

Cursor различает правила по полному пути к файлу, а не только по имени. Оба правила с одинаковым именем файла в разных папках применяются, если выполняются их условия. Конфликтов или переопределений из-за имени файла не возникает.

Что делать, если правило не применяется?

Проверьте тип правила. Для Apply Intelligently убедитесь, что вы добавили описание, чтобы Agent знал, когда применять правило. Для Apply to Specific Files убедитесь, что шаблон файлов соответствует файлам, с которыми вы работаете.

Правила применяются только к Agent (Chat). Они не применяются к Tab completion, Inline Edit или PR-ревью в Bugbot.

Связанные материалы

Была ли эта статья полезной?