Cursor Skills for 1C:Enterprise

Набор скилов, правил и команд для Cursor IDE: агент правит 1С по формату платформы, а не текстовым поиском по файлам.

Скилы дают агенту готовые операции над исходниками: собрать объект метаданных, форму, роль, схему компоновки, расширение, внешнюю обработку - и разобрать их обратно. Правила задают, как он это делает: стандарты BSL, антипаттерны, требования EDT, работа с БСП. Скрипты правят XML-выгрузку напрямую, поэтому базовые операции идут без запущенной платформы и без Конфигуратора. Вместе с нашим плагином AI-EDT агент получает еще и семантическую модель самой 1C:EDT - об этом ниже.

Проверка результата тоже идет по выгрузке, без внешних инструментов. Четырнадцать валидаторов разбирают XML объекта, формы, роли, схемы компоновки, макета, расширения. Сверх этого 1c-config-index собирает индекс конфигурации, и валидаторы сверяют объект с ОСТАЛЬНОЙ конфигурацией: ссылочные типы реквизитов, пути данных формы, состав подсистемы, права роли, наборы данных СКД, имена таблиц и полей в запросе, вызовы общих модулей. Заимствованная форма расширения сверяется с основной конфигурацией тем же способом. Ни платформа, ни EDT, ни запущенная база для этого не нужны. Границу набор обозначает прямо: это проверка имен и структуры, а типы выражений, семантика BSL и план запроса без платформы недоступны.

Кому пригодится: разработчику 1С, который держит исходники под git и готов отдать агенту рутину - scaffold объектов, разбор чужих обработок, выгрузку и загрузку конфигурации, ревью, тесты.

Кроме скилов в наборе есть справочники API: агент не подбирает имя метода по памяти, а берет его из справочника и проверяет вызов до того, как напишет строку кода. Справочник по БСП (1c-bsp-api) - 2624 метода в 284 модулях Библиотеки стандартных подсистем 3.1.11 и 3.2.1: сигнатуры, типы параметров, контексты выполнения, 372 переопределяемых обработчика; команда check отвергает вызов, которого в библиотеке нет. Рядом с ним прикладные сценарии БСП (1c-ssl-patterns) - 38 справочников по всем 70 темам главы применения документации: каким механизмом решается задача, в каком порядке идут вызовы, какие антипаттерны и различия между версиями. Справочник по ЗУП (zup-hr-api-reference) - 1С:ЗУП 3.1: кадровый учет, средний заработок и начисления, пособия и обмен с СФР, регламентированная отчетность.

Адаптация claude-code-skills-1c для Cursor IDE. Скилы и правила там и здесь одни и те же, различается только формат подключения к среде.

Состав набора

Полный перечень с описанием каждого скила - в разделе Скилы ниже.

И 40 правил (.mdc) - подключаются один раз и действуют во всех задачах, без напоминаний в каждом промпте:

• код и запросы - стандарты BSL, антипаттерны вроде запроса в цикле, оптимизация, чеклист ревью;
• формы, метаданные, EDT - требования к XML форм, целостность MDO, ограничения экспорта из EDT;
• БСП и типовые - вызывать готовые механизмы вместо собственной реализации, размечать правки типовых;
• процесс и сам агент - SDD-workflow, выбор модели под задачу, рабочая память, безопасность git.

Как это выглядит

Справочник с реквизитами и табличной частью. На входе пятнадцать строк JSON:

{
  "type": "Справочник",
  "name": "Контрагенты",
  "codeLength": 11,
  "descriptionLength": 150,
  "hierarchical": true,
  "attributes": [
    "ИНН: Строка(12), index",
    "Покупатель: Булево",
    "ОсновнойМенеджер: СправочникСсылка.Пользователи"
  ],
  "tabularSections": {
    "КонтактныеЛица": ["ФИО: Строка(150), req", "Телефон: Строка(20)"]
  }
}

Один вызов скила 1c-meta-compile - и на диске готовый объект конфигурации:

• Catalogs/Контрагенты.xml - 345 строк со всеми обязательными секциями, стандартными реквизитами и сгенерированными UUID;
• Catalogs/Контрагенты/Ext/ObjectModule.bsl - заготовка модуля объекта;
• запись Контрагенты в Configuration.xml, то есть объект сразу в составе конфигурации, а не сиротой на диске;
• Validation OK: Catalog.Контрагенты (16 checks) от валидатора набора.

Структуру файла агент не выдумывает и не подсматривает в чужих выгрузках: формат зашит в скил.

Установка

Два пути на выбор: попросить агента или сделать руками.

Вариант 1: попросить агента, без единой команды

Скопируйте текст ниже, подставьте свой каталог вместо `` и отдайте агенту в новой сессии. Дальше он все сделает сам: склонирует репозиторий, покажет план и поставит только то, что вы выберете.

Установи мне набор скилов и правил для работы с 1С из репозитория
https://github.com/Desko77/cursor-1c-skills

Порядок:
1. Склонируй репозиторий в , если он уже там - выполни git pull.
2. Прочитай в нем skills/claude-env-setup/SKILL.md и references/safety.md.
   Дальше действуй строго по ним.
3. Спроси, куда ставить: в .cursor/ текущего проекта или глобально
   в ~/.cursor/.
4. Покажи план таблицей и дождись моего выбора. Ничего не ставь
   до моего ответа.
5. Поставь выбранное скриптом install.ps1 из корня репозитория.

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

В конце дай отчет: что поставлено, что не встало и почему,
и отдельным списком - что мне нужно сделать руками.

Этот же путь годится для обновления: агент доставит недостающее и не тронет ваши правки. Готовые промпты под остальные случаи - в skills/claude-env-setup/PROMPT.md.

Вариант 2: руками, если вы знаете, что делаете

.\install.ps1                                         # в .cursor/ текущего проекта
.\install.ps1 -ProjectDir "C:\Projects\my-1c-project" # в конкретный проект
.\install.ps1 -Global                                 # глобально, в ~/.cursor/
.\install.ps1 -RulesOnly                              # только правила
.\install.ps1 -SkillsOnly                             # только скилы

Без скрипта - копированием в .cursor/ вашего проекта:

Copy-Item -Path rules\*    -Destination .cursor\rules\    -Recurse -Force
Copy-Item -Path skills\*   -Destination .cursor\skills\   -Recurse -Force
Copy-Item -Path commands\* -Destination .cursor\commands\ -Recurse -Force

Копирование затрет ваши правки, если вы дорабатывали скилы под себя. На такой машине берите вариант 1: он показывает diff и спрашивает по каждому расхождению.

Первая задача

Откройте проект с исходниками 1С в Cursor и скажите задачу обычными словами: “создай справочник Контрагенты с ИНН и табличной частью контактных лиц”. Скил агент подберет сам.

AI-EDT: агентная разработка прямо в 1C:EDT

Набор раскрывается полностью вместе с AI-EDT - MCP-сервером, который работает плагином внутри запущенной 1C:EDT и дает ассистенту не текст файлов, а семантическую модель самой среды.

Ассистент разрешает ссылки на объекты метаданных, строит иерархии вызовов, спрашивает у EDT выведенный тип в позиции BSL, правит метаданные без ручного XML, ставит точки останова и читает переменные в приостановленной сессии - а результат тут же проверяет валидаторами самой EDT. Скил ai-edt-tools в этом наборе - каталог его инструментов и типовых сценариев.

Типовые сценарии

Зависимости

Скилы спроектированы по слоям - базовые (генерация XML) работают без платформы, продвинутые требуют 1С или MCP.

Скилы (115)

Начать проще всего с 1c-config-router: он сам определяет, каким скилом или workflow решать задачу.

Правила (40)

Команды (5)

Отличия от Claude Code версии

Синхронизация с исходным репо

При обновлении claude-code-skills-1c можно перегенерировать этот репо:

python tools/convert_from_claude.py --source ../claude-code-skills-1c --target .

Лицензия

MIT. Основа набора - Nikolay-Shirokov/cc-1c-skills (MIT, Nick Shirokov): скилы работы с XML-форматами конфигуратора и командной строкой платформы получены оттуда и доработаны. Уведомление об авторских правах сохранено в LICENSE.md.

История версий

Что изменилось по версиям - CHANGELOG.md.