diff --git a/.claude/skills/db-load-git/SKILL.md b/.claude/skills/db-load-git/SKILL.md index 43edcd42..d3cb7cf4 100644 --- a/.claude/skills/db-load-git/SKILL.md +++ b/.claude/skills/db-load-git/SKILL.md @@ -1,114 +1,78 @@ ---- -name: db-load-git -description: Загрузка изменений из Git в базу 1С. Используй когда пользователь просит загрузить изменения из гита, обновить базу из репозитория, partial load из коммита -argument-hint: "[database] [source]" -allowed-tools: - - Bash - - Read - - Glob - - AskUserQuestion ---- - -# /db-load-git — Загрузка изменений из Git - -Определяет изменённые файлы конфигурации по данным Git и выполняет частичную загрузку в информационную базу. - -## Usage - -``` -/db-load-git [database] -/db-load-git dev — все незафиксированные изменения -/db-load-git dev -Source Staged — только staged -/db-load-git dev -Source Commit -CommitRange "HEAD~3..HEAD" -/db-load-git dev -DryRun — только показать что будет загружено -``` - -## Параметры подключения - -Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу: -1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую -2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json` -3. Если не указал — сопоставь текущую ветку Git с `databases[].branches` -4. Если ветка не совпала — используй `default` -Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1` -Если файла нет — предложи `/db-list add`. -Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`. -Если в записи базы указан `configSrc` — используй как каталог конфигурации. - -## Команда - -```powershell -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 <параметры> -``` - -### Параметры скрипта - -| Параметр | Обязательный | Описание | -|----------|:------------:|----------| -| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) | -| `-InfoBasePath <путь>` | * | Файловая база | -| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) | -| `-InfoBaseRef <имя>` | * | Имя базы на сервере | -| `-UserName <имя>` | нет | Имя пользователя | -| `-Password <пароль>` | нет | Пароль | -| `-ConfigDir <путь>` | да | Каталог XML-выгрузки (git-репозиторий) | -| `-Source <источник>` | нет | `All` (по умолч.) / `Staged` / `Unstaged` / `Commit` | -| `-CommitRange ` | для Commit | Диапазон коммитов (напр. `HEAD~3..HEAD`) | -| `-Extension <имя>` | нет | Загрузить в расширение | -| `-AllExtensions` | нет | Загрузить все расширения | -| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` | -| `-DryRun` | нет | Только показать что будет загружено (без загрузки) | -| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) | - -> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef` - -### Источники изменений - -| Source | Описание | -|--------|----------| -| `All` | Все незафиксированные: staged + unstaged + untracked | -| `Staged` | Только проиндексированные (git add) | -| `Unstaged` | Изменённые но не проиндексированные + новые (untracked) файлы | -| `Commit` | Файлы из диапазона коммитов (требует `-CommitRange`) | - -### Логика маппинга BSL → XML - -Для `.bsl` файлов скрипт автоматически добавляет: -1. XML объекта верхнего уровня (напр. `Catalogs/Номенклатура.xml`) -2. Все файлы из каталога `Ext/` этого объекта (связанные модули) - -Пропускаются: `ConfigDumpInfo.xml`, файлы вне `ConfigDir`. - -## Коды возврата - -| Код | Описание | -|-----|----------| -| 0 | Успешно (или нет изменений) | -| 1 | Ошибка (см. лог) | - -## После выполнения - -1. Показать список загруженных файлов -2. Если `-UpdateDB` не был указан — **предложить `/db-update`** для применения изменений к БД - -## Примеры - -```powershell -# Загрузить все незафиксированные изменения (файловая база) -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source All - -# Только staged -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source Staged - -# Серверная база -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Source All - -# Из диапазона коммитов -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD" - -# Только посмотреть (DryRun) -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -DryRun - -# Загрузка + обновление БД в одном запуске -powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source All -UpdateDB -``` +--- +name: db-load-git +description: Загрузка изменений из Git в базу 1С. Используй когда пользователь просит загрузить изменения из гита, обновить базу из репозитория, partial load из коммита +argument-hint: "[database] [source]" +allowed-tools: + - Bash + - Read + - Glob + - AskUserQuestion +--- + +# /db-load-git — Загрузка изменений из Git + +Определяет изменённые файлы конфигурации по данным Git и выполняет частичную загрузку в информационную базу. + +## Usage + +``` +/db-load-git [database] +/db-load-git dev — все незафиксированные изменения +/db-load-git dev -Source Staged — только staged +/db-load-git dev -Source Commit -CommitRange "HEAD~3..HEAD" +/db-load-git dev -DryRun — только показать что будет загружено +``` + +## Параметры подключения + +Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу: +1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую +2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json` +3. Если не указал — сопоставь текущую ветку Git с `databases[].branches` +4. Если ветка не совпала — используй `default` +Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1` +Если файла нет — предложи `/db-list add`. +Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`. +Если в записи базы указан `configSrc` — используй как каталог конфигурации. + +## Команда + +```powershell +powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 <параметры> +``` + +### Параметры скрипта + +| Параметр | Обязательный | Описание | +|----------|:------------:|----------| +| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) | +| `-InfoBasePath <путь>` | * | Файловая база | +| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) | +| `-InfoBaseRef <имя>` | * | Имя базы на сервере | +| `-UserName <имя>` | нет | Имя пользователя | +| `-Password <пароль>` | нет | Пароль | +| `-ConfigDir <путь>` | да | Каталог XML-выгрузки (git-репозиторий) | +| `-Source <источник>` | нет | `All` (по умолч.) / `Staged` / `Unstaged` / `Commit` | +| `-CommitRange ` | для Commit | Диапазон коммитов (напр. `HEAD~3..HEAD`) | +| `-Extension <имя>` | нет | Загрузить в расширение | +| `-AllExtensions` | нет | Загрузить все расширения | +| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` | +| `-DryRun` | нет | Только показать что будет загружено (без загрузки) | +| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) | + +> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef` + +## После выполнения + +1. Показать список загруженных файлов и результат из лога +2. Если `-UpdateDB` не был указан — **предложить `/db-update`** для применения изменений к БД + +## Примеры + +```powershell +# Все незафиксированные изменения +powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source All -UpdateDB + +# Из диапазона коммитов +powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD" +```