Claude Code Skills for 1C:Enterprise

Набор скилов, правил и команд для Claude Code: агент правит 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: кадровый учет, средний заработок и начисления, пособия и обмен с СФР, регламентированная отчетность.

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

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

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

• код и запросы - стандарты 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 - заготовка модуля объекта;
• запись <Catalog>Контрагенты</Catalog> в Configuration.xml, то есть объект сразу в составе конфигурации, а не сиротой на диске;
• Validation OK: Catalog.Контрагенты (16 checks) от валидатора набора.

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

Установка

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

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

Скопируйте текст ниже, подставьте свой каталог вместо <КАТАЛОГ> и отдайте агенту в новой сессии. Дальше он все сделает сам: склонирует репозиторий, снимет опись машины, покажет план и поставит только то, что вы выберете.

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

Порядок:
1. Склонируй репозиторий в <КАТАЛОГ>, если он уже там - выполни git pull.
2. Прочитай в нем skills/claude-env-setup/SKILL.md и ОБА файла из
   skills/claude-env-setup/references/ - safety.md и components.md.
   Дальше действуй строго по ним.
3. Сними опись моей машины: что уже установлено, какие MCP-серверы
   прописаны, какие порты заняты, что есть из зависимостей
   (Python, Node, Docker, ffmpeg, платформа 1С).
4. Покажи план таблицей и дождись моего выбора. Ничего не ставь
   до моего ответа.

Ограничения:
- Ничего не перезаписывай молча. Файл, который у меня уже есть
  и отличается, - покажи diff и спроси.
- Конфигурацию MCP (~/.claude/settings.json, ~/.claude.json,
  .mcp.json проекта) правь СЛИЯНИЕМ: добавляй только отсутствующие
  ключи, файл целиком не переписывай.
- Не трогай мои скилы и правила, которых нет в наборе.
- Не завершай запущенные сеансы 1С и EDT, не пересоздавай
  существующие venv и Docker-контейнеры.
- Перед первой правкой любого конфига сделай резервную копию
  с меткой времени.

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

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

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

cp -r skills/* ~/.claude/skills/     # или один скил: cp -r skills/1c-meta-compile ~/.claude/skills/
cp rules/*.md ~/.claude/rules/
cp commands/* ~/.claude/commands/

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

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

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

Проверить, что набор работает: node tests/skills/runner.mjs cases/meta-compile (нужен Node.js 18+).

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

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

Что это меняет на практике: ассистент разрешает ссылки на объекты метаданных, строит иерархии вызовов, спрашивает у EDT выведенный тип в позиции BSL, правит метаданные без ручного XML, ставит точки останова и читает переменные в приостановленной сессии - а результат тут же проверяет валидаторами самой EDT. Ошибка всплывает на месте, а не при первой загрузке конфигурации в базу. Больше сотни операций собраны в фасады code_search, edit_metadata, launch_debugger, diagnostics, insights, security_audit, поэтому клиент видит компактный набор инструментов вместо длинного списка почти одинаковых команд.

Скил ai-edt-tools в этом наборе - каталог этих инструментов и типовых сценариев: что вызывать под задачу, в каком порядке и какие проверки обязательны после правки.

Обратное тоже стоит знать: часть набора не зависит от плагина вообще. 1С 7.7, веб-публикация и тестирование через браузер, правила конвертации данных 2.0 и 3.1, Cleverence, справочники API типовых конфигураций - в AI-EDT ничего этого нет, и там маршрут только через скилы. Базовые операции над исходниками (собрать объект, форму, роль, СКД, расширение, разобрать обработку) тоже идут без EDT и без платформы - плагин добавляет к ним семантику и проверку, но не заменяет их.

Часть проверок, прежде доступных только в EDT, тоже работает по выгрузке. 1c-config-index собирает индекс конфигурации в один JSON, валидаторы читают его параметром -IndexPath и сверяют объект с остальной конфигурацией: типы реквизитов, пути данных формы, состав подсистемы, права роли, наборы данных СКД, имена в запросе, вызовы общих модулей. Это проверка имен: типы выражений, семантика BSL и план запроса без платформы недоступны.

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

Зависимости

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

MCP-серверы, на которые ссылаются скилы

Сами серверы в этот репозиторий не входят - они ставятся и настраиваются отдельно, в .mcp.json проекта или в пользовательских настройках Claude Code. Здесь перечислены ключи ровно в том виде, в каком они пишутся в скилах и правилах, чтобы ссылки читались однозначно.

Скил ai-edt-tools и правила написаны под AI-EDT: ключ сервера ai-edt, инструменты свернуты в фасады с маршрутизацией через operation=. Если у вас подключен другой MCP-плагин для EDT, каталог из references/ к нему неприменим - имена инструментов и их состав там свои: берите фактические из tools/list своей сессии.

Отдельно: 1c-mcp-toolkit - это скил репозитория, а не MCP-сервер. Он ходит в живую базу по HTTP через обработку MCP_Toolkit.epf, поэтому в .mcp.json его прописывать не нужно.

Совместимые сторонние плагины

Основной спутник набора - собственный AI-EDT (см. раздел в начале). Кроме него с набором сочетаются:

bsl-language-server - интеграция BSL Language Server в Claude Code по протоколу LSP: диагностики, go to definition, find references, hover, форматирование, code actions для .bsl и .os.

/plugin marketplace add 1c-syntax/claude-code-bsl-lsp
/plugin install bsl-language-server@bsl-language-server

Плагины Anthropic - code-review и pr-review-toolkit для ревью PR агентами, mcp-server-dev для разработки MCP-серверов, claude-md-management для поддержания CLAUDE.md, security-guidance для security-ревью.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install <name>@claude-plugins-official

Скилы (116)

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

Правила (40)

Команды (5)

Документация (docs/)

Справочные спецификации и руководства для скилов:

Регресс-тесты скилов

Скрипты скилов покрыты снапшот-тестами: скил получает вход, генерирует файлы, результат сравнивается с эталоном. Быстро, файлово, без платформы 1С.

node tests/skills/runner.mjs                       # весь набор
node tests/skills/runner.mjs cases/1c-meta-compile # один скил
node tests/skills/runner.mjs --update-snapshots    # перегенерировать эталоны
node tests/skills/runner.mjs --runtime python      # прогнать python-версии скриптов

Прогон идет в CI на каждый push и pull request - .github/workflows/tests.yml, раннер windows-latest, потому что скриптам нужен PowerShell. Выполняются оба порта и гарды. Интеграционные прогоны идут там же; те из них, которым нужна установленная платформа 1С, раннер пропускает сам.

Рядом со снапшотами работают гарды инвариантов - они проверяют не вывод скилов, а согласованность самих исходников: карты типов метаданных против спецификации, диапазон версий формата, сохранение uuid при правке объекта, разброс продублированных по скилам функций, разбор справочников API линтером, корпус сканера текстов и полноту реестра его категорий, настройку потоков вывода и внешние зависимости скриптов.

node tests/skills/check-all.mjs                    # все гарды разом
node tests/skills/check-type-maps.mjs --list       # что с чем сверяется

Отдельно от снапшотов работает поведенческий прогон скилов tools/run_skill_evals.py: кейс идет дважды, без скила и со скилом, и ответы сравниваются с ожидаемыми и запрещенными строками. Ключ --routing проверяет другое - выбор скила: раскладывает несколько скилов сразу и определяет, чьи файлы агент открыл. Ключ --resume продолжает прерванный заход, не пересчитывая сделанное.

python tools/run_skill_evals.py --skill 1c-bsp-api --runs 3
python tools/run_skill_evals.py --routing tests/routing/config-skills.json --runs 3

Прогон обращается к внешнему агенту и в CI не входит; формат кейса - tools/README-evals.md.

Требуется Node.js 18+. Текущее состояние: 850 кейсов, 0 отказов. На PowerShell проходит 773, 77 пропущено по условиям среды; на python проходит 801, пропущено 49. Порядок работы с тестами - tests/skills/README.md.

Хуки (экспериментально, по умолчанию выключены)

В каталоге hooks/ два хука Claude Code, дополняющие проверки, встроенные в сами скилы:

• support-guard - блокирует прямую правку через Edit/Write объекта типовой конфигурации, стоящего на поддержке поставщика, и в отказе говорит, что делать вместо этого.
• skill-suggester - при ручной работе с исходниками 1С напоминает про профильный скил: при чтении ведет на *-info, при правке - на мутатор. Не блокирует, срабатывает не чаще раза за сессию на группу.

Требуется Node.js 18+. Автоматически не подключаются: порядок ручного включения и настройки - в hooks/README.md.

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

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

Лицензия

MIT