db-update — скилл для Claude Code: обновление конфигурации БД 1С
Применяет изменения основной конфигурации 1С к конфигурации базы данных. Нужен, когда после загрузки XML или Git-ветки надо отдельным шагом обновить БД.
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает db-update
Скилл вызывает /UpdateDBCfg через PowerShell-скрипт scripts/db-update.ps1. У /db-load-xml и /db-load-git то же самое делает ключ -UpdateDB, а здесь обновление вынесено в отдельный шаг — удобно, если загрузка и применение разведены по времени.
Базу скилл разрешает по .v8-project.json из корня проекта: сначала смотрит на явные параметры подключения, потом ищет по id, alias или name, затем сопоставляет текущую ветку Git с databases[].branches, а если совпадения нет — берёт запись default. Платформа берётся из v8path найденной записи, иначе из корневого v8path. Если файла нет, скилл предложит /db-list add.
Для файловой базы нужен -InfoBasePath, для серверной — пара -InfoBaseServer и -InfoBaseRef. Есть -Dynamic on для обновления без монопольного доступа к базе, -Extension и -AllExtensions для расширений, а для серверной базы — фоновые режимы: -BackgroundStart, -BackgroundFinish, -BackgroundCancel, -BackgroundSuspend, -BackgroundResume. Учтите: -Dynamic on не сработает там, где обновление требует монопольного доступа.
Какие задачи решает
- применить изменения конфигурации к базе 1С после загрузки XML
- обновить БД без монопольного доступа через динамическое обновление
- обновить одно расширение или сразу все
- запустить фоновое обновление серверной базы и дождаться его окончания
- сопоставить текущую ветку Git с нужной базой из
.v8-project.json
Примеры запросов агенту
- /db-update dev
- /db-update dev -Dynamic on
- обнови конфигурацию базы данных 1С для базы dev
Как установить db-update
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-update -a claude-code3Вручную: положить файлы
~/.claude/skills/db-update/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/db-update/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-update -a codex2Вручную: положить файлы
.agents/skills/db-update/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/db-update/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills db-update2Вручную: положить файлы
.github/skills/db-update/SKILL.mdКомандой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/db-updateВручную: положить файлы
.devin/skills/db-update/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о db-update
Как установить db-update в Claude?
Через маркетплейс: сначала /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills. Альтернатива — npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-update -a claude-code.
Что делает db-update?
Применяет изменения основной конфигурации к конфигурации базы данных 1С через /UpdateDBCfg. Запускается отдельным шагом после загрузки конфигурации.
Что нужно, чтобы скилл нашёл базу?
Файл .v8-project.json в корне проекта. Скилл разрешает базу по явным параметрам, по id, alias или name, по текущей ветке Git или по записи default. Если файла нет, он предложит /db-list add.
Исходный текст
SKILL.md · MIT
---
name: db-update
description: Обновление конфигурации базы данных 1С. Используй когда нужно обновить БД, применить конфигурацию, UpdateDBCfg
argument-hint: "[database]"
allowed-tools:
- Bash
- Read
- Glob
- AskUserQuestion
---
# /db-update — Обновление конфигурации БД
Применяет изменения основной конфигурации к конфигурации базы данных (`/UpdateDBCfg`) —
отдельным шагом после загрузки. У `/db-load-xml` и `/db-load-git` то же самое делает
ключ `-UpdateDB`.
## Usage
```
/db-update [database]
/db-update dev
/db-update dev -Dynamic on
```
## Параметры подключения
Прочитай `.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`.
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
```
### Параметры скрипта
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-Extension <имя>` | нет | Обновить расширение |
| `-AllExtensions` | нет | Обновить все расширения |
| `-NoApplyCheck` | нет | Не проверять применимость расширения после обновления |
| `-Dynamic <on/off>` | нет | `on` — динамическое обновление, без монопольного доступа к базе; `off` — отключить |
| `-Server` | нет | Обновление на стороне сервера |
| `-WarningsAsErrors` | нет | Предупреждения считать ошибками |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
### Фоновое обновление (серверная база)
| Параметр | Описание |
|----------|----------|
| `-BackgroundStart` | Начать фоновое обновление |
| `-BackgroundFinish` | Дождаться окончания |
| `-BackgroundCancel` | Отменить |
| `-BackgroundSuspend` | Приостановить |
| `-BackgroundResume` | Возобновить |
## Примеры
```powershell
# Обычное обновление (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
# Динамическое обновление
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic on
# Обновление расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills