db-load-xml — скилл для Claude Code: загрузка конфигурации 1С из XML
Скилл db-load-xml загружает конфигурацию 1С в информационную базу из XML-исходников — полностью или отдельными объектами.
MIT 45 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает db-load-xml
Скилл вызывает PowerShell-скрипт, который передаёт файлы в платформу 1С через 1cv8.exe или ibcmd. Поддерживает полную и частичную загрузку: в первом случае вся конфигурация заменяется содержимым каталога, во втором — обновляются только перечисленные объекты вместе с их формами, макетами и модулями из Ext/. Список файлов можно передать прямо в команде или взять из текстового файла в кодировке UTF-8 с BOM.
Параметры подключения к базе скилл берёт из .v8-project.json: можно указать имя базы, и он сопоставит его с записью по id, alias или текущей веткой Git. Если база не задана, используется запись с флагом default. Путь к платформе читается из поля v8path записи базы или корневого уровня файла. Без FFmpeg или платформы 1С в PATH загрузка не запустится.
Какие задачи решает
- загрузить конфигурацию 1С из XML-файлов в информационную базу
- обновить отдельные объекты конфигурации без полной замены
- загрузить расширение 1С из исходников
- применить изменения из репозитория к базе 1С
- автоматизировать сборку конфигурации из XML через агента
Примеры запросов агенту
- Загрузи конфигурацию из
src/configв базуdev - Обнови справочник Номенклатура и его модуль из
src/configчастичной загрузкой - Загрузи расширение МоёРасширение из
src/ext_srcв базу и обнови конфигурацию БД
Как установить db-load-xml
1Через маркетплейс плагинов
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills/plugin install 1c-skills@cc-1c-skillsКоманда ставит плагин 1c-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-xml -a claude-code3Вручную: положить файлы
~/.claude/skills/db-load-xml/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/db-load-xml/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-xml -a codex2Вручную: положить файлы
.agents/skills/db-load-xml/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-xml -a cursor2Вручную: положить файлы
.cursor/skills/db-load-xml/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/db-load-xml2Вручную: положить файлы
.github/skills/db-load-xml/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-xml -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/db-load-xmlВручную: положить файлы
.devin/skills/db-load-xml/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о db-load-xml
Как установить db-load-xml в Claude Code?
Выполни две команды: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills. Скилл появится в списке доступных команд.
Что делает db-load-xml?
Загружает конфигурацию 1С из XML-исходников в информационную базу — целиком или отдельными объектами. Умеет работать с расширениями, читает параметры подключения из .v8-project.json и поддерживает обновление конфигурации БД сразу после загрузки.
Чем частичная загрузка отличается от полной?
Полная загрузка заменяет всю конфигурацию содержимым каталога XML, частичная — только указанные объекты вместе с их дочерними элементами (формы, макеты, модули). Если в список файлов попадёт Configuration.xml, платформа всё равно выполнит полную загрузку.
Исходный текст
SKILL.md · MIT
---
name: db-load-xml
description: Загрузка конфигурации 1С из XML-файлов. Используй когда нужно загрузить конфигурацию из файлов, XML, исходников, LoadConfigFromFiles
argument-hint: <configDir> [database]
allowed-tools:
- Bash
- Read
- Glob
- AskUserQuestion
---
# /db-load-xml — Загрузка конфигурации из XML
Загружает конфигурацию в информационную базу из XML-файлов (исходников). Поддерживает полную и частичную загрузку.
## Usage
```
/db-load-xml <configDir> [database]
/db-load-xml src/config dev
/db-load-xml src/config dev -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
```
> **Внимание**: полная загрузка **заменяет всю конфигурацию** в базе. Перед выполнением запроси подтверждение у пользователя.
## Параметры подключения
Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если файла нет — предложи `/db-list add`.
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
Если в записи базы указан `configSrc` — используй как каталог загрузки по умолчанию.
Для `-Extension` каталог берётся из `extensions[].src` записи базы, если он там указан.
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
```
### Параметры скрипта
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-ConfigDir <путь>` | да | Каталог XML-исходников |
| `-Mode <режим>` | нет | `Full` (по умолч.) / `Partial` |
| `-Files <список>` | для Partial | Относительные пути файлов через запятую |
| `-ListFile <путь>` | для Partial | Путь к файлу со списком (альтернатива `-Files`) |
| `-Extension <имя>` | нет | Загрузить в расширение |
| `-AllExtensions` | нет | Загрузить все расширения (только полностью; частями — по одному через `-Extension`) |
| `-NoApplyCheck` | нет | Не проверять применимость расширения после загрузки |
| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
### Режимы загрузки
| Режим | Описание |
|-------|----------|
| `Full` | Полная загрузка — замена всей конфигурации из каталога XML |
| `Partial` | Частичная — перечисленные объекты вместе с их дочерними (формы, макеты) и `Ext/` |
> Если в список файлов включить `Configuration.xml`, платформа выполнит **полную загрузку конфигурации**, а не только перечисленных объектов.
### Формат файла списка (listFile)
Файл содержит **относительные пути к файлам** в каталоге выгрузки (один на строку), кодировка **UTF-8 с BOM**:
```
Catalogs/Номенклатура.xml
Catalogs/Номенклатура/Ext/ObjectModule.bsl
Documents/Заказ.xml
Documents/Заказ/Forms/ФормаДокумента.xml
```
## После выполнения
Если `-UpdateDB` не был указан — **предложи выполнить `/db-update`** для применения изменений к БД
## Примеры
```powershell
# Полная загрузка
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
# Частичная загрузка конкретных файлов
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
# Загрузка расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
# Загрузка + обновление БД в одном запуске
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills