mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-10 16:14:54 +03:00
Nick Shirokov
044bc18974
- New skill /img-grid: overlays numbered grid on images to help
determine column proportions for MXL template generation
- Add "page" field to MXL DSL ("A4-landscape", "A4-portrait", or
number) that auto-calculates defaultWidth from column proportions
- Update DSL spec, mxl-compile SKILL.md, MXL guide, README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
69 lines
4.9 KiB
Markdown
69 lines
4.9 KiB
Markdown
# 1C Skills for Claude Code
|
||
|
||
Набор [Claude Code Skills](https://docs.anthropic.com/en/docs/claude-code/skills) для работы с артефактами 1С:Предприятия 8.3. Позволяет создавать и модифицировать обработки, макеты печатных форм и другие объекты из XML-исходников, не запоминая детали формата.
|
||
|
||
## Быстрый старт
|
||
|
||
Скопируйте каталог `.claude/skills/` в корень вашего проекта. Навыки станут доступны при запуске Claude Code из этого каталога.
|
||
|
||
```
|
||
МойПроект/
|
||
├── .claude/skills/ ← скопировать из этого репозитория
|
||
├── src/ ← исходники (создаются навыками)
|
||
└── ...
|
||
```
|
||
|
||
Не обязательно запоминать команды и параметры — просто опишите задачу своими словами, Claude сам подберёт нужные навыки. Слеш-команды (например `/epf-init МояОбработка`) тоже работают — для точного контроля.
|
||
|
||
## Группы навыков
|
||
|
||
| Группа | Навыки | Описание | Гайд |
|
||
|--------|--------|----------|------|
|
||
| Внешние обработки (EPF) | 10 навыков `/epf-*` | Создание, модификация, сборка обработок из XML-исходников | [Подробнее](docs/epf-guide.md) |
|
||
| Табличный документ (MXL) | 4 навыка `/mxl-*` | Анализ, создание, компиляция макетов печатных форм | [Подробнее](docs/mxl-guide.md) |
|
||
| Утилиты | `/img-grid` | Наложение сетки на изображение для определения пропорций колонок | — |
|
||
|
||
## Требования
|
||
|
||
- **Windows** с PowerShell 5.1+ (входит в Windows)
|
||
- **1С:Предприятие 8.3** — для сборки/разборки EPF (навыки генерации XML работают без платформы)
|
||
|
||
## Спецификации
|
||
|
||
- [XML-формат выгрузки обработок](docs/1c-xml-format-spec.md) — структура XML-файлов, namespace, элементы форм
|
||
- [Управляемая форма](docs/1c-form-spec.md) — Form.xml, элементы, команды, реквизиты
|
||
- [Встроенная справка](docs/1c-help-spec.md) — Help.xml, HTML-страницы, кнопка справки на форме
|
||
- [Сборка и разборка EPF](docs/build-spec.md) — команды `1cv8.exe`, параметры, коды возврата
|
||
- [Табличный документ (MXL)](docs/1c-spreadsheet-spec.md) — XML-формат SpreadsheetDocument, совместимость версий
|
||
- [MXL DSL](docs/mxl-dsl-spec.md) — JSON-формат описания макета для `/mxl-compile` и `/mxl-decompile`
|
||
|
||
## Структура репозитория
|
||
|
||
```
|
||
.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
|
||
└── img-grid/ # Сетка для анализа изображений
|
||
docs/
|
||
├── epf-guide.md # Гайд: внешние обработки
|
||
├── mxl-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
|
||
```
|