Claude Code Skills 1c

Claude Code Skills for 1C:Enterprise

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

[](LICENSE) [](https://github.com/Desko77/claude-code-skills-1c/releases) [](https://github.com/Desko77/claude-code-skills-1c/actions/workflows/tests.yml)

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

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

Отдельный класс - справочники API прикладных конфигураций. Агент не угадывает, какой метод типовой вызвать, а берет его из справочника. Первый такой скил - zup-hr-api-reference для 1С:ЗУП 3.1: кадровый учет, средний заработок и начисления, пособия и обмен с СФР, регламентированная отчетность.

Что умеет

| Группа | Что делает | Скилов | |--------|------------|--------| | Маршрутизатор | подсказывает, каким скилом решать задачу | 1 | | Конфигурация | создать с нуля, изменить свойства, проанализировать, прочитать состояние поддержки | 7 | | Объекты метаданных | собрать из JSON, разобрать обратно в JSON, править реквизиты и табличные части | 6 | | Управляемые формы | собрать из DSL или по метаданным объекта, править, разобрать, проверить | 8 | | Расширения | создать, заимствовать объект, поставить перехватчик на метод, сверить с основной | 6 | | Обработки и отчеты | собрать .epf и .erf из исходников и разобрать обратно | 10 | | Базы данных | создать, выгрузить и загрузить .cf, .dt и XML, обновить, запустить | 11 | | Роли, подсистемы, макеты, СКД, XDTO | сборка и разбор своим DSL под каждый вид | 25 | | Веб-публикация и тестирование | опубликовать базу через Apache, прогнать сценарий в браузере | 5 | | БСП, 1С 7.7, обмены | поиск функций БСП, разработка под 7.7, правила КД 2.0 и 3.1 | 7 | | Справочные и утилитарные | документация платформы, справочники API типовых, транскрибация, docx и xlsx, окружение агента | 26 |

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

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

• код и запросы - стандарты 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 - и на диске почти шестьсот строк корректного XML:

• Catalogs/Контрагенты.xml - 580 строк со всеми обязательными секциями, стандартными реквизитами

и сгенерированными UUID;

• Catalogs/Контрагенты/Ext/ObjectModule.bsl - заготовка модуля объекта;
• запись Контрагенты в Configuration.xml, то есть объект сразу в составе

конфигурации, а не сиротой на диске;

• Validation OK: Catalog.Контрагенты (11 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](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 и дает ассистенту не текст файлов, а семантическую модель самой среды.

| | | |---|---| | Репозиторий | https://github.com/Desko77/ai-edt | | Установка | update site https://desko77.github.io/ai-edt/ (в EDT: Help -> Install New Software) | | Требования | 1C:EDT 2026.2 или 2026.1 |

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

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

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

| Задача | Чем решается | |--------|--------------| | Добавить в конфигурацию документ, а к нему форму | 1c-meta-compile, затем 1c-form-compile | | Доработать типовую, не снимая с поддержки | 1c-cfe-init, 1c-cfe-borrow, 1c-cfe-patch-method | | Собрать внешнюю обработку из исходников и загрузить в базу | 1c-epf-build, 1c-db-load-cf | | Разобрать чужую .epf, чтобы понять, что она делает | 1c-epf-dump, затем 1c-form-info | | Выгрузить конфигурацию в XML и положить под git | 1c-db-dump-xml | | Написать запрос и проверить его до запуска | скил composing-1c-queries, проверка через validate_query из AI-EDT | | Не угадывать, каким скилом решать задачу | 1c-config-router |

Зависимости

| Компонент | Обязательно | Для чего | |-----------|-------------|----------| | PowerShell 5.1+ (Windows) | Да | Скрипты скилов (.ps1) | | Python 3.8+ | Нет | Альтернативные скрипты (.py), v8unpack-cf, check-uuid, img-grid-analysis | | v8unpack | Нет | Распаковка/сборка CF/CFE/EPF без платформы | | 1C:Enterprise 8.3 | Нет | Скилы группы db-*, сборка EPF/ERF | | Node.js + npm-пакет docx | Нет | md-to-docx (конвертация Markdown → DOCX) | | ffmpeg, ffprobe | Нет | transcribe, transcribe-audio-local (извлечение аудио, разбивка длинных файлов) | | NVIDIA GPU + CUDA 12 + cuDNN 9 | Нет | transcribe, transcribe-audio-local (локальный движок faster-whisper + sherpa-onnx). CPU тоже работает, но в 10+ раз медленнее | | gcomp | Нет | 1c77-dev (разбор/сборка .ert и 1Cv7.MD для 1С 7.7) | | Node.js + @mermaid-js/mermaid-cli (mmdc) | Нет | mermaid-render (рендер диаграмм в PNG/SVG/PDF) | | Обработка MCP_Toolkit.epf (ROCTUP) | Нет | 1c-mcp-toolkit (HTTP API к живой запущенной базе 1С) | | MCP-серверы (см. таблицу ниже) | Нет | Анализ кода, валидация запросов, документация ИТС/платформы/конфигураций |

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

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

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

| Ключ сервера | Для чего | Кто использует | |--------------|----------|----------------| | ai-edt | BSL-код, метаданные, формы, валидация запросов, ошибки проекта, отладка, обновление ИБ. Плагин внутри 1C:EDT, 100+ операций в фасадах. Update site | ai-edt-tools, composing-1c-queries, 1c-query-optimization | | bsl-platform-help | API платформы: методы, типы, сигнатуры, конструкторы, стиль и строгая типизация | 1c-platform-docs | | 1c-naparnik | Ревью кода, стандарты ИТС, документация платформы и конфигураций | 1c-naparnik | | 1c-mcp_ssl_server | Поиск функций БСП по описанию задачи | 1c-ssl-patterns | | 1c-forms-mcp | Генерация обычных (неуправляемых) форм вне EDT-проекта | правило forms_generation.md | | 1c77-metadata | Конфигурация 1С 7.7: объекты, реквизиты, модули (установка) | 1c77-dev | | 1c-syntax-checker-mcp | Проверка синтаксиса BSL без запущенной EDT | правило mcp-tool-priority.md | | 1c-templates-mcp | Семантический поиск по 2200+ шаблонам кода BSL | правило mcp-tool-priority.md |

Скил 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 @claude-plugins-official

Скилы (112)

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

СкилОписание

Маршрутизатор 1c-config-routerОпределяет нужный workflow или скил для задачи Конфигурация (cf-, support-) 1c-cf-initСоздать пустую конфигурацию (scaffold XML), версии формата 2.17-2.21 1c-cf-infoАнализ структуры конфигурации 1c-cf-editИзменить свойства конфигурации 1c-cf-validateВалидация конфигурации 1c-cf-add-objectWorkflow: добавить объект в конфигурацию 1c-cf-new-projectWorkflow: создать конфигурацию с нуля 1c-support-stateСостояние поддержки в XML-выгрузке: чтение, editable/off-support/locked, возможность изменения Объекты метаданных (meta-) 1c-meta-compileСоздать объект метаданных из JSON DSL (37 типов) 1c-meta-decompileДекомпиляция объекта в JSON-заготовку формата meta-compile - черновик нового объекта по образцу 1c-meta-editИзменить реквизиты, ТЧ, свойства объекта 1c-meta-infoАнализ структуры объекта 1c-meta-removeУдалить объект из конфигурации 1c-meta-validateВалидация объекта метаданных Формы (form-) 1c-form-compileСоздать форму из JSON DSL 1c-form-decompileРазобрать Form.xml в JSON-черновик DSL 1c-form-editДобавить элементы, реквизиты, команды в форму 1c-form-addДобавить форму к объекту конфигурации 1c-form-infoАнализ структуры формы 1c-form-patternsПаттерны проектирования форм 1c-form-removeУдалить форму 1c-form-validateВалидация формы Расширения (cfe-) 1c-cfe-initСоздать расширение конфигурации 1c-cfe-borrowЗаимствовать объект из конфигурации 1c-cfe-patch-methodПерехватить метод (Before/After/ModificationAndControl) 1c-cfe-diffАнализ расширения 1c-cfe-validateВалидация расширения 1c-cfe-full-cycleWorkflow: полный цикл создания расширения Обработки и отчеты (epf-, erf-) 1c-epf-scaffoldСоздать пустую обработку 1c-epf-add-formДобавить форму к обработке 1c-epf-buildСобрать EPF из XML-исходников 1c-epf-dumpРазобрать EPF в XML-исходники 1c-epf-validateВалидация обработки 1c-epf-full-cycleWorkflow: полный цикл создания обработки 1c-erf-initСоздать пустой отчет 1c-erf-buildСобрать ERF 1c-erf-dumpРазобрать ERF 1c-erf-validateВалидация отчета Пакеты XDTO (xdto-) 1c-xdto-compileСоздать пакет XDTO из XML-схемы (XSD) 1c-xdto-decompileВыгрузить пакет XDTO обратно в XSD 1c-xdto-editТочечная правка типов и свойств пакета 1c-xdto-infoСтруктура пакета: типы, свойства, точки входа 1c-xdto-validateВалидация пакета XDTO Подсистемы и интерфейс 1c-subsystem-compileСоздать подсистему 1c-subsystem-editИзменить состав подсистемы 1c-subsystem-infoАнализ подсистемы 1c-subsystem-validateВалидация подсистемы 1c-interface-editНастроить командный интерфейс 1c-interface-validateВалидация интерфейса Макеты (mxl-, template-) 1c-mxl-compileСоздать м

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Desko77
• Source: Desko77/claude-code-skills-1c
• License: MIT

Install and usage instructions live in the source repository linked above.