Правила и команды в Cursor

В Cursor роль навыков играют Rules (правила) и кастомные команды. Они задают агенту поведение и контекст: как писать код, каких соглашений держаться, что делать в определённых ситуациях.

Rules в .cursor/rules

Правила проекта лежат в папке .cursor/rules и версионируются вместе с кодом. Каждое правило - файл .mdc: YAML-frontmatter сверху, дальше Markdown с инструкциями. Это пришло на смену старому единому файлу .cursorrules, и так удобнее управлять областью действия каждого правила.

.cursor/
  rules/
    api-style.mdc
    testing.mdc

Frontmatter правила

У .mdc-файла три поля в шапке, и они определяют, когда правило включается.

---
description: Правила для платёжных флоу Stripe. Применять при работе с оплатой и подписками.
globs: src/payments/**
alwaysApply: false
---

- Все суммы хранить в копейках, целым числом.
- Любой запрос к Stripe оборачивать в обработку ошибок.

Четыре режима активации

• Always Apply - правило в каждом разговоре (alwaysApply: true). Держите такие правила короткими: каждый их токен тратится в каждом запросе.
• Auto Attached - правило подключается, когда в контексте есть файлы под globs.
• Agent Requested - агент сам решает по description, нужно ли правило. Поэтому описание должно ясно говорить, в каком случае правило применять.
• Manual - правило подключается вручную упоминанием @имя-правила.

Кастомные команды

Кроме правил, в Cursor есть кастомные команды - заранее заготовленные промпты и процедуры, которые вы запускаете по имени. Это ближе всего к навыку как переиспользуемому действию: один раз описали шаги, дальше вызываете командой, а не печатаете заново.

На что обратить внимание

• Пишите description так, будто объясняете человеку, когда брать правило. "Платёжные флоу Stripe" - годится. "Для штук про оплату" - нет.
• Не делайте всё через alwaysApply. Глобальных правил должно быть мало и они короткие.
• Точные globs экономят контекст: правило про API появляется, только когда вы реально в папке API.