Skill vs Rule · 3 уровня загрузки · SKILL.md · Runbook 6 шагов · Mac 7×24
"Помощник по программированию с использованием искусственного интеллекта" в 2024–2025 годах по сути будет представлять собой завершение разговора, требующее от вас каждый раз заново объяснять контекст, ограничения и шаги. В 2026 году Агенты курсоров (улучшения навыков 2,4+) будут выполнять задачи: читать репозитории, изменять несколько файлов, вызывать инструменты и выполнять работу в соответствии с командными правилами. Знания должны представлять собой нечто большее, чем просто историю чата, и должны экстернализироваться в виде пакета навыков с поддержкой версий.
Навык агента — это папка в .cursor/skills/ или на уровне пользователя ~/.cursor/skills/. Ядро — это SKILL.md (интерфейс YAML + тело Markdown), к которому вы можете прикрепить скрипты/, ссылки/, шаблоны и контрольные списки. На этапе обнаружения агент считывает только имя и описание, а после сопоставления с задачей он активируется и загружает полный текст и все необходимые вспомогательные файлы по запросу. Не помещайте в контекст одновременно 50 страниц модулей Runbook.
.cursor/rules Если вы напишете «комментарии запрещены» и «требуется pnpm», это полное ограждение. Если один и тот же «выпуск + проверка кода + обновление документации» повторяется 3 раза в неделю, если вы продолжите продлевать правило, вы будете платить больше токенов за разговор, и им будет сложно поделиться с коллегами. Навык — это повторное использование потока, а Правило — это граница поведения. Они будут сравниваться в таблице в следующем разделе.
Длинные запросы не могут быть версионированы:Хорошие инструкции разбросаны по Notion и т. д. и не могут быть прочитаны агентом. Изменения, сделанные в одном месте, не доходят до всей команды.
Раздувание контекста. Вставка всего модуля Runbook в беседу занимает место для кода и различий, что приводит к обрезанию длинных задач.
Нестабильность триггера:Структурированное предложение маршрутизации description отсутствует, и агент не может определить, какое руководство открыть.
Нет пошагового раскрытия:длинные скрипты и документация по API, полная оплата токена даже за простые подзадачи.
Невозможно повторно использовать командой:Невозможно просматривать, объединять и откатывать успешный опыт отдельных чатов, таких как Git.
Правила – правила дорожного движения, размещенные на лобовом стекле; Навыки — это инструкции по эксплуатации автомобиля: Вам не придется перелистывать каждую страницу, чтобы найти проблему.
Правила Cursor (.cursor/rules/*.mdc) внедряются всегда или по glob в начале сессии: стиль кода, безопасность, структура репозитория. Agent Skills следуют открытому стандарту agentskills.io (с 2025 года) и подходят для многошаговых workflow, доменных знаний и исполняемых скриптов.
ссылках/ для чтения по требованию. scripts/validate.sh в песочнице и возвращает результат в диалог. Сообщество имеет официальные/полуофициальные навыки, такие как создать-крючок, создать-правило, присмотр за детьми (слияние PR и CI) и разделение PR. Связь с MCP: MCP подключается к внешним системам, а навыки сообщают агентам, когда и в каком порядке использовать инструменты — в совокупности, а не по отдельности.
Следующее было проверено с помощью Cursor 2.4+. Создайте скелет с помощью встроенного /create-skill и объедините его в соответствии с правилами команды. Моя цель — сделать папку «Подсказка, которую я наконец-то смог написать с третьей попытки» доступной для просмотра папкой в репозитории.
Введите /create-skill в разговоре с агентом:опишите тип задачи, триггерное слово, входные/выходные данные и противопоказания, а также создайте первую версию SKILL.md и дерево каталогов.
Выберите область: Уровень проекта .cursor/skills/<skill-name>/, общий для Git. Личный класс ~/.cursor/skills/ предназначен для межрепозиторий (не фиксирует закрытый ключ).
Напишите описание для заголовка:Это не краткое описание, а ключ маршрутизации. Напишите «ИСПОЛЬЗОВАТЬ, когда пользователь просит…» и «НЕ использовать для…», чтобы повысить точность сопоставления на этапе обнаружения.
Текст – это пошаговое раскрытие информации.Основные шаги описаны в SKILL.md. Длинный текст, OpenAPI, образец JSON в references/, скрипт в скрипты/.
Проверьте триггер: Проверьте 3 положительных примера (должны быть активированы) и 2 противоположных примера (не активированы) в новом сеансе. Проверьте, указаны ли в Контексте только необходимые файлы.
Перенос старых ресурсов: Для раздутых правил и одноразовых команд используйте /migrate-to-skills (или разделите вручную), чтобы переместить тип потока в "Навыки". Правило оставляет только короткую красную линию.
--- name: release-pr-runbook description: USE when the user asks to open a release PR, ship a version bump, or run pre-merge checklist. DO NOT use for hotfix without changelog or dependency-only bumps. --- # Release PR Runbook ## Gather - Read package.json version and recent git tags. - List open PRs targeting main. ## Act - Bump version per semver. - Update CHANGELOG.md with user-facing bullets. ## Verify - Run test suite and lint. - Confirm CI green before requesting review.
SKILL.mdnamedescriptionскрипты/ссылки/assets/Реализация навыков Cursor соответствует agentskills.io и может быть организована на три уровня: она напрямую связана с биллингом токенов и стабильностью.
Обнаружение:При запуске или сканировании загружаются только имя + описание (приблизительно несколько десятков токенов на каждый навык) каждого навыка, образуя «доступный ручной каталог».
Активация:После намерения пользователя или соответствия ключевого слова вставьте полный текст SKILL.md (обычно от сотен до тысяч токенов).
По требованию: Загрузка/запуск только тогда, когда ссылка в теле указывает на references/*.md или вызывает scripts/*. Не «каждый раз полностью открывайте толстую книгу».
В дизайне навыков поместите дерево решений в первую половину текста (сначала определите сцену A/B), а толстые материалы перейдите к ссылкам. Если выходные данные сценария велики, навык просит агента вернуть сводку только важных строк, а не вставлять полный текст обратно в контекст.
Имя: Если вы напишете описание как маркетинговое резюме, количество ложных срабатываний увеличится. Правила маршрутизации (условие + исключение). Официальный навык создания будет неоднократно запрашивать триггерное слово — оно того стоит.
Навык высокого качества следует четырем принципам. Три этапа: основное описание, постепенное раскрытие, единая ответственность (1 навык, 1 тип задачи) и собрать-действовать-проверить. Не дублируйте правила: правило — «Требуется тест», а навык — «Шаги по запуску интеграционных тестов в этом репозитории и чтению журналов ошибок».
SKILL.md. /create-skill, /migrate-to-skills в рабочий процесс по умолчанию. description — это не краткое изложение статьи, а предикат маршрутизации — подчеркивается в официальной документации и руководстве по созданию навыков. Примечание. Не указывайте секретные ключи или персональные данные клиента в описании (всегда видно на уровне L1). Скрипты используют переменные среды. gitignore конфиденциальное приложение references/ и объясните, как его получить, в тексте навыка.
Экосистема навыков не ограничивается одной IDE. agentskills.io предоставляет стандарты, концепции проверки и точку входа в индекс, которая позволяет командам субмодулировать и публиковать внутренние навыки (аналогично внутреннему npm). Реалистичный путь для отдельных разработчиков — это сформировать навык, близкий к сообществу → скорректировать описание и ссылки/ → просмотреть разницу в PR.
Навыки расширяются от «помощи в написании кода» до автоматизации 7×24 ——/loop для запланированного сканирования репозитория, Telegram/Slack для /mac-quote, Cursor SDK запускает резидентного агента на стороне сервера — выбор хоста влияет на сложный процент навыка.
~/.cursor/skills в течение длительного периода времени как «организационную память». Типовой сетап: фиксированный clone проекта и submodule Skills на арендованном Mac; после merge Hook гоняет scripts/verify.sh. IM-бот шлёт intent, тяжёлую работу делает Mac по Skill — та же «агент как инфра», что Hermes Gateway 7×24 и персистентная память, только ближе к ежедневному IDE-потоку.
Ноутбука и дешёвого VPS хватает на написание Skill и разовый прогон, но sleep, отсутствие нативной macOS-автоматизации и незакреплённый ~/.cursor убивают 7×24. Чисто API-скиллы живут в облаке; как только runbook требует Keychain или Apple-стек — миграция больно бьёт по времени. Команды, которые хотят «резидента-коллегу» с накоплением token savings неделями, упаковывают uptime, remote KVM и фикс OpEx в облачную аренду VpsMesh Mac Mini M4. Цены: цены аренды Mac Mini M4, помощь: центр помощи, заказ: оформить заказ.
MCP (Model Context Protocol) — протокол подключения к внешним системам: БД, GitHub API, браузер, микросервисы. Agent Skill не заменяет MCP, а задаёт Runbook в Markdown: что собрать, какие MCP-инструменты вызвать и в каком порядке, как проверить результат. MCP — розетка и кабель; Skill — процедура запуска из руководства.
Короткое правило, которому следует следовать каждый раз, когда вы пишете код, — это Правило (комментарии запрещены, требуется назначенный менеджер пакетов и т. д.). Потоки, которые «выполняются время от времени, состоят из большого количества шагов и требуют сценариев и приложений», относятся к Навыкам. Эмпирическое правило: если одно и то же длинное приглашение появляется в третий раз, /create-skill. Общее количество правил должно быть небольшим, чтобы сессия не заполнялась на уровне L0. Часть потока правила гипертрофии можно переместить в навык с помощью /migrate-to-skills.
Не требуется. Чистый облачный API, независимый от macOS Skill можно запланировать на Linux VPS из Cursor CLI/SDK. Если вы не хотите отключать Apple Eco Automation, локальную связку ключей и ~/.cursor/skills, закрывая крышку, например Gateway, можно легко воспользоваться ежемесячной платой за Mac Mini M4. Сначала проверьте триггер и кривую токена при месячной аренде. Стоимость составляет аренда Mac Mini M4, а приложение – страница заказа.