# 1C Skills for Claude Code > **Work in progress** — навыки находятся в стадии тестирования, отладки и оптимизации. Набор навыков для AI-агентов (в первую очередь для [Claude Code](https://docs.anthropic.com/en/docs/claude-code/skills)), помогающий охватить полный цикл разработки на платформе 1С:Предприятие 8.3 — от создания конфигураций, расширений, внешних обработок и отчётов до загрузки изменений в информационную базу, обновления, запуска, публикации на веб-сервере (портативная версия Apache), тестирования через веб-клиент и записи видеоинструкций. Навыки дают модели готовые абстракции над XML-форматами и CLI конфигуратора — чтобы работать с сутью задачи, а не с деталями реализации. А веб-тестирование даёт ей глаза и руки для взаимодействия с интерфейсом 1С. ## Быстрый старт Скопируйте каталог `.claude/skills/` в корень вашего проекта. Навыки станут доступны при запуске Claude Code из этого каталога. ``` МойПроект/ ├── .claude/skills/ ← скопировать из этого репозитория └── ... ``` Не обязательно запоминать команды и параметры — просто опишите задачу своими словами, Claude сам подберёт нужные навыки. Слеш-команды (например `/epf-init МояОбработка`) тоже работают — для точного контроля. ## Группы навыков | Группа | Навыки | Описание | Гайд | |--------|--------|----------|------| | Внешние обработки (EPF) | 7 навыков `/epf-*` | Создание, сборка, разборка, валидация обработок из XML-исходников | [Подробнее](docs/epf-guide.md) | | Внешние отчёты (ERF) | 4 навыка `/erf-*` | Создание, сборка, разборка, валидация внешних отчётов | [Подробнее](docs/epf-guide.md#внешние-отчёты-erf) | | Универсальные операции | `/template-add`, `/template-remove`, `/help-add`, `/form-remove` | Добавление/удаление макетов, форм, справки для любых объектов | [Подробнее](docs/epf-guide.md#универсальные-навыки) | | Табличный документ (MXL) | 4 навыка `/mxl-*` | Анализ, создание, компиляция макетов печатных форм | [Подробнее](docs/mxl-guide.md) | | Управляемые формы (Form) | 6 навыков `/form-*` | Создание, анализ, генерация, модификация, валидация управляемых форм | [Подробнее](docs/form-guide.md) | | Роли (Role) | 3 навыка `/role-*` | Анализ прав роли, создание из JSON DSL, валидация | [Подробнее](docs/role-guide.md) | | Схема компоновки (СКД) | 4 навыка `/skd-*` | Анализ, генерация из JSON DSL, точечное редактирование, валидация схем компоновки данных | [Подробнее](docs/skd-guide.md) | | Метаданные конфигурации | 5 навыков `/meta-*` | Создание, анализ, редактирование, удаление, валидация объектов метаданных (23 типа) | [Подробнее](docs/meta-guide.md) | | Корневая конфигурация | 4 навыка `/cf-*` | Создание, анализ, редактирование, валидация корневых файлов конфигурации | [Подробнее](docs/cf-guide.md) | | Расширения (CFE) | 5 навыков `/cfe-*` | Создание, заимствование, перехват методов, валидация, анализ расширений | [Подробнее](docs/cfe-guide.md) | | Подсистемы (Subsystem) | 4 навыка `/subsystem-*` | Анализ, создание, редактирование, валидация подсистем конфигурации | [Подробнее](docs/subsystem-guide.md) | | Командный интерфейс (CI) | 2 навыка `/interface-*` | Редактирование и валидация CommandInterface.xml подсистем | [Подробнее](docs/subsystem-guide.md) | | Базы данных (DB) | 9 навыков `/db-*` | Создание баз, загрузка/выгрузка конфигураций, обновление БД, загрузка из Git | [Подробнее](docs/db-guide.md) | | Веб-публикация (Web) | 4 навыка `/web-*` | Публикация баз через Apache, статус, остановка, удаление публикаций | [Подробнее](docs/web-guide.md) | | Тестирование (Web) | `/web-test` | Взаимодействие с веб-клиентом 1С — навигация, формы, таблицы, отчёты, тестирование | [Подробнее](docs/web-test-guide.md) | | Запись видео (Web) | `/web-test` | Запись видеоинструкций с субтитрами, подсветкой и TTS-озвучкой | [Подробнее](docs/web-test-recording-guide.md) | | Утилиты | `/img-grid` | Наложение сетки на изображение для определения пропорций колонок | — | ## Требования - **Windows** с PowerShell 5.1+ (входит в Windows) — рантайм по умолчанию - **1С:Предприятие 8.3** — для сборки/разборки EPF/ERF (навыки генерации XML работают без платформы) - **Node.js 18+** — для `/web-test` (тестирование через браузер) ### Другие AI-платформы Навыки построены на открытом стандарте [Agent Skills](https://agentskills.io/specification) и совместимы с любой платформой, поддерживающей этот формат. Скрипт `switch.py` копирует навыки в нужный каталог с перезаписью путей: ```bash python scripts/switch.py # интерактивный режим python scripts/switch.py cursor # скопировать навыки для Cursor python scripts/switch.py cursor --runtime python # Cursor + Python-рантайм python scripts/switch.py claude-code --project-dir /my/proj # установить в другой проект python scripts/switch.py --undo cursor # удалить копию ``` Если репозиторий склонирован внутрь проекта (например, в `tools/cc-1c-skills`), используйте `--project-dir` для установки навыков в целевой проект. Обновление — `git pull` и повторный запуск. Поддерживаемые платформы: | Платформа | Целевой каталог | `switch.py ` | |-----------|----------------|------------------------| | Claude Code | `.claude/skills/` | `claude-code` | | Augment | `.augment/skills/` | `augment` | | Cline | `.cline/skills/` | `cline` | | Cursor | `.cursor/skills/` | `cursor` | | GitHub Copilot | `.github/skills/` | `copilot` | | Kilo Code | `.kilocode/skills/` | `kilo` | | Kiro | `.kiro/skills/` | `kiro` | | OpenAI Codex | `.codex/skills/` | `codex` | | Gemini CLI | `.gemini/skills/` | `gemini` | | OpenCode | `.opencode/skills/` | `opencode` | | Roo Code | `.roo/skills/` | `roo` | | Windsurf | `.windsurf/skills/` | `windsurf` | | Agent Skills | `.agents/skills/` | `agents` | Некоторые платформы (Augment, Cline, VS Code/Copilot) также сканируют `.claude/skills/` как fallback — для них копирование необязательно, но `switch.py` даёт явный контроль над путями. Автоактивация — основной режим: просто опишите задачу своими словами, ассистент сам подберёт нужный навык по `description` в SKILL.md. Слеш-команды (например `/epf-init`) — для точного контроля, когда нужно вызвать конкретный навык. ### Переключение рантайма (PowerShell ↔ Python) На Windows рекомендуется PS1-рантайм (по умолчанию). Python-порты — для **Linux/Mac** или если PowerShell недоступен. PS1-скрипты — мастер-версия; Python-порты производные (см. [Python Porting Guide](docs/python-porting-guide.md)). ```bash python scripts/switch.py --runtime python # переключить на Python python scripts/switch.py --runtime powershell # вернуть на PowerShell ``` Дополнительные зависимости Python-рантайма: - `lxml>=4.9.0` — для навыков, работающих с DOM (edit/validate/info) - `psutil>=5.9.0` — для web-навыков (управление Apache) Параметры скриптов идентичны для обоих рантаймов — переключение меняет только интерпретатор в вызовах. Подробнее: [Python Porting Guide](docs/python-porting-guide.md). ## Спецификации Полный индекс с оглавлением по всем 44 типам объектов: **[Сводный индекс спецификаций](docs/1c-specs-index.md)** - [XML-формат выгрузки обработок](docs/1c-epf-spec.md) — структура XML-файлов, namespace, элементы форм - [XML-формат внешних отчётов](docs/1c-erf-spec.md) — отличия ERF от EPF, Properties, MainDataCompositionSchema - [Управляемая форма](docs/1c-form-spec.md) — Form.xml, элементы, команды, реквизиты - [Встроенная справка](docs/1c-help-spec.md) — Help.xml, HTML-страницы, кнопка справки на форме - [Пакетный режим конфигуратора 1С](docs/build-spec.md) — команды `1cv8.exe`, DESIGNER, ENTERPRISE, CREATEINFOBASE - [Табличный документ (MXL)](docs/1c-spreadsheet-spec.md) — XML-формат SpreadsheetDocument, совместимость версий - [MXL DSL](docs/mxl-dsl-spec.md) — JSON-формат описания макета для `/mxl-compile` и `/mxl-decompile` - [Form DSL](docs/form-dsl-spec.md) — JSON-формат описания формы для `/form-compile` - [Роли (Rights.xml)](docs/1c-role-spec.md) — XML-формат прав роли, типы объектов, RLS - [Role DSL](docs/role-dsl-spec.md) — JSON-формат описания ролей для `/role-compile` - [Схема компоновки данных (DCS)](docs/1c-dcs-spec.md) — XML-формат DataCompositionSchema, 930 схем проанализировано - [SKD DSL](docs/skd-dsl-spec.md) — JSON-формат описания СКД для `/skd-compile` - [Объекты конфигурации](docs/1c-config-objects-spec.md) — XML-формат объектов метаданных конфигурации (23 типа) - [Подсистемы и командный интерфейс](docs/1c-subsystem-spec.md) — XML-формат подсистем, CommandInterface.xml, секции видимости/размещения/порядка - [Корневая конфигурация](docs/1c-configuration-spec.md) — XML-формат Configuration.xml, ConfigDumpInfo.xml, Languages/, 44 типа ChildObjects - [Расширения конфигурации (CFE)](docs/1c-extension-spec.md) — XML-формат выгрузки расширений конфигурации - [Веб-публикация 1С](docs/web-spec.md) — 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/ # Удаление публикации ├── web-test/ # Тестирование через веб-клиент 1С └── img-grid/ # Сетка для анализа изображений scripts/ └── switch.py # Переключение платформы и рантайма (13 платформ) 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 # Гайд: подсистемы и командный интерфейс ├── v8-project-guide.md # Гайд: конфигурация проекта (.v8-project.json) ├── db-guide.md # Гайд: базы данных 1С ├── web-guide.md # Гайд: веб-публикация через Apache ├── web-test-guide.md # Гайд: тестирование через веб-клиент ├── web-test-recording-guide.md # Гайд: запись видеоинструкций ├── 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) └── python-porting-guide.md # Руководство по Python-портам навыков ```