mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-12 00:44:57 +03:00
Nick Shirokov
90ca2a7c4a
Action functions (clickElement, fillFields, selectValue, etc.) are now wrapped to check for 1C errors (modal dialogs, validation balloons) after each call. When detected, execution stops immediately with full diagnostic context: - error: human-readable 1C error message - step: which API function triggered the error - stepArgs: arguments passed to that function - onecErrors: raw balloon/messages/modal data from DOM - formState: complete form state at the moment of error - screenshot: auto-captured error-shot.png This enables autonomous scripts (run mode) to fail fast with enough information for the caller (agent or human) to diagnose and decide on corrective action. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1C Skills for Claude Code
Work in progress — навыки находятся в стадии тестирования, отладки и оптимизации.
Набор Claude Code Skills для работы с артефактами 1С:Предприятия 8.3. Позволяет создавать и модифицировать обработки, отчёты, объекты конфигурации, макеты печатных форм и другие объекты из XML-исходников, не запоминая детали формата.
Быстрый старт
Скопируйте каталог .claude/skills/ в корень вашего проекта. Навыки станут доступны при запуске Claude Code из этого каталога.
МойПроект/
├── .claude/skills/ ← скопировать из этого репозитория
├── src/ ← исходники (создаются навыками)
└── ...
Не обязательно запоминать команды и параметры — просто опишите задачу своими словами, Claude сам подберёт нужные навыки. Слеш-команды (например /epf-init МояОбработка) тоже работают — для точного контроля.
Группы навыков
| Группа | Навыки | Описание | Гайд |
|---|---|---|---|
| Внешние обработки (EPF) | 7 навыков /epf-* |
Создание, сборка, разборка, валидация обработок из XML-исходников | Подробнее |
| Внешние отчёты (ERF) | 4 навыка /erf-* |
Создание, сборка, разборка, валидация внешних отчётов | Подробнее |
| Универсальные операции | /template-add, /template-remove, /help-add, /form-remove |
Добавление/удаление макетов, форм, справки для любых объектов | Подробнее |
| Табличный документ (MXL) | 4 навыка /mxl-* |
Анализ, создание, компиляция макетов печатных форм | Подробнее |
| Управляемые формы (Form) | 6 навыков /form-* |
Создание, анализ, генерация, модификация, валидация управляемых форм | Подробнее |
| Роли (Role) | 3 навыка /role-* |
Анализ прав роли, создание из JSON DSL, валидация | Подробнее |
| Схема компоновки (СКД) | 4 навыка /skd-* |
Анализ, генерация из JSON DSL, точечное редактирование, валидация схем компоновки данных | Подробнее |
| Метаданные конфигурации | 5 навыков /meta-* |
Создание, анализ, редактирование, удаление, валидация объектов метаданных (23 типа) | Подробнее |
| Корневая конфигурация | 4 навыка /cf-* |
Создание, анализ, редактирование, валидация корневых файлов конфигурации | Подробнее |
| Расширения (CFE) | 5 навыков /cfe-* |
Создание, заимствование, перехват методов, валидация, анализ расширений | Подробнее |
| Подсистемы (Subsystem) | 4 навыка /subsystem-* |
Анализ, создание, редактирование, валидация подсистем конфигурации | Подробнее |
| Командный интерфейс (CI) | 2 навыка /interface-* |
Редактирование и валидация CommandInterface.xml подсистем | Подробнее |
| Базы данных (DB) | 9 навыков /db-* |
Создание баз, загрузка/выгрузка конфигураций, обновление БД, загрузка из Git | Подробнее |
| Веб-публикация (Web) | 4 навыка /web-* |
Публикация баз через Apache, статус, остановка, удаление публикаций | Подробнее |
| Утилиты | /img-grid |
Наложение сетки на изображение для определения пропорций колонок | — |
Требования
- Windows с PowerShell 5.1+ (входит в Windows)
- 1С:Предприятие 8.3 — для сборки/разборки EPF/ERF (навыки генерации XML работают без платформы)
Спецификации
Полный индекс с оглавлением по всем 44 типам объектов: Сводный индекс спецификаций
- XML-формат выгрузки обработок — структура XML-файлов, namespace, элементы форм
- XML-формат внешних отчётов — отличия ERF от EPF, Properties, MainDataCompositionSchema
- Управляемая форма — Form.xml, элементы, команды, реквизиты
- Встроенная справка — Help.xml, HTML-страницы, кнопка справки на форме
- Пакетный режим конфигуратора 1С — команды
1cv8.exe, DESIGNER, ENTERPRISE, CREATEINFOBASE - Табличный документ (MXL) — XML-формат SpreadsheetDocument, совместимость версий
- MXL DSL — JSON-формат описания макета для
/mxl-compileи/mxl-decompile - Form DSL — JSON-формат описания формы для
/form-compile - Роли (Rights.xml) — XML-формат прав роли, типы объектов, RLS
- Role DSL — JSON-формат описания ролей для
/role-compile - Схема компоновки данных (DCS) — XML-формат DataCompositionSchema, 930 схем проанализировано
- SKD DSL — JSON-формат описания СКД для
/skd-compile - Объекты конфигурации — XML-формат объектов метаданных конфигурации (23 типа)
- Подсистемы и командный интерфейс — XML-формат подсистем, CommandInterface.xml, секции видимости/размещения/порядка
- Корневая конфигурация — XML-формат Configuration.xml, ConfigDumpInfo.xml, Languages/, 44 типа ChildObjects
- Расширения конфигурации (CFE) — XML-формат выгрузки расширений конфигурации
- Веб-публикация 1С — VRD, httpd.conf, wsap24.dll, portable Apache
Структура репозитория
.claude/skills/ # Навыки Claude Code
├── epf-init/ # Создание обработки
├── epf-add-form/ # Добавление формы к обработке
├── epf-build/ # Сборка EPF
├── epf-dump/ # Разборка EPF
├── epf-bsp-init/ # Регистрация БСП
├── epf-bsp-add-command/ # Команда БСП
├── epf-validate/ # Валидация обработки
├── erf-init/ # Создание внешнего отчёта
├── erf-build/ # Сборка ERF
├── erf-dump/ # Разборка ERF
├── erf-validate/ # Валидация отчёта
├── template-add/ # Добавление макета (универсальный)
├── template-remove/ # Удаление макета (универсальный)
├── form-add/ # Добавление формы (универсальный)
├── form-remove/ # Удаление формы (универсальный)
├── help-add/ # Добавление справки (универсальный)
├── mxl-info/ # Анализ макета
├── mxl-validate/ # Валидация макета
├── mxl-compile/ # Компиляция макета из JSON
├── mxl-decompile/ # Декомпиляция макета в JSON
├── form-info/ # Анализ структуры управляемой формы
├── form-compile/ # Компиляция формы из JSON
├── form-validate/ # Валидация формы
├── form-edit/ # Добавление элементов в форму
├── form-patterns/ # Справочник паттернов компоновки форм
├── role-info/ # Анализ прав роли
├── role-compile/ # Создание роли из JSON DSL
├── role-validate/ # Валидация роли
├── skd-info/ # Анализ схемы компоновки данных
├── skd-compile/ # Компиляция СКД из JSON DSL
├── skd-edit/ # Точечное редактирование СКД (25 операций)
├── skd-validate/ # Валидация СКД
├── meta-info/ # Структура объекта метаданных
├── meta-compile/ # Создание объекта метаданных
├── meta-edit/ # Редактирование объекта метаданных
├── meta-remove/ # Удаление объекта метаданных
├── meta-validate/ # Валидация объекта метаданных
├── cf-info/ # Анализ структуры конфигурации
├── cf-init/ # Создание пустой конфигурации
├── cf-edit/ # Редактирование конфигурации
├── cf-validate/ # Валидация конфигурации
├── cfe-init/ # Создание расширения
├── cfe-borrow/ # Заимствование объектов
├── cfe-patch-method/ # Перехват методов
├── cfe-validate/ # Валидация расширения
├── cfe-diff/ # Анализ и сравнение
├── subsystem-info/ # Анализ структуры подсистемы
├── subsystem-compile/ # Создание подсистемы из JSON
├── subsystem-edit/ # Редактирование подсистемы
├── subsystem-validate/ # Валидация подсистемы
├── interface-edit/ # Редактирование CommandInterface.xml
├── interface-validate/ # Валидация CommandInterface.xml
├── db-list/ # Управление реестром баз данных
├── db-create/ # Создание информационной базы
├── db-dump-cf/ # Выгрузка конфигурации в CF
├── db-load-cf/ # Загрузка конфигурации из CF
├── db-dump-xml/ # Выгрузка конфигурации в XML
├── db-load-xml/ # Загрузка конфигурации из XML
├── db-update/ # Обновление конфигурации БД
├── db-run/ # Запуск 1С:Предприятие
├── db-load-git/ # Загрузка изменений из Git
├── web-publish/ # Публикация базы через Apache
├── web-info/ # Статус Apache и публикаций
├── web-stop/ # Остановка Apache
├── web-unpublish/ # Удаление публикации
└── img-grid/ # Сетка для анализа изображений
docs/
├── epf-guide.md # Гайд: внешние обработки и отчёты
├── mxl-guide.md # Гайд: табличный документ
├── form-guide.md # Гайд: управляемые формы
├── role-guide.md # Гайд: роли
├── skd-guide.md # Гайд: схема компоновки данных
├── meta-guide.md # Гайд: объекты метаданных конфигурации
├── cf-guide.md # Гайд: корневые файлы конфигурации
├── cfe-guide.md # Гайд: расширения конфигурации (CFE)
├── subsystem-guide.md # Гайд: подсистемы и командный интерфейс
├── db-guide.md # Гайд: базы данных 1С
├── web-guide.md # Гайд: веб-публикация через Apache
├── 1c-epf-spec.md # Спецификация XML-формата (EPF)
├── 1c-erf-spec.md # Спецификация XML-формата (ERF)
├── 1c-form-spec.md # Спецификация управляемых форм
├── 1c-help-spec.md # Спецификация встроенной справки
├── 1c-config-objects-spec.md # Спецификация объектов конфигурации
├── build-spec.md # Пакетный режим конфигуратора 1С
├── 1c-spreadsheet-spec.md # Спецификация табличного документа
├── mxl-dsl-spec.md # Спецификация MXL DSL
├── form-dsl-spec.md # Спецификация Form DSL
├── meta-dsl-spec.md # Спецификация Meta DSL
├── 1c-role-spec.md # Спецификация ролей (Rights.xml)
├── 1c-dcs-spec.md # Спецификация СКД (DataCompositionSchema)
├── skd-dsl-spec.md # Спецификация SKD DSL
├── role-dsl-spec.md # Спецификация Role DSL
├── 1c-extension-spec.md # Спецификация расширений конфигурации (CFE)
├── 1c-subsystem-spec.md # Спецификация подсистем и командного интерфейса
└── web-spec.md # Спецификация веб-публикации (VRD, httpd.conf, Apache)