cc-1c-skills/README.md

1C Skills for Claude Code

Набор Claude Code Skills для работы с артефактами 1С:Предприятия 8.3. Позволяет создавать и модифицировать обработки, макеты печатных форм и другие объекты из XML-исходников, не запоминая детали формата.

Быстрый старт

Скопируйте каталог .claude/skills/ в корень вашего проекта. Навыки станут доступны при запуске Claude Code из этого каталога.

МойПроект/
├── .claude/skills/    ← скопировать из этого репозитория
├── src/               ← исходники (создаются навыками)
└── ...

Не обязательно запоминать команды и параметры — просто опишите задачу своими словами, Claude сам подберёт нужные навыки. Слеш-команды (например /epf-init МояОбработка) тоже работают — для точного контроля.

Группы навыков

Группа	Навыки	Описание	Гайд
Внешние обработки (EPF)	10 навыков /epf-*	Создание, модификация, сборка обработок из XML-исходников	Подробнее
Табличный документ (MXL)	4 навыка /mxl-*	Анализ, создание, компиляция макетов печатных форм	Подробнее
Управляемые формы (Form)	2 навыка /form-*	Анализ и генерация управляемых форм из XML-исходников	Подробнее
Утилиты	/img-grid	Наложение сетки на изображение для определения пропорций колонок	—

Требования

• Windows с PowerShell 5.1+ (входит в Windows)
• 1С:Предприятие 8.3 — для сборки/разборки EPF (навыки генерации XML работают без платформы)

Спецификации

• XML-формат выгрузки обработок — структура XML-файлов, namespace, элементы форм
• Управляемая форма — Form.xml, элементы, команды, реквизиты
• Встроенная справка — Help.xml, HTML-страницы, кнопка справки на форме
• Сборка и разборка EPF — команды 1cv8.exe, параметры, коды возврата
• Табличный документ (MXL) — XML-формат SpreadsheetDocument, совместимость версий
• MXL DSL — JSON-формат описания макета для /mxl-compile и /mxl-decompile
• Form DSL — JSON-формат описания формы для /form-compile

Структура репозитория

.claude/skills/          # Навыки Claude Code
├── epf-init/            # Создание обработки
├── epf-add-form/        # Добавление формы
├── epf-add-template/    # Добавление макета
├── epf-add-help/        # Добавление справки
├── epf-remove-form/     # Удаление формы
├── epf-remove-template/ # Удаление макета
├── epf-build/           # Сборка EPF
├── epf-dump/            # Разборка EPF
├── epf-bsp-init/        # Регистрация БСП
├── epf-bsp-add-command/ # Команда БСП
├── mxl-info/            # Анализ макета
├── mxl-validate/        # Валидация макета
├── mxl-compile/         # Компиляция макета из JSON
├── mxl-decompile/       # Декомпиляция макета в JSON
├── form-info/           # Анализ структуры управляемой формы
├── form-compile/        # Компиляция формы из JSON
└── img-grid/            # Сетка для анализа изображений
docs/
├── epf-guide.md            # Гайд: внешние обработки
├── mxl-guide.md            # Гайд: табличный документ
├── form-guide.md           # Гайд: управляемые формы
├── 1c-xml-format-spec.md   # Спецификация XML-формата
├── 1c-form-spec.md         # Спецификация управляемых форм
├── 1c-help-spec.md         # Спецификация встроенной справки
├── build-spec.md           # Спецификация сборки/разборки
├── 1c-spreadsheet-spec.md  # Спецификация табличного документа
├── mxl-dsl-spec.md         # Спецификация MXL DSL
└── form-dsl-spec.md        # Спецификация Form DSL