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

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

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

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

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

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

Плюс 1 агент (agents/) - субагент-разведчик 1С с ограничением инструментов, ставится в ~/.claude/agents/ установщиком набора (раздел Агенты ниже).

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

Справочник с реквизитами и табличной частью. На входе пятнадцать строк 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 и дает ассистенту не текст файлов, а семантическую модель самой среды.

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

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

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

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

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

Зависимости

Компонент	Обязательно	Для чего
PowerShell 5.1+ (Windows)	Да	Скрипты скилов (.ps1)
Python 3.8+	Нет	Альтернативные скрипты (.py), v8unpack-cf, check-uuid, img-grid-analysis
v8unpack	Нет	Распаковка/сборка CF/CFE/EPF без платформы
psutil	Нет	python-порты скилов 1c-web-*: поиск процессов веб-сервера
anthropic	Нет	skill-creator: прогон и улучшение описаний через API
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
v8std	Тексты стандартов 1С по номеру #stdNNN, расшифровка диагностик ACC/BSLLS/EDT; публичный сервис https://ai.v8std.ru/mcp, тексты стандартов - CC0; закрытый код не передавать, локальный вариант - в Docker	правило 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 <name>@claude-plugins-official

Скилы (121)

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

Скил	Описание
Маршрутизатор
1c-config-router	Определяет нужный workflow или скил для задачи
Конфигурация (cf-*, support-*)
1c-cf-init	Создать пустую конфигурацию (scaffold XML), версии формата 2.17-2.21
1c-cf-info	Анализ структуры конфигурации
1c-config-index	Индекс всей выгрузки одним JSON: объекты, реквизиты, измерения регистров, экспортные методы общих модулей. Основа проверок, где объект сверяется с остальной конфигурацией
1c-cf-edit	Изменить свойства конфигурации
1c-cf-validate	Валидация конфигурации
1c-cf-add-object	Workflow: добавить объект в конфигурацию
1c-cf-new-project	Workflow: создать конфигурацию с нуля
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-cycle	Workflow: полный цикл создания расширения
Ручное внесение правок
1c-change-package	Пакет ручного внесения правок: по двум версиям модулей - инструкция для Конфигуратора, что найти и на что заменить
Обработки и отчеты (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-cycle	Workflow: полный цикл создания обработки
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	Создать макет из JSON DSL
1c-mxl-decompile	Разобрать макет в JSON
1c-mxl-info	Анализ макета
1c-mxl-validate	Валидация макета
1c-template-add	Добавить макет к объекту
1c-template-remove	Удалить макет
Роли (role-*)
1c-role-compile	Создать роль из описания прав: права сверены с платформой 8.3.27, замыкание по зависимостям, флажки роли по стандарту #std532
1c-role-edit	Точечная правка существующей роли: права, RLS, шаблоны, свойства
1c-role-info	Анализ роли
1c-role-validate	Валидация роли
СКД (skd-*)
1c-skd-compile	Создать схему компоновки данных
1c-skd-decompile	Разобрать XML СКД в JSON-черновик DSL
1c-skd-edit	Изменить существующую СКД
1c-skd-info	Анализ СКД
1c-skd-validate	Валидация СКД
Базы данных (db-*)
1c-db-list	Управление реестром баз. База с "role": "prod" защищена: изменяющие скилы db-* и хранилища без ключа -AllowProd отказывают
1c-db-create	Создать информационную базу
1c-db-dump-cf	Выгрузить конфигурацию в CF
1c-db-dump-dt	Выгрузить всю ИБ в DT (полный бэкап)
1c-db-dump-xml	Выгрузить конфигурацию в XML
1c-db-load-cf	Загрузить конфигурацию из CF
1c-db-load-dt	Восстановить ИБ из DT (деструктивная)
1c-db-load-xml	Загрузить конфигурацию из XML
1c-db-load-git	Загрузить изменения из Git
1c-db-update	Обновить конфигурацию БД
1c-db-cfe-admin	Расширения в базе: список, проверка применимости, свойства, удаление
1c-db-run	Запустить 1С:Предприятие
1c-storage-ops	Хранилище конфигурации: отчет по версиям, захват и снятие захвата, обновление, помещение, выгрузка, подключение и отключение базы
Веб-публикация и тестирование (web-*)
1c-web-publish	Публикация ИБ на веб-сервере (Apache/IIS)
1c-web-unpublish	Отмена публикации ИБ
1c-web-info	Информация о веб-публикациях
1c-web-stop	Остановка веб-сервера
1c-web-test	Тестирование 1С через веб-клиент (автоматизация браузера)
БСП
1c-bsp-registration	Регистрация обработки в БСП
1c-bsp-command	Добавить команду БСП
1c-bsp-api	Справочник программного интерфейса БСП: модули, экспортные методы, сигнатуры, типы параметров, контексты выполнения, переопределяемые обработчики. Проверяет вызов до того, как он написан
1c-ssl-patterns	Прикладные сценарии БСП: 38 справочников по темам главы применения документации - каким механизмом решается задача, в каком порядке идут вызовы, какие антипаттерны и различия между 3.1.11 и 3.2.1
Разработка 1С 7.7
1c77-dev	Разработка под 1С 7.7: .1s/.ert/.frm, 1Cv7.MD, gcomp, кодировка CP1251
Конвертация данных и интеграции
kd2-rules	Правила обмена "Конвертация данных 2.0" через MCP-toolkit
kd31-rules	Правила обмена "Конвертация данных 3.1" через MCP-toolkit
cleverence-mslx	Mobile SMARTS (Клеверенс): .mslx-алгоритмы ТСД, online-вызов 1С
Справочные и утилитарные
ai-edt-tools	Справочник инструментов AI-EDT (MCP-плагин для 1С:EDT): фасады, сценарии, особенности и ограничения
1c-naparnik	Справочник инструментов 1С:Напарник (анализ кода, ИТС, документация)
1c-mcp-toolkit	Прямой HTTP API к живой запущенной базе 1С (запросы, BSL-код, метаданные, журнал)
1c-platform-docs	Поиск по документации API платформы
1c-query-validate	Проверка текста запроса по выгрузке: существуют ли таблицы, табличные части, виртуальные таблицы регистров и поля
1c-bsl-validate	Проверка вызовов общих модулей в BSL по выгрузке: существует ли модуль и экспортный ли метод; режим -Catalog - текстовый lint модулей по каталогу дефектов (реестр правил, строка EVIDENCE)
1c-code-review	Ревью BSL по каталогу дефектов: карточки с триггером, законной формой и важностью (Critical/Major/Minor), генерируемый индекс, матрица детекторов по средам (references/detectors.md), гейтовый конфиг bsl-language-server (assets/bsl-ls-gate.json), отчет с идентификаторами находок и ключом локации
1c-query-optimization	Продвинутая оптимизация запросов
zup-hr-api-reference	Справочник API 1С:ЗУП 3.1: кадровый учет (физлица, стажи, договоры ГПХ, представления СКД) и расчет (средний заработок, начисления, пособия/СФР, взносы, отчетность)
1c-help-manage	Встроенная справка объектов 1С
composing-1c-queries	Руководство по языку запросов 1С
1c-vanessa-steps	Реестр 1569 шагов Vanessa Automation: поиск шага по смыслу и валидация сценария .feature перед прогоном
v8unpack-cf	Распаковка/сборка CF/CFE/EPF
img-grid-analysis	Анализ изображений для макетов
md-to-docx	Конвертация Markdown в DOCX
docx-from-sample	Новый DOCX в оформлении готового образца: стили, нумерация заголовков, таблицы, колонтитулы наследуются из файла-образца
transcribe	Транскрибация аудио (локально, faster-whisper + sherpa-onnx GPU) и видео (Gemini API). Установка через scripts/setup.py
transcribe-audio-local	Только аудио, только локально, self-contained - для передачи на другую машину без облака
meeting-to-tasks	Полный цикл от записи встречи к списку задач и плану разработки по SDD на каждую задачу
mermaid-diagrams	Генерация диаграмм Mermaid
mermaid-render	Рендер Mermaid в PNG/SVG/PDF через локальный mmdc
powershell-windows	PowerShell на Windows
lmstudio-api	Справочник HTTP-API LM Studio: загрузка и выгрузка моделей, контекст, отключение reasoning, особенности протокола
skill-creator	Создание, тестирование и оптимизация скилов (evals, grading, description loop)
prompt-enhancer	Улучшение и структурирование коротких промптов и постановок задач в подробные ТЗ
report-issue	Дефект или пожелание разработчикам набора и плагина AI-EDT: обезличенный черновик, проверка на приватные данные, отправка issue только с согласия пользователя
humanize-ai-text	Переписывание AI-текста (отчеты, README, доки, письма) в живой человеческий стиль: ломает ровный ритм, убирает штампы и буферные вступления. Сканер проверяет правила набора по жанру документа; для оценки читаемости русского текста вообще есть отдельный инструмент Humanizer_RU
claude-env-setup	Установка и обновление окружения агента: опись машины -> план -> установка выбранного; конфиги MCP правятся слиянием, чужое не затирается
claude-md-bootstrap	Генерация проектного CLAUDE.md - контекста проекта для AI-агента (IF-THEN правила, work-protocol, progressive disclosure)

Правила (40)

Файл	Описание
1c-coding-standards.md	Стандарты кода BSL: именование, форматирование, запросы, коллекции, директива РАЗРЕШЕННЫЕ
anti_patterns.md	Таблица триггеров каталога дефектов (генерируется из карточек): производительность, запросы, транзакции, клиент-серверные вызовы
query-optimization-tips.md	Оптимизация запросов: ВЫРАЗИТЬ, ВТ, индексы, СКД
async-methods-1c.md	Асинхронные методы (Асинх/Ждать/Обещание)
1c-extension-patterns.md	Паттерны расширений CFE: перехватчики, маркеры
form_module_rules.md	Клиент-серверное разделение в модулях форм
1c-form-reserved-names.md	Зарезервированные имена свойств элементов в модулях форм
forms_events.md	Привязка обработчиков событий в Form.xml
forms_generation.md	Генерация и модификация форм 1С через 1c-forms-mcp
edt-form-xml-requirements.md	Требования EDT к XML-формам (Form.form): extInfo, дефолты полей
code-review-checklist.md	Чеклист ревью BSL-кода: классификация находок, шкала уверенности, security-практики, сгенерированная секция каталога дефектов
code-exploration-guide.md	Методология исследования кодовой базы 1С
testing-patterns.md	Паттерны тестирования: YaXUnit, Vanessa Automation
1c-mdo-integrity.md	Целостность MDO-файлов: UUID, ссылки, ограничения типов String/Number
external-data-source-mdo.md	Внешние источники данных (ВИД) в формате EDT
v8unpack-source-structure.md	Структура исходников v8unpack
refactoring.md	Правила рефакторинга 1С: техники, критерии, примеры BSL
routine_assignment_ext_processor.md	Фоновые задания из внешней обработки через БСП
bsp-profile-rights-api.md	Программная работа с профилями групп доступа БСП: ссылки на ИдентификаторыОбъектовМетаданных, шаблон создания/обновления
mcp-tool-priority.md	Маршрутизатор MCP-серверов под задачу: какой сервер брать, обязательные проверки, фасады AI-EDT, троттлинг
model-selection.md	Стратегия выбора моделей: Opus/Sonnet/Haiku по типу задачи
sdd-workflow.md	Specification-Driven Development: 9-фазный workflow разработки
skill-design.md	Проектирование скилов: модельный и пользовательский вызов, лестница информации, критерии завершения шага
agent-working-memory.md	Рабочая память агента: файлы плана, передача сессии, правила проекта как журнал инцидентов
git-safety-rules.md	Безопасная работа с git: запрет AI-атрибуции и секретов, деструктивные команды, force push, amend, политика EOL для 1С-репозиториев (.gitattributes)
designer-batch-verdict.md	Вердикт пакетного запуска платформы: четыре сигнала вместо кода возврата, классификация журнала, устаревший лог, маскирование пароля, запретные ключи
1c-transactions-and-locks.md	Транзакции и управляемые блокировки: неявные транзакции платформы, канонический шаблон, порядок захвата, что не делается внутри транзакции
edt-source-format.md	Формат исходников (выгрузка Конфигуратора, EDT, смешанное дерево) и один владелец развертывания на прогон
1c-cyrillic-windows.md	Кириллица в путях и аргументах на Windows: симптомы и причины, кодировки скриптов, молчаливый отказ при удалении
1c-ordinary-forms.md	Обычные формы: чем отличаются от управляемых, порядок операций с видимостью, что проверять при доработке
text-formatting.md	Запрещенные символы в генерируемом тексте (длинное тире, е, елочки): EDT режет их при сохранении
file-edit-efficiency.md	Выбор инструмента чтения и правки файлов по стоимости токенов; кэширование крупных карт проекта
1c-role-rights.md	Права ролей 1С: настройка прав на объекты, RLS, наследование
1c-report-direct-query.md	Прямой запрос в отчетах (СКД) без схемы компоновки
edt-zip-export-pitfalls.md	Ограничения инкрементального экспорта конфигурации из EDT в ИБ
agent-verification-patterns.md	Паттерны проверки результата работы агента (reconciliation loop)
bsl-ssl.md	Переиспользование БСП, разметка правок типовых модулей, устаревшие объекты
edt-bsl-write-safety.md	Безопасная запись BSL-модулей через EDT MCP
integrations.md	Python-first подход к HTTP-интеграциям 1С
1c-skd-two-pass-preprocessing.md	Двухпроходный СКД: предобработка деталей до свертки

Команды (6)

Файл	Описание
check-uuid.md	Проверка уникальности UUID в MDO-файлах
check_uuid_duplicates.py	Python-скрипт проверки дубликатов UUID
docx-to-md.md	Конвертация DOCX в Markdown
move-project.md	Перенос проекта Claude Code с сохранением памяти, сессий и планов
browser-debug.md	Запуск браузера с CDP-отладкой для веб-приложений
quality.md	Снятие гейта качества или отдельной проверки с записью в след проверок

Агенты (1)

Субагенты Claude Code из каталога agents/ - изолированные исполнители с ограниченным набором инструментов. Список tools у агентов набора не задается: закрытый список не наследует MCP-серверы вызывающей сессии, ограничение задается через disallowedTools.

Агент	Что делает	Как ограничен	Установка
1c-explore	Разведка EDT-проекта 1С: кто вызывает метод, структура модуля, состав метаданных объекта, трассировка "как работает X"; отчет по формату rules/code-exploration-guide.md	disallowedTools: Grep, Glob, Bash, PowerShell - ответы только через семантический индекс AI-EDT, без перебора исходников; при недоступном AI-EDT останавливается с отчетом первой строкой, решение о переборе принимает вызывающая сессия	python tools/install_home.py install --components agents

Установщик ведет манифест установленных файлов (~/.claude/.install-manifest.json, sha256), измененный снаружи файл не затирает (конфликт, код выхода 1), по --force переписывает с резервной копией; --check сверяет домашние копии с репозиторием.

Контур качества в tools/:

Инструмент	Что делает
changeset.py	Каноническое множество изменений git-репозитория относительно базового коммита: записи путей со статусами и хешами, diffHash
change_profile.py	Профиль правки по множеству изменений: класс объема C0-C3, архетипы, среда, обязательный состав проверок; пишет событие scope в след (skills/1c-code-review/references/profile-map.md)
evidence.py	Каталог событий следа проверок: запись skipped/not_verified/probe, строгий вердикт check --strict (clean / with_gaps / blocked), отчет render (skills/1c-code-review/references/evidence-format.md)

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

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

Файл	Описание
1c-specs-index.md	Индекс всех спецификаций
1c-config-objects-spec.md	Спецификация объектов метаданных
1c-configuration-spec.md	Спецификация конфигурации
1c-defect-catalog-spec.md	Спецификация каталога дефектов: карточки, реестр идентификаторов, словарь детекторов с уровнями доказательности, фикстуры, генерация индекса
1c-extension-spec.md	Спецификация расширений
1c-form-spec.md	Спецификация управляемых форм
1c-epf-spec.md	Спецификация внешних обработок
1c-erf-spec.md	Спецификация внешних отчетов
1c-role-spec.md	Спецификация ролей
1c-subsystem-spec.md	Спецификация подсистем
1c-support-state-spec.md	Спецификация состояния поддержки (ParentConfigurations.bin)
1c-xdto-spec.md	Спецификация пакетов XDTO
1c-spreadsheet-spec.md	Спецификация табличных документов
1c-dcs-spec.md	Спецификация СКД
1c-help-spec.md	Спецификация справки
build-spec.md	Спецификация пакетного режима 1С
meta-dsl-spec.md	DSL метаданных
form-dsl-spec.md	DSL форм
mxl-dsl-spec.md	DSL макетов
role-dsl-spec.md	DSL ролей
skd-dsl-spec.md	DSL СКД
python-porting-guide.md	Руководство по портированию скриптов PowerShell на Python
v8-project-guide.md	Руководство по .v8-project.json
web-guide.md	Руководство по веб-публикации 1С
web-spec.md	Спецификация веб-публикации
web-test-guide.md	Руководство по веб-тестированию
web-test-recording-guide.md	Руководство по записи видео веб-тестов
*-guide.md	Руководства по отдельным подсистемам (cf, cfe, db, epf, form, meta, mxl, role, skd, subsystem)

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

Скрипты скилов покрыты снапшот-тестами: скил получает вход, генерирует файлы, результат сравнивается с эталоном. Быстро, файлово, без платформы 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+. Текущее состояние: 1013 кейсов, 0 отказов. На PowerShell проходит 936, 77 пропущено по условиям среды; на python проходит 963, пропущено 50. Порядок работы с тестами - tests/skills/README.md.

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

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

• support-guard - блокирует прямую правку через Edit/Write объекта типовой конфигурации, стоящего на поддержке поставщика, и в отказе говорит, что делать вместо этого.
• skill-suggester - при ручной работе с исходниками 1С напоминает про профильный скил: при чтении ведет на *-info, при правке - на мутатор. Не блокирует, срабатывает не чаще раза за сессию на группу.
• evidence-writer - после вызова инструмента проверки (MCP AI-EDT, напарник или скрипт набора) записывает событие applied с итогом в след проверок, при отказе инструмента - failed; событие пишет хук по факту вызова, из CLI его не набрать.
• session-context - при старте сессии сообщает ее идентификатор для следа проверок (довод --session у CLI-инструментов) и вычищает каталоги сессий старше 7 дней.
• release-writer - команда /quality release gate|check ..., набранная человеком, записывает снятие проверки или гейта со сроком действия в след проверок.
• quality-baseline - при старте сессии запоминает HEAD и хеши файлов, чтобы отличать правки этой сессии от чужих; при resume, compact и clear отметку не переписывает.
• quality-arm - отмечает, каким инструментом правился файл 1С (Write, Edit, MCP-правки AI-EDT).
• repeat-failure - когда один и тот же вызов падает с той же ошибкой третий раз подряд, добавляет в контекст модели указание сменить подход или спросить пользователя. Не блокирует.
• quality-stop - не дает завершить ход, пока правки сессии в файлах 1С не прошли обязательные проверки профиля: вердикт считает tools/evidence.py check --strict, в отказе названы пробелы и прямой путь. Снимается прогоном проверок либо командой /quality release. Проверку, которую модель не выполнила, закрывает только пользователь командой /quality release check; запись модели о пропуске остается заявкой.
• edt-gate - пока проект загружен в живой AI-EDT (phase ready, имя в projects ответа /health), отклоняет Read, Grep, Glob, Bash и PowerShell по исходникам этого проекта и запуск клиента 1cv8 / 1cv8c / 1cv8s / start-1c.ps1, и называет инструмент-замену. Окно на 15 минут открывается, если после отказа инструмента /health не в phase ready, а после отказа launch_debugger, debug_launch или start_client - всегда. Снятие - /quality release gate, набранная пользователем. Переменная AI_EDT_GATE со значением кроме пустого и on отключает ворота.

Формат следа - skills/1c-code-review/references/evidence-format.md, валидатор - tools/evidence.py. Требуется Node.js 18+. Автоматически не подключаются: порядок ручного включения и настройки - в hooks/README.md.

Обсуждение

Вопросы, идеи и опыт применения - в Telegram: тема Скилы и правила, по плагину AI-EDT - тема Плагин. Дефект скила или правила с шагами воспроизведения - в Issues. Агент готовит такую issue сам скилом report-issue и отправляет ее только с вашего согласия.

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

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

Лицензия

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

Идеи раздела "Сначала индекс" в правиле маршрутизации MCP, каталога дефектов и следа проверок - из репозитория Romandredan/1c-quality-gate (MIT); код и тексты не переносились.