docs(db-load-git): trim SKILL.md, update mapping docs for v1.3

Remove redundant sections (Source table, exit codes, mapping internals)
and trim examples from 6 to 2. Update mapping description to reflect
that all non-XML files (not just BSL) are now handled.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-03-20 18:37:26 +03:00
co-authored by Claude Opus 4.6
parent ab7d82ba20
commit ca0dac2693
+4 -40
View File
@@ -62,53 +62,17 @@ powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.p
> `*` — нужен либо `-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. Показать список загруженных файлов
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 -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" -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
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"
```