Правила предоставляют системные инструкции для Agent и Inline Edit. Думайте о них как о постоянном контексте, предпочтениях или рабочих процессах для ваших проектов. Cursor поддерживает три типа правил:

Правила проекта

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

Пользовательские правила

Глобальные для вашей среды Cursor. Определяются в настройках и всегда применяются.

.cursorrules (Устаревший)

Все еще поддерживается, но устарел. Используйте вместо этого Правила проекта.

​
Как работают правила

Большие языковые модели не сохраняют память между завершениями. Правила обеспечивают постоянный, многократно используемый контекст на уровне промпта. При применении содержимое правил включается в начало контекста модели. Это дает ИИ последовательное руководство для генерации кода, интерпретации правок или помощи с рабочими процессами.
Rule applied in context with chat
Правила применяются к Chat и Inline Edit. Активные правила отображаются на боковой панели Agent.

​
Правила проекта

Правила проекта находятся в .cursor/rules. Каждое правило представляет собой файл и контролируется версиями. Они могут быть ограничены с помощью шаблонов путей, вызваны вручную или включены на основе релевантности. Подкаталоги могут включать свой собственный каталог .cursor/rules, ограниченный этой папкой. Используйте правила проекта для:
  • Кодирования специфических знаний о вашей кодовой базе
  • Автоматизации специфических для проекта рабочих процессов или шаблонов
  • Стандартизации решений по стилю или архитектуре

​
Анатомия правила

Каждый файл правила написан в формате MDC (.mdc), формате, поддерживающем метаданные и содержимое. Управляйте тем, как применяются правила, из выпадающего списка типов, который изменяет свойства description, globs, alwaysApply.
Тип правилаОписание
AlwaysВсегда включено в контекст модели
Auto AttachedВключается, когда ссылаются на файлы, соответствующие шаблону glob
Agent RequestedДоступно для ИИ, который решает, включать ли его. Должно предоставлять описание
ManualВключается только при явном упоминании с использованием @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts
Ссылочные файлы, такие как @service-template.ts, включаются как дополнительный контекст при срабатывании правила.

​
Вложенные правила

Организуйте правила, размещая их в каталогах .cursor/rules по всему вашему проекту. Вложенные правила автоматически присоединяются, когда ссылаются на файлы в их каталоге. 
project/
  .cursor/rules/        # Правила для всего проекта
  backend/
    server/
      .cursor/rules/    # Правила, специфичные для backend
  frontend/
    .cursor/rules/      # Правила, специфичные для frontend

​
Создание правила

Создавайте правила с помощью команды New Cursor Rule или перейдя в Cursor Settings > Rules. Это создает новый файл правила в .cursor/rules. Из настроек вы можете видеть все правила и их статус.
Сравнение кратких и длинных правил

​
Генерация правил

Генерируйте правила прямо в разговорах, используя команду /Generate Cursor Rules. Полезно, когда вы приняли решения о поведении агента и хотите их переиспользовать.

​
Лучшие практики

Хорошие правила должны быть сфокусированными, практичными и ограниченными по области применения.
  • Держите правила в пределах 500 строк
  • Разделяйте большие правила на несколько компонуемых правил
  • Предоставляйте конкретные примеры или ссылки на файлы
  • Избегайте расплывчатых указаний. Пишите правила как четкую внутреннюю документацию
  • Переиспользуйте правила при повторении промптов в чате

​
Примеры

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

​
Пользовательские правила

Пользовательские правила — это глобальные настройки, определенные в Cursor Settings → Rules, которые применяются ко всем проектам. Они представляют собой обычный текст и идеально подходят для установки предпочитаемого стиля общения или соглашений по кодированию: 
Please reply in a concise style. Avoid unnecessary repetition or filler language.

​
.cursorrules (Устаревший)

Файл .cursorrules в корне вашего проекта по-прежнему поддерживается, но будет объявлен устаревшим. Мы рекомендуем перейти на Правила проекта для большего контроля, гибкости и наглядности.

​
Часто задаваемые вопросы