feat(skd-edit): значение-список параметра в шортхенде (+skd-compile)

Значение по умолчанию у параметра СКД может быть списком (несколько <value> подряд при valueListAllowed=true). Раньше задать список можно было только через объектную модель skd-compile; шортхенд (add/modify-parameter, parameters) парсил value= как скаляр. Теперь в шортхенде: value=v1, v2, v3 задаёт список (кавычки '...' для запятой внутри значения). Если задан список (>=2 элементов), valueListAllowed выводится автоматически. Авто-вывод только в шортхенде — объектная модель остаётся буквальной (bit-perfect round-trip сохранён). skd-edit (ps1+py v1.25): - Split-QuotedCsv/Parse-ValueList — токенайзер по запятым с учётом кавычек, БЕЗ разреза по ':' (важно для дат вида 2024-01-01T12:30:45) - add-parameter: эмит N <value> - modify-parameter: пред-выемка value=-списка, удаление ВСЕХ старых <value>, авто valueListAllowed; scalar value= теперь тоже схлопывает список в один <value> skd-compile (ps1+py v1.105): тот же разбор списка в Parse-ParamShorthand; объектная модель не тронута. Документация: skd-edit/skd-compile SKILL.md (поведение), docs/1c-dcs-spec.md и docs/skd-dsl-spec.md (формат). Тесты: add-list, modify list<->scalar, список дат (двоеточия целы), compile- шортхенд. Полный регресс 413/413 на ps1 и py. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
feat(skd-info): флаг -Raw для lossless round-trip извлечения запроса
2026-07-17 08:15:16 +03:00 · 2026-06-04 12:26:57 +03:00 · 2026-06-03 22:11:48 +03:00 · 2026-06-02 20:07:09 +03:00 · 2026-06-02 20:07:03 +03:00 · 2026-06-02 17:41:06 +03:00
508 changed files with 42015 additions and 11353 deletions
@@ -0,0 +1,32 @@
+{
+  "name": "cc-1c-skills",
+  "interface": {
+    "displayName": "1C Skills"
+  },
+  "plugins": [
+    {
+      "name": "1c-skills",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/Nikolay-Shirokov/cc-1c-skills.git",
+        "ref": "port-codex"
+      },
+      "policy": {
+        "installation": "AVAILABLE"
+      },
+      "category": "Development"
+    },
+    {
+      "name": "1c-skills-py",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/Nikolay-Shirokov/cc-1c-skills.git",
+        "ref": "port-codex-py"
+      },
+      "policy": {
+        "installation": "AVAILABLE"
+      },
+      "category": "Development"
+    }
+  ]
+}
@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-marketplace-manifest.json",
+  "name": "cc-1c-skills",
+  "description": "Маркетплейс навыков для разработки на платформе 1С:Предприятие",
+  "owner": {
+    "name": "Nikolay Shirokov"
+  },
+  "plugins": [
+    {
+      "name": "1c-skills",
+      "source": "./",
+      "description": "[PowerShell] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент."
+    },
+    {
+      "name": "1c-skills-py",
+      "source": {
+        "source": "github",
+        "repo": "Nikolay-Shirokov/cc-1c-skills",
+        "ref": "port-claude-code-py"
+      },
+      "description": "[Python] То же — для Linux/Mac или когда PowerShell недоступен."
+    }
+  ]
+}
@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "1c-skills",
+  "description": "[PowerShell] Навыки для разработки на 1С:Предприятие 8.3 — абстракции над XML-форматами и CLI конфигуратора, плюс глаза и руки для тестирования через веб-клиент.",
+  "author": {
+    "name": "Nikolay Shirokov"
+  },
+  "homepage": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
+  "repository": "https://github.com/Nikolay-Shirokov/cc-1c-skills",
+  "license": "MIT",
+  "keywords": [
+    "1c",
+    "1c-dev",
+    "cf",
+    "cfe",
+    "epf",
+    "erf",
+    "metadata",
+    "configuration",
+    "extension",
+    "form",
+    "report",
+    "skd",
+    "data-processor",
+    "mxl",
+    "web-client",
+    "testing",
+    "test-automation"
+  ],
+  "skills": "./.claude/skills/"
+}
@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cf-edit/scripts/cf-edit.ps1 -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-edit.ps1" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
 ```

 ## Операции
@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cf-info/scripts/cf-info.ps1 -ConfigPath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-info.ps1" -ConfigPath "<путь>"
 ```

 ## Три режима
@@ -24,7 +24,7 @@ allowed-tools:
 | `CompatibilityMode` | Режим совместимости (default: `Version8_3_24`) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cf-init/scripts/cf-init.ps1 -Name "МояКонфигурация"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-init.ps1" -Name "МояКонфигурация"
 ```

 ## Примеры
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cf-validate/scripts/cf-validate.ps1 -ConfigPath "upload/cfempty"
-powershell.exe -NoProfile -File .claude/skills/cf-validate/scripts/cf-validate.ps1 -ConfigPath "upload/cfempty/Configuration.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-validate.ps1" -ConfigPath "upload/cfempty/Configuration.xml"
 ```
@@ -71,7 +71,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cfe-borrow/scripts/cfe-borrow.ps1 -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
 ```

 ## Примеры
@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cfe-diff/scripts/cfe-diff.ps1 -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-diff.ps1" -ExtensionPath src -ConfigPath C:\cfsrc\erp -Mode A
 ```

 ## Mode A — обзор расширения
@@ -44,7 +44,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cfe-init/scripts/cfe-init.ps1 -Name "МоёРасширение"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-init.ps1" -Name "МоёРасширение"
 ```

 ## Примеры
@@ -51,7 +51,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cfe-patch-method/scripts/cfe-patch-method.ps1 -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.ps1" -ExtensionPath src -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
 ```

 ## Примеры
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/cfe-validate/scripts/cfe-validate.ps1 -ExtensionPath "src"
-powershell.exe -NoProfile -File .claude/skills/cfe-validate/scripts/cfe-validate.ps1 -ExtensionPath "src/Configuration.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-validate.ps1" -ExtensionPath "src/Configuration.xml"
 ```
@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -65,14 +65,14 @@ powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 <

 ```powershell
 # Создать файловую базу
-powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 -InfoBasePath "C:\Bases\NewDB"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB"

 # Создать серверную базу
-powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test"

 # Создать из шаблона CF
-powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -UseTemplate "C:\Templates\config.cf"

 # Создать и добавить в список баз
-powershell.exe -NoProfile -File .claude/skills/db-create/scripts/db-create.ps1 -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-create.ps1" -InfoBasePath "C:\Bases\NewDB" -AddToList -ListName "Новая база"
 ```
@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-dump-cf/scripts/db-dump-cf.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -69,11 +69,11 @@ powershell.exe -NoProfile -File .claude/skills/db-dump-cf/scripts/db-dump-cf.ps1

 ```powershell
 # Выгрузка конфигурации (файловая база)
-powershell.exe -NoProfile -File .claude/skills/db-dump-cf/scripts/db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/db-dump-cf/scripts/db-dump-cf.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "config.cf"

 # Выгрузка расширения
-powershell.exe -NoProfile -File .claude/skills/db-dump-cf/scripts/db-dump-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
 ```
@@ -37,7 +37,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -81,17 +81,17 @@ powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-xml.p

 ```powershell
 # Полная выгрузка (файловая база)
-powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-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-dump-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/skills/db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes

 # Частичная выгрузка
-powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full

 # Выгрузка расширения
-powershell.exe -NoProfile -File .claude/skills/db-dump-xml/scripts/db-dump-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-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"
 ```
@@ -36,7 +36,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-load-cf/scripts/db-load-cf.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -71,11 +71,11 @@ powershell.exe -NoProfile -File .claude/skills/db-load-cf/scripts/db-load-cf.ps1

 ```powershell
 # Файловая база
-powershell.exe -NoProfile -File .claude/skills/db-load-cf/scripts/db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/db-load-cf/scripts/db-load-cf.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "config.cf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "config.cf"

 # Загрузка расширения
-powershell.exe -NoProfile -File .claude/skills/db-load-cf/scripts/db-load-cf.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
 ```
@@ -1,78 +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 <range>` | для 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"
-```
+---
+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_SKILL_DIR}/scripts/db-load-git.ps1" <параметры>
+```
+
+### Параметры скрипта
+
+| Параметр | Обязательный | Описание |
+|----------|:------------:|----------|
+| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
+| `-InfoBasePath <путь>` | * | Файловая база |
+| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
+| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
+| `-UserName <имя>` | нет | Имя пользователя |
+| `-Password <пароль>` | нет | Пароль |
+| `-ConfigDir <путь>` | да | Каталог XML-выгрузки (git-репозиторий) |
+| `-Source <источник>` | нет | `All` (по умолч.) / `Staged` / `Unstaged` / `Commit` |
+| `-CommitRange <range>` | для 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_SKILL_DIR}/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_SKILL_DIR}/scripts/db-load-git.ps1" -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"
+```
@@ -38,7 +38,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-load-xml/scripts/db-load-xml.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -96,14 +96,14 @@ Documents/Заказ/Forms/ФормаДокумента.xml

 ```powershell
 # Полная загрузка
-powershell.exe -NoProfile -File .claude/skills/db-load-xml/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" -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/skills/db-load-xml/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\cfsrc" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"

 # Загрузка расширения
-powershell.exe -NoProfile -File .claude/skills/db-load-xml/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\ext_src" -Mode Full -Extension "МоёРасширение"

 # Загрузка + обновление БД в одном запуске
-powershell.exe -NoProfile -File .claude/skills/db-load-xml/scripts/db-load-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
+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
 ```
@@ -36,7 +36,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -63,14 +63,14 @@ powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 <пар

 ```powershell
 # Простой запуск
-powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

 # Запуск с обработкой
-powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"

 # Открыть по навигационной ссылке
-powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"

 # Серверная база с параметром запуска
-powershell.exe -NoProfile -File .claude/skills/db-run/scripts/db-run.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
 ```
@@ -35,7 +35,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -83,11 +83,11 @@ powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 <

 ```powershell
 # Обычное обновление (файловая база)
-powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

 # Динамическое обновление (серверная база)
-powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"

 # Обновление расширения
-powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-update.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"
 ```
@@ -40,7 +40,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -62,8 +62,8 @@ powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 <

 ```powershell
 # Сборка обработки (файловая база)
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МояОбработка.xml" -OutputFile "build/МояОбработка.epf"
 ```
@@ -39,7 +39,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -62,8 +62,8 @@ powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <п

 ```powershell
 # Разборка обработки (файловая база)
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
 ```
@@ -30,7 +30,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-init/scripts/init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]
 ```

 ## Дальнейшие шаги
@@ -1,4 +1,4 @@
-# epf-init v1.0 — Init 1C external data processor scaffold
+# epf-init v1.1 — Init 1C external data processor scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -10,6 +10,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 $uuid1 = [guid]::NewGuid().ToString()
 $uuid2 = [guid]::NewGuid().ToString()
@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# epf-init v1.0 — Init 1C external data processor scaffold
+# epf-init v1.1 — Init 1C external data processor scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C external data processor."""
 import sys, os, argparse, uuid
@@ -24,7 +24,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МояОбработка"
-powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МояОбработка/МояОбработка.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-validate.ps1" -ObjectPath "src/МояОбработка/МояОбработка.xml"
 ```

@@ -42,7 +42,7 @@ allowed-tools:
 Используй общий скрипт из epf-build:

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -64,8 +64,8 @@ powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 <

 ```powershell
 # Сборка отчёта (файловая база)
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/epf-build/scripts/epf-build.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
 ```
@@ -41,7 +41,7 @@ allowed-tools:
 Используй общий скрипт из epf-dump:

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -64,8 +64,8 @@ powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <п

 ```powershell
 # Разборка отчёта (файловая база)
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МойОтчёт.erf" -OutputDir "src"

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-dump/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МойОтчёт.erf" -OutputDir "src"
 ```
@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/erf-init/scripts/init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/init.ps1" -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]
 ```

 ## Дальнейшие шаги
@@ -1,4 +1,4 @@
-# erf-init v1.0 — Init 1C external report scaffold
+# erf-init v1.1 — Init 1C external report scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -12,6 +12,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 $uuid1 = [guid]::NewGuid().ToString()
 $uuid2 = [guid]::NewGuid().ToString()
@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# erf-init v1.0 — Init 1C external report scaffold
+# erf-init v1.1 — Init 1C external report scaffold
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 """Generates minimal XML source files for a 1C external report."""
 import sys, os, argparse, uuid
@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МойОтчёт"
-powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-validate/scripts/epf-validate.ps1" -ObjectPath "src/МойОтчёт/МойОтчёт.xml"
 ```

@@ -32,7 +32,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/form-add/scripts/form-add.ps1 -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
 ```

 ## Purpose — назначение формы
@@ -1,4 +1,4 @@
-# form-add v1.4 — Add managed form to 1C config object
+# form-add v1.5 — Add managed form to 1C config object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -15,6 +15,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 # --- Detect XML format version ---

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# form-add v1.4 — Add managed form to 1C config object
+# form-add v1.5 — Add managed form to 1C config object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -29,10 +29,10 @@ allowed-tools:

 ```powershell
 # Режим JSON DSL
-powershell.exe -NoProfile -File .claude/skills/form-compile/scripts/form-compile.ps1 -JsonPath "<json>" -OutputPath "<Form.xml>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -JsonPath "<json>" -OutputPath "<Form.xml>"

 # Режим from-object (объект и purpose выводятся из OutputPath; Document и Catalog)
-powershell.exe -NoProfile -File .claude/skills/form-compile/scripts/form-compile.ps1 -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-compile.ps1" -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"
 ```

 ## JSON DSL — справка
@@ -240,6 +240,15 @@ powershell.exe -NoProfile -File .claude/skills/form-compile/scripts/form-compile
 ]}
 ```

+### Картинка-поле (picField)
+
+PictureField, привязанный к булеву/числу, рисует иконку только при заданном `valuesPicture`:
+
+| Ключ | Описание |
+|------|----------|
+| `valuesPicture` | Ref картинки значения: `"StdPicture.Favorites"`, `"CommonPicture.X"` |
+| `loadTransparent: true` | Скрыть кадр «нет значения» |
+
 ### Страницы (pages + page)

 | Ключ (pages) | Описание |
@@ -1,4 +1,4 @@
-# form-compile v1.20 — Compile 1C managed form from JSON or object metadata
+# form-compile v1.23 — Compile 1C managed form from JSON or object metadata
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[string]$JsonPath,
@@ -1912,6 +1912,7 @@ function Emit-Element {
 		# input-specific
 		"multiLine"=1;"passwordMode"=1;"choiceButton"=1;"clearButton"=1
 		"spinButton"=1;"dropListButton"=1;"markIncomplete"=1;"skipOnInput"=1;"inputHint"=1
+		"textEdit"=1
 		# label/hyperlink
 		"hyperlink"=1
 		# group-specific
@@ -1928,7 +1929,7 @@ function Emit-Element {
 		# button-specific
 		"type"=1;"command"=1;"stdCommand"=1;"defaultButton"=1;"locationInCommandBar"=1
 		# picture/decoration
-		"src"=1
+		"src"=1;"valuesPicture"=1;"loadTransparent"=1
 		# cmdBar-specific
 		"autofill"=1
 	}
@@ -2133,10 +2134,12 @@ function Emit-Input {
 	if ($el.multiLine -eq $true) { X "$inner<MultiLine>true</MultiLine>" }
 	if ($el.passwordMode -eq $true) { X "$inner<PasswordMode>true</PasswordMode>" }
 	if ($el.choiceButton -eq $false) { X "$inner<ChoiceButton>false</ChoiceButton>" }
+	elseif ($el.choiceButton -eq $true -and ($el.on -contains 'StartChoice')) { X "$inner<ChoiceButton>true</ChoiceButton>" }
 	if ($el.clearButton -eq $true) { X "$inner<ClearButton>true</ClearButton>" }
 	if ($el.spinButton -eq $true) { X "$inner<SpinButton>true</SpinButton>" }
 	if ($el.dropListButton -eq $true) { X "$inner<DropListButton>true</DropListButton>" }
 	if ($el.markIncomplete -eq $true) { X "$inner<AutoMarkIncomplete>true</AutoMarkIncomplete>" }
+	if ($el.textEdit -eq $false) { X "$inner<TextEdit>false</TextEdit>" }
 	if ($el.skipOnInput -eq $true) { X "$inner<SkipOnInput>true</SkipOnInput>" }
 	$hasAmw = $el.PSObject.Properties.Name -contains 'autoMaxWidth'
 	if ($hasAmw) {
@@ -2720,6 +2723,16 @@ function Emit-PictureField {
 	Emit-Title -el $el -name $name -indent $inner
 	Emit-CommonFlags -el $el -indent $inner

+	# ValuesPicture — picture (collection) used to render the field's value.
+	# Required for a Boolean-bound PictureField to actually show an icon.
+	# loadTransparent emitted only when true (1С default is false).
+	if ($el.valuesPicture) {
+		X "$inner<ValuesPicture>"
+		X "$inner`t<xr:Ref>$($el.valuesPicture)</xr:Ref>"
+		if ($el.loadTransparent) { X "$inner`t<xr:LoadTransparent>true</xr:LoadTransparent>" }
+		X "$inner</ValuesPicture>"
+	}
+
 	if ($el.width) { X "$inner<Width>$($el.width)</Width>" }
 	if ($el.height) { X "$inner<Height>$($el.height)</Height>" }

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# form-compile v1.20 — Compile 1C managed form from JSON or object metadata
+# form-compile v1.23 — Compile 1C managed form from JSON or object metadata
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 import argparse
 import copy
@@ -1350,6 +1350,7 @@ KNOWN_KEYS = {
    "maxWidth", "maxHeight",
    "multiLine", "passwordMode", "choiceButton", "clearButton",
    "spinButton", "dropListButton", "markIncomplete", "skipOnInput", "inputHint",
+    "textEdit",
    "hyperlink",
    "showTitle", "united", "collapsed",
    "children", "columns",
@@ -1357,7 +1358,7 @@ KNOWN_KEYS = {
    "commandBarLocation", "searchStringLocation",
    "pagesRepresentation",
    "type", "command", "stdCommand", "defaultButton", "locationInCommandBar",
-    "src",
+    "src", "valuesPicture", "loadTransparent",
    "autofill",
    "choiceMode", "initialTreeView", "enableDrag", "enableStartDrag",
    "rowPictureDataPath", "tableAutofill",
@@ -1932,6 +1933,8 @@ def emit_input(lines, el, name, eid, indent):
        lines.append(f'{inner}<PasswordMode>true</PasswordMode>')
    if el.get('choiceButton') is False:
        lines.append(f'{inner}<ChoiceButton>false</ChoiceButton>')
+    elif el.get('choiceButton') is True and 'StartChoice' in (el.get('on') or []):
+        lines.append(f'{inner}<ChoiceButton>true</ChoiceButton>')
    if el.get('clearButton') is True:
        lines.append(f'{inner}<ClearButton>true</ClearButton>')
    if el.get('spinButton') is True:
@@ -1940,6 +1943,8 @@ def emit_input(lines, el, name, eid, indent):
        lines.append(f'{inner}<DropListButton>true</DropListButton>')
    if el.get('markIncomplete') is True:
        lines.append(f'{inner}<AutoMarkIncomplete>true</AutoMarkIncomplete>')
+    if el.get('textEdit') is False:
+        lines.append(f'{inner}<TextEdit>false</TextEdit>')
    if el.get('skipOnInput') is True:
        lines.append(f'{inner}<SkipOnInput>true</SkipOnInput>')
    if 'autoMaxWidth' in el:
@@ -2359,6 +2364,16 @@ def emit_picture_field(lines, el, name, eid, indent):
    emit_title(lines, el, name, inner)
    emit_common_flags(lines, el, inner)

+    # ValuesPicture \u2014 picture (collection) used to render the field's value.
+    # Required for a Boolean-bound PictureField to actually show an icon.
+    # loadTransparent emitted only when true (1\u0421 default is false).
+    if el.get('valuesPicture'):
+        lines.append(f'{inner}<ValuesPicture>')
+        lines.append(f'{inner}\t<xr:Ref>{el["valuesPicture"]}</xr:Ref>')
+        if el.get('loadTransparent'):
+            lines.append(f'{inner}\t<xr:LoadTransparent>true</xr:LoadTransparent>')
+        lines.append(f'{inner}</ValuesPicture>')
+
    if el.get('width'):
        lines.append(f'{inner}<Width>{el["width"]}</Width>')
    if el.get('height'):
@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/form-edit/scripts/form-edit.ps1 -FormPath "<путь>" -JsonPath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-edit.ps1" -FormPath "<путь>" -JsonPath "<путь>"
 ```

 ## JSON формат
@@ -15,7 +15,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/form-info/scripts/form-info.ps1 -FormPath "<путь к Form.xml>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-info.ps1" -FormPath "<путь к Form.xml>"
 ```

 ## Параметры
@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/form-remove/scripts/remove-form.ps1 -ObjectName "<ObjectName>" -FormName "<FormName>" [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/remove-form.ps1" -ObjectName "<ObjectName>" -FormName "<FormName>" [-SrcDir "<SrcDir>"]
 ```

 ## Что удаляется
@@ -1,4 +1,4 @@
-# form-remove v1.1 — Remove form from 1C object
+# form-remove v1.2 — Remove form from 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -12,6 +12,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 # --- Проверки ---

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# remove-form v1.0 — Remove form from 1C object
+# remove-form v1.1 — Remove form from 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/form-validate/scripts/form-validate.ps1 -FormPath "Catalogs/Номенклатура/Forms/ФормаЭлемента"
-powershell.exe -NoProfile -File .claude/skills/form-validate/scripts/form-validate.ps1 -FormPath "src/МояОбработка/Forms/Форма/Ext/Form.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-validate.ps1" -FormPath "Catalogs/Номенклатура/Forms/ФормаЭлемента"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-validate.ps1" -FormPath "src/МояОбработка/Forms/Форма/Ext/Form.xml"
 ```

@@ -1,4 +1,4 @@
-# form-validate v1.4 — Validate 1C managed form
+# form-validate v1.6 — Validate 1C managed form
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -366,13 +366,51 @@ if (-not $stopped) {
 		$dataPath = $dpNode.InnerText.Trim()
 		if (-not $dataPath) { continue }

+		# Opaque platform-internal DataPath shapes — not validatable from Form.xml alone:
+		#   - bare numeric (e.g. "10", "1000003") — internal index
+		#   - "N/M:<uuid>" — metadata reference by UUID
+		if ($dataPath -match '^\d+$' -or $dataPath -match '^\d+/\d+:[0-9a-fA-F-]+$') {
+			continue
+		}
+
 		$pathChecked++

 		# Extract root segment of path, strip array indices like [0]
 		$cleanPath = $dataPath -replace '\[\d+\]', ''
+		# Strip leading '~' (current row of DynamicList: ~Список.Поле)
+		if ($cleanPath.StartsWith('~')) { $cleanPath = $cleanPath.Substring(1) }
 		$segments = $cleanPath -split '\.'
 		$rootAttr = $segments[0]

+		# Resolve Items.<TableName>.CurrentData.<Field>... — table element, not attribute
+		if ($rootAttr -eq 'Items') {
+			if ($segments.Count -lt 3 -or $segments[2] -ne 'CurrentData') {
+				Report-Warn "[$tag] '$elName': DataPath='$dataPath' — unknown Items.* shape, expected Items.<Table>.CurrentData.*"
+				continue
+			}
+			$tableName = $segments[1]
+			$tableEl = $null
+			foreach ($candidate in $allElements) {
+				if ($candidate.Tag -eq 'Table' -and $candidate.Name -eq $tableName) {
+					$tableEl = $candidate
+					break
+				}
+			}
+			if (-not $tableEl) {
+				Report-Error "[$tag] '$elName': DataPath='$dataPath' — table element '$tableName' not found"
+				$pathErrors++
+				continue
+			}
+			$tableDpNode = $tableEl.Node.SelectSingleNode("f:DataPath", $nsMgr)
+			if (-not $tableDpNode -or -not $tableDpNode.InnerText.Trim()) {
+				# Table without DataPath — can't resolve further, accept silently
+				continue
+			}
+			$tableDp = $tableDpNode.InnerText.Trim() -replace '\[\d+\]', ''
+			if ($tableDp.StartsWith('~')) { $tableDp = $tableDp.Substring(1) }
+			$rootAttr = ($tableDp -split '\.')[0]
+		}
+
 		if (-not $attrMap.ContainsKey($rootAttr)) {
 			Report-Error "[$tag] '$elName': DataPath='$dataPath' — attribute '$rootAttr' not found"
 			$pathErrors++
@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# form-validate v1.4 — Validate 1C managed form
+# form-validate v1.6 — Validate 1C managed form
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -376,12 +376,44 @@ def main():
            if not data_path:
                continue

+            # Opaque platform-internal DataPath shapes — not validatable from Form.xml alone:
+            #   - bare numeric (e.g. "10", "1000003") — internal index
+            #   - "N/M:<uuid>" — metadata reference by UUID
+            if re.match(r'^\d+$', data_path) or re.match(r'^\d+/\d+:[0-9a-fA-F-]+$', data_path):
+                continue
+
            path_checked += 1

            clean_path = re.sub(r'\[\d+\]', '', data_path)
+            # Strip leading '~' (current row of DynamicList: ~\u0421\u043f\u0438\u0441\u043e\u043a.\u041f\u043e\u043b\u0435)
+            if clean_path.startswith('~'):
+                clean_path = clean_path[1:]
            segments = clean_path.split(".")
            root_attr = segments[0]

+            # Resolve Items.<TableName>.CurrentData.<Field>... \u2014 table element, not attribute
+            if root_attr == 'Items':
+                if len(segments) < 3 or segments[2] != 'CurrentData':
+                    report_warn(f"[{tag}] '{el_name}': DataPath='{data_path}' \u2014 unknown Items.* shape, expected Items.<Table>.CurrentData.*")
+                    continue
+                table_name = segments[1]
+                table_el = None
+                for candidate in all_elements:
+                    if candidate["Tag"] == 'Table' and candidate["Name"] == table_name:
+                        table_el = candidate
+                        break
+                if table_el is None:
+                    report_error(f"[{tag}] '{el_name}': DataPath='{data_path}' \u2014 table element '{table_name}' not found")
+                    path_errors += 1
+                    continue
+                table_dp_node = table_el["Node"].find(f"{{{F_NS}}}DataPath")
+                if table_dp_node is None or not (table_dp_node.text or "").strip():
+                    continue
+                table_dp = re.sub(r'\[\d+\]', '', (table_dp_node.text or "").strip())
+                if table_dp.startswith('~'):
+                    table_dp = table_dp[1:]
+                root_attr = table_dp.split(".")[0]
+
            if root_attr not in attr_map:
                report_error(f"[{tag}] '{el_name}': DataPath='{data_path}' \u2014 attribute '{root_attr}' not found")
                path_errors += 1
@@ -30,7 +30,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/help-add/scripts/add-help.ps1 -ObjectName "<ObjectName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-help.ps1" -ObjectName "<ObjectName>" [-Lang "<Lang>"] [-SrcDir "<SrcDir>"]
 ```

 ## Что делает скрипт
@@ -1,4 +1,4 @@
-# help-add v1.3 — Add built-in help to 1C object
+# help-add v1.4 — Add built-in help to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -10,6 +10,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 # --- Detect format version ---

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# add-help v1.3 — Add built-in help to 1C object
+# add-help v1.4 — Add built-in help to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда

 ```bash
-python .claude/skills/img-grid/scripts/overlay-grid.py "<ImagePath>" [-c 50] [-o "<OutputPath>"]
+python "${CLAUDE_SKILL_DIR}/scripts/overlay-grid.py" "<ImagePath>" [-c 50] [-o "<OutputPath>"]
 ```

 Требуется Python 3 с библиотекой Pillow (`pip install Pillow`).
@@ -29,13 +29,13 @@ allowed-tools:
 ### Inline mode

 ```powershell
-powershell.exe -NoProfile -File '.claude/skills/interface-edit/scripts/interface-edit.ps1' -CIPath '<path>' -Operation hide -Value '<cmd>'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-edit.ps1" -CIPath '<path>' -Operation hide -Value '<cmd>'
 ```

 ### JSON mode

 ```powershell
-powershell.exe -NoProfile -File '.claude/skills/interface-edit/scripts/interface-edit.ps1' -CIPath '<path>' -DefinitionFile '<json>'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-edit.ps1" -CIPath '<path>' -DefinitionFile '<json>'
 ```

 ## Операции
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи"
-powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи/Ext/CommandInterface.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи/Ext/CommandInterface.xml"
 ```
@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-compile/scripts/meta-compile.ps1 -JsonPath "<json>" -OutputDir "<ConfigDir>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-compile.ps1" -JsonPath "<json>" -OutputDir "<ConfigDir>"
 ```

 | Параметр | Описание |
@@ -1,4 +1,4 @@
-# meta-compile v1.11 — Compile 1C metadata object from JSON
+# meta-compile v1.12 — Compile 1C metadata object from JSON
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -502,6 +502,7 @@ function Parse-AttributeShorthand {
 		fillChecking = if ($val.fillChecking) { "$($val.fillChecking)" } else { "" }
 		indexing = if ($val.indexing) { "$($val.indexing)" } else { "" }
 		multiLine = if ($val.multiLine -eq $true) { $true } else { $false }
+		choiceHistoryOnInput = if ($val.choiceHistoryOnInput) { "$($val.choiceHistoryOnInput)" } else { "" }
 	}
 }

@@ -822,7 +823,8 @@ function Emit-Attribute {
 	X "$indent`t`t<CreateOnInput>Auto</CreateOnInput>"
 	X "$indent`t`t<ChoiceForm/>"
 	X "$indent`t`t<LinkByType/>"
-	X "$indent`t`t<ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>"
+	$chi = if ($parsed.choiceHistoryOnInput) { $parsed.choiceHistoryOnInput } else { "Auto" }
+	X "$indent`t`t<ChoiceHistoryOnInput>$chi</ChoiceHistoryOnInput>"

 	# Use — only for catalog top-level attributes
 	if ($context -eq "catalog") {
@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# meta-compile v1.11 — Compile 1C metadata object from JSON
+# meta-compile v1.12 — Compile 1C metadata object from JSON
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -465,6 +465,7 @@ def parse_attribute_shorthand(val):
        'fillChecking': str(val['fillChecking']) if val.get('fillChecking') else '',
        'indexing': str(val['indexing']) if val.get('indexing') else '',
        'multiLine': True if val.get('multiLine') is True else False,
+        'choiceHistoryOnInput': str(val['choiceHistoryOnInput']) if val.get('choiceHistoryOnInput') else '',
    }

 def parse_enum_value_shorthand(val):
@@ -774,7 +775,8 @@ def emit_attribute(indent, parsed, context):
    X(f'{indent}\t\t<CreateOnInput>Auto</CreateOnInput>')
    X(f'{indent}\t\t<ChoiceForm/>')
    X(f'{indent}\t\t<LinkByType/>')
-    X(f'{indent}\t\t<ChoiceHistoryOnInput>Auto</ChoiceHistoryOnInput>')
+    chi = parsed.get('choiceHistoryOnInput') or 'Auto'
+    X(f'{indent}\t\t<ChoiceHistoryOnInput>{chi}</ChoiceHistoryOnInput>')
    if context == 'catalog':
        X(f'{indent}\t\t<Use>ForItem</Use>')
    if context not in ('processor', 'processor-tabular'):
@@ -18,13 +18,13 @@ allowed-tools:
 ### Inline mode (простые операции)

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-edit/scripts/meta-edit.ps1 -ObjectPath "<path>" -Operation <op> -Value "<val>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-edit.ps1" -ObjectPath "<path>" -Operation <op> -Value "<val>"
 ```

 ### JSON mode (сложные/комбинированные)

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-edit/scripts/meta-edit.ps1 -DefinitionFile "<json>" -ObjectPath "<path>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-edit.ps1" -DefinitionFile "<json>" -ObjectPath "<path>"
 ```

 | Параметр | Описание |
@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-info/scripts/meta-info.ps1 -ObjectPath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-info.ps1" -ObjectPath "<путь>"
 ```

 ## Три режима
@@ -1,4 +1,4 @@
-# meta-info v1.1 — Compact summary of 1C metadata object
+# meta-info v1.2 — Compact summary of 1C metadata object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory=$true)][Alias('Path')][string]$ObjectPath,
@@ -422,6 +422,22 @@ $objName = $props.SelectSingleNode("md:Name", $ns).InnerText
 $synNode = $props.SelectSingleNode("md:Synonym", $ns)
 $synonym = Get-MLText $synNode

+# Presentations (type-choice dialogs show "Представление объекта" as the ref type name)
+$objPresentation = Get-MLText $props.SelectSingleNode("md:ObjectPresentation", $ns)
+$extObjPresentation = Get-MLText $props.SelectSingleNode("md:ExtendedObjectPresentation", $ns)
+$listPresentation = Get-MLText $props.SelectSingleNode("md:ListPresentation", $ns)
+$extListPresentation = Get-MLText $props.SelectSingleNode("md:ExtendedListPresentation", $ns)
+
+# Reference (ref-typed) metadata objects — those with a ...Ref type
+$refMdTypes = @("Catalog","Document","Enum","ChartOfAccounts","ChartOfCharacteristicTypes",
+	"ChartOfCalculationTypes","ExchangePlan","BusinessProcess","Task")
+$isRefObject = $refMdTypes -contains $mdType
+
+# Effective type presentation: ObjectPresentation -> Synonym -> Name
+$typePresentation = if ($objPresentation) { $objPresentation }
+	elseif ($synonym) { $synonym }
+	else { $objName }
+
 # --- Handle -Name drill-down ---
 $drillDone = $false
 if ($Name -and $childObjs) {
@@ -593,6 +609,17 @@ if (-not $drillDone) {
 	$header += " ==="
 	Out $header

+	# --- Type presentation (ref objects) ---
+	if ($isRefObject) {
+		Out "Представление типа: $typePresentation"
+		if ($Mode -eq "full") {
+			if ($objPresentation)     { Out "Представление объекта: $objPresentation" }
+			if ($extObjPresentation)  { Out "Расширенное представление объекта: $extObjPresentation" }
+			if ($listPresentation)    { Out "Представление списка: $listPresentation" }
+			if ($extListPresentation) { Out "Расширенное представление списка: $extListPresentation" }
+		}
+	}
+
 	# --- Mode: brief ---
 	if ($Mode -eq "brief") {
 		# Attributes
@@ -1,4 +1,4 @@
-# meta-info v1.1 — Compact summary of 1C metadata object (Python port)
+# meta-info v1.2 — Compact summary of 1C metadata object (Python port)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 import argparse
 import os
@@ -477,6 +477,21 @@ obj_name = inner_text(find(props, "md:Name"))
 syn_node = find(props, "md:Synonym")
 synonym = get_ml_text(syn_node)

+# Presentations (type-choice dialogs show "Представление объекта" as the ref type name)
+obj_presentation = get_ml_text(find(props, "md:ObjectPresentation"))
+ext_obj_presentation = get_ml_text(find(props, "md:ExtendedObjectPresentation"))
+list_presentation = get_ml_text(find(props, "md:ListPresentation"))
+ext_list_presentation = get_ml_text(find(props, "md:ExtendedListPresentation"))
+
+# Reference (ref-typed) metadata objects — those with a ...Ref type
+ref_md_types = {"Catalog", "Document", "Enum", "ChartOfAccounts",
+                "ChartOfCharacteristicTypes", "ChartOfCalculationTypes",
+                "ExchangePlan", "BusinessProcess", "Task"}
+is_ref_object = md_type in ref_md_types
+
+# Effective type presentation: ObjectPresentation -> Synonym -> Name
+type_presentation = obj_presentation or synonym or obj_name
+
 # ── Handle -Name drill-down ──────────────────────────────────

 drill_done = False
@@ -636,6 +651,19 @@ if not drill_done:
    header += " ==="
    out(header)

+    # Type presentation (ref objects)
+    if is_ref_object:
+        out(f"Представление типа: {type_presentation}")
+        if mode == "full":
+            if obj_presentation:
+                out(f"Представление объекта: {obj_presentation}")
+            if ext_obj_presentation:
+                out(f"Расширенное представление объекта: {ext_obj_presentation}")
+            if list_presentation:
+                out(f"Представление списка: {list_presentation}")
+            if ext_list_presentation:
+                out(f"Расширенное представление списка: {ext_list_presentation}")
+
    if mode == "brief":
        # Attributes
        attrs = get_attributes(child_objs) if child_objs is not None else []
@@ -32,7 +32,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-remove/scripts/meta-remove.ps1 -ConfigDir "<путь>" -Object "Catalog.Товары"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-remove.ps1" -ConfigDir "<путь>" -Object "Catalog.Товары"
 ```

 ## Поддерживаемые типы
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml"
-powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "Catalogs/Банки|Documents/Заказ"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-validate.ps1" -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/meta-validate.ps1" -ObjectPath "Catalogs/Банки|Documents/Заказ"
 ```
@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/mxl-compile/scripts/mxl-compile.ps1 -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-compile.ps1" -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"
 ```

 ## Рабочий процесс
@@ -29,7 +29,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/mxl-decompile/scripts/mxl-decompile.ps1 -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.ps1" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
 ```

 ## Рабочий процесс
@@ -38,12 +38,12 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/mxl-info/scripts/mxl-info.ps1 -TemplatePath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
 ```

 Или по имени обработки/макета:
 ```powershell
-powershell.exe -NoProfile -File .claude/skills/mxl-info/scripts/mxl-info.ps1 -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
 ```

 Дополнительные флаги:
@@ -23,7 +23,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/mxl-validate/scripts/mxl-validate.ps1 -TemplatePath "Catalogs/Номенклатура/Templates/Макет"
-powershell.exe -NoProfile -File .claude/skills/mxl-validate/scripts/mxl-validate.ps1 -TemplatePath "src/МояОбработка/Templates/ПечатнаяФорма"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "Catalogs/Номенклатура/Templates/Макет"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "src/МояОбработка/Templates/ПечатнаяФорма"
 ```

@@ -21,7 +21,7 @@ allowed-tools:
 | `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Roles/` и т.д.) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/role-compile/scripts/role-compile.ps1 -JsonPath "<json>" -OutputDir "<ConfigDir>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-compile.ps1" -JsonPath "<json>" -OutputDir "<ConfigDir>"
 ```

 Создаёт `{OutputDir}/Roles/Имя.xml` и `{OutputDir}/Roles/Имя/Ext/Rights.xml`. Регистрирует `<Role>` в `Configuration.xml`.
@@ -22,7 +22,7 @@ allowed-tools:
 ## Запуск скрипта

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/role-info/scripts/role-info.ps1 -RightsPath <path> -OutFile <output.txt>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-info.ps1" -RightsPath <path> -OutFile <output.txt>
 ```

 ### Параметры
@@ -23,5 +23,5 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/role-validate/scripts/role-validate.ps1 -RightsPath "Roles/МояРоль"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-validate.ps1" -RightsPath "Roles/МояРоль"
 ```
@@ -23,10 +23,10 @@ allowed-tools:

 ```powershell
 # Из файла
-powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -DefinitionFile "<json>" -OutputPath "<Template.xml>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-compile.ps1" -DefinitionFile "<json>" -OutputPath "<Template.xml>"

 # Из строки (без промежуточного файла)
-powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -Value '<json-string>' -OutputPath "<Template.xml>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-compile.ps1" -Value '<json-string>' -OutputPath "<Template.xml>"
 ```

 ## JSON DSL — краткий справочник
@@ -88,11 +88,20 @@ powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.p

 Многоязычный заголовок: `"title": { "ru": "...", "en": "..." }`. Применимо везде, где принимается title/presentation (поля, calculatedFields, parameters, settingsVariants, availableValues и пр.). Строка эквивалентна `{ "ru": "..." }`.

-Типы: `string`, `string(N)`, `decimal(D,F)`, `boolean`, `date`, `dateTime`, `CatalogRef.X`, `DocumentRef.X`, `EnumRef.X`, `StandardPeriod`. Ссылочные типы эмитируются с inline namespace `d5p1:` (`http://v8.1c.ru/8.1/data/enterprise/current-config`). Сборка EPF со ссылочными типами требует базу с соответствующей конфигурацией.
+Типы: `string`, `string(N)`, `decimal`, `decimal(D)`, `decimal(D,F)`, `boolean`, `date`, `dateTime`, `CatalogRef.X`, `DocumentRef.X`, `EnumRef.X`, `StandardPeriod`. Ссылочные типы эмитируются с inline namespace `d5p1:` (`http://v8.1c.ru/8.1/data/enterprise/current-config`). Сборка EPF со ссылочными типами требует базу с соответствующей конфигурацией.
+
+`decimal` без скобок = `10,2` (деньги по умолчанию), `decimal(N)` = `N,0` (целое); `,nonneg` в конце скобок → AllowedSign=Nonnegative.

 Составной тип (несколько типов значений) — массив в объектной форме: `"type": ["CatalogRef.A", "CatalogRef.B"]`. Квалификаторы (`(N)`, `(D,F)`) применяются к каждому элементу.

-Роли: `@dimension`, `@account`, `@balance`, `@period`.
+Роли (shorthand или объект):
+
+- `@`-флаги: `@dimension`, `@account`, `@balance`, `@period`, `@required`, `@autoOrder`, `@ignoreNullValues`
+- KV: `balanceGroupName`, `balanceType` (`OpeningBalance`/`ClosingBalance`), `parentDimension`, `accountTypeExpression`, `expression`, `orderType` (`Asc`/`Desc`), `periodNumber`, `periodType`
+
+```
+"Сумма: decimal(15,2) @balance balanceGroupName=Сумма balanceType=OpeningBalance"
+```

 Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.

@@ -101,6 +110,7 @@ powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.p
 Дополнительные ключи объектной формы:
 - `"presentationExpression": "<выражение>"` — что показывать вместо значения поля. Исходное значение остаётся «под капотом» для перехода/расшифровки.
 - `"appearance": { "<параметр>": "<значение>" }` — оформление колонки по умолчанию (применяется во всех вариантах настроек). Ключи — параметры платформы (`ГоризонтальноеПоложение`, `МинимальнаяШирина`, `Формат`, `Текст` и т.п.).
+- `"orderExpression": { "expression": "<выражение>", "orderType": "Asc"/"Desc", "autoOrder": true/false }` — сортировка поля по выражению (например `ЕстьNULL(Поле.Порядок, 10000)`).

 ```json
 { "field": "Сумма", "title": "Сумма продажи", "type": "decimal(15,2)",
@@ -142,11 +152,21 @@ Shorthand: `"Имя [Заголовок]: тип = значение @флаги"

 Флаги shorthand:
 - `@autoDates` — добавляет к параметру StandardPeriod пару дат `НачалоПериода`/`КонецПериода`, вычисляемых из него. Используй их в тексте запроса как `&НачалоПериода`/`&КонецПериода`; пользователь выбирает только сам период. По умолчанию сам параметр получает `use=Always` и `denyIncompleteValues=true` (чтобы производные даты всегда были заполнены); в объектной форме можно явно переопределить.
- `@valueList` — `<valueListAllowed>true</valueListAllowed>` — разрешает передавать список значений
+- `@valueList` — `<valueListAllowed>true</valueListAllowed>` — разрешает передавать список значений (при значении-списке ниже подразумевается автоматически)
 - `@hidden` — скрытый параметр: `availableAsField=false` + исключается из `"dataParameters": "auto"`

 Объектная форма: `title`, `hidden: true`, `valueListAllowed: true`, `availableAsField: false`, `denyIncompleteValues: true`, `use: "Always"`.

+Значение-список: несколько значений по умолчанию через запятую в `значение` (для запятой внутри значения — кавычки `'...'`). В объектной форме — массив в `value`.
+
+```json
+"parameters": [
+  "Виды: ChartOfCharacteristicTypesRef.ВидыСубконтоХозрасчетные = ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Контрагенты, ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Договоры"
+]
+```
+
+Если значения по умолчанию нет — пропусти `=` в shorthand или укажи `"value": null` в объектной форме.
+
 Список допустимых значений (availableValues):

 ```json
@@ -0,0 +1,52 @@
+---
+name: skd-decompile
+description: Декомпиляция схемы компоновки данных 1С (СКД) в JSON-черновик в формате skd-compile. Используй для scaffold нового отчёта по образцу или структурного рефакторинга. Не для точечных правок
+argument-hint: <TemplatePath> [-OutputPath <out.json>]
+disable-model-invocation: true
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /skd-decompile — JSON-черновик из Template.xml СКД
+
+Читает Template.xml и эмитит JSON в формате `skd-compile`. **Результат — черновик**, а не обратимое представление: см. раздел «Что получаешь».
+
+## Когда использовать
+
+- **Scaffold нового отчёта по образцу** — взять существующий СКД, получить JSON, поправить и скомпилировать в новый.
+- **Структурный рефакторинг** — переписать вариант, перерисовать шаблон, перебрать набор полей.
+
+## Когда **не** использовать
+
+- **Точечные правки готового отчёта** (добавить поле, фильтр, итог, переименовать) → `/skd-edit`. Цикл «декомпиляция → правка JSON → компиляция» переписывает шаблон целиком, может терять непокрытые конструкции и даёт большой diff в исходниках. `/skd-edit` правит адресно, без полной реконструкции.
+
+## Параметры
+
+| Параметр | Описание |
+|----------|----------|
+| `TemplatePath` | Путь к Template.xml (обязательный) |
+| `OutputPath` | Путь к выходному JSON. Если не задан — JSON в stdout |
+
+```powershell
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-decompile.ps1" -TemplatePath "<Template.xml>" -OutputPath "<out.json>"
+```
+
+## Что получаешь
+
+JSON-черновик в формате `/skd-compile` — **не полное обратимое представление СКД**. На вход компилятору такой JSON напрямую может не пойти: в нём встречаются sentinel-узлы (маркер `__unsupported__`).
+
+- **Готовые узлы** — большая часть СКД (поля, параметры, шаблоны, варианты со structure/filter/order/conditionalAppearance и т.п.) ложится в JSON как обычные узлы DSL.
+- **Sentinel-узлы** — места, где встретилась конструкция, которую декомпилятор не умеет выразить в DSL. JSON остаётся валидным, но компилятор откажется его собирать, пока sentinel не **заменён ручной реализацией** (явный raw `template`, прописанный appearance и т.п.) **или не удалён**, если в новом отчёте конструкция не нужна. Это намеренный барьер — чтобы непокрытое не уехало в финальный отчёт незамеченным.
+- **`<basename>.warnings.md`** рядом с `OutputPath` — список всех sentinel-узлов с координатами в исходнике, по нему удобно обходить места под ручную доработку.
+- **Критичные конструкции** (Picture cells, ХранилищеЗначения, вложенные схемы, не-СКД root) — скрипт падает с ненулевым кодом и сообщением в stderr; такой Template как образец не годится.
+
+## Workflow
+
+1. `/skd-decompile <Template.xml> -OutputPath draft.json` — получить черновик.
+2. Открыть `draft.warnings.md`, посмотреть, что не покрылось.
+3. Поправить JSON под задачу. Sentinel-узлы — заменить на ручную реализацию (через явный raw `template`, через ручное описание appearance и т.п.) либо удалить, если конструкция в новом отчёте не нужна.
+4. `/skd-compile -DefinitionFile draft.json -OutputPath new-Template.xml` — собрать обратно.
+5. `/skd-validate` + `/skd-info` — проверить.
@@ -25,7 +25,7 @@ allowed-tools:
 | `NoSelection` | (опц.) Не добавлять поле в selection варианта |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/skd-edit/scripts/skd-edit.ps1 -TemplatePath "<path>" -Operation <op> -Value "<value>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-edit.ps1" -TemplatePath "<path>" -Operation <op> -Value "<value>"
 ```

 ## Пакетный режим (batch)
@@ -52,11 +52,16 @@ Shorthand: `"Имя [Заголовок]: тип @роль #ограничени

 Поле добавляется в набор и в selection варианта (если нет `-NoSelection`). Дубликат dataPath — предупреждение, пропуск.

+Чтобы поле попало в selection не варианта, а конкретной группировки структуры — используй `-NoSelection` и затем `add-selection "Имя @group=ИмяГруппы"`.
+
 ### add-total — добавить итог

+Shorthand: `"<dataPath>: <выражение>"`. Если выражение — известная аггрегатная функция без скобок (`Сумма`, `Количество`, `Минимум`, `Максимум`, `Среднее`), оно автоматически оборачивается в `Func(dataPath)`. Если функция со скобками или произвольное выражение — используется как есть.
+
 ```
-"Цена: Среднее"
-"Стоимость: Сумма(Кол * Цена)"
+"Цена: Среднее"                  # → Среднее(Цена)
+"Стоимость: Сумма(Кол * Цена)"   # → как есть
+"Проверка: Проверка"             # identity: выражение = Проверка
 ```

 ### add-calculated-field — добавить вычисляемое поле
@@ -80,24 +85,54 @@ Shorthand: `"Имя [Заголовок]: тип = Выражение #noFilter
 "Организация: CatalogRef.Организации"
 ```

-Shorthand: `"Имя [Заголовок]: тип = значение @флаги"`. `[Заголовок]` опциональный — добавляет `<title>`.
+Shorthand: `"Имя [Заголовок]: тип = значение [availableValue=список] [@флаги]"`. `[Заголовок]` опциональный — добавляет `<title>`.

-`@autoDates` генерирует пару скрытых параметров `ДатаНачала`/`ДатаОкончания` для StandardPeriod-параметра — для БСП-отчётов, чтобы получить пару полей «Начало/Конец» в панели быстрых настроек.
+Флаги:
+- `@autoDates` — генерирует пару скрытых параметров `ДатаНачала`/`ДатаОкончания` для StandardPeriod-параметра.
+- `@hidden` — скрывает параметр от пользовательских настроек (для параметров-констант, используемых в запросе).
+- `@always` — параметр всегда подставляется в запрос. Часто вместе с `@hidden`, но используется и отдельно (для видимых обязательных параметров типа отчётного периода).
+- `@valueList` — разрешает передавать в параметр список значений (при значении-списке ниже подразумевается автоматически, отдельно указывать не обязательно).
+
+Значение-список: несколько значений по умолчанию задаются через запятую в `значение`. Для запятой внутри одного значения — кавычки `'...'`.
+
+```
+"Виды [Виды субконто]: ChartOfCharacteristicTypesRef.ВидыСубконтоХозрасчетные = ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Контрагенты, ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Договоры"
+```
+
+```
+"ПС: CatalogRef.Контрагенты = Справочник.Контрагенты.ПустаяСсылка @hidden"
+"Период: StandardPeriod = LastMonth @always"
+"ПСчет: ChartOfAccountsRef.Хозрасчетный = ПланСчетов.Хозрасчетный.X @hidden @always"
+"Округление: EnumRef.Округления = Окр1 availableValue=Перечисление.Округления.Окр1: руб., Перечисление.Округления.Окр1000: тыс."
+```
+
+`availableValue=` задаёт начальный список допустимых значений. Формат списка: `v1[: p1], v2[: p2], ...` — элементы через `,`, представление после `:`. Если в значении или представлении встречается `,` или `:` — оборачивай в одинарные кавычки `'...'`:
+
+```
+"Округление: ... = Окр1 availableValue=Окр1_00: 'руб., коп.', Окр1: руб."
+```

 ### modify-parameter — изменить существующий параметр

-Находит параметр по имени, добавляет/обновляет свойства.
+Shorthand: `"ИмяПараметра [Заголовок] [ключ=значение]... [@флаги]"`. Находит параметр по имени, обновляет указанные свойства.

 ```
 "ПорядокОкругления use=Always"
 "ПорядокОкругления [Округление сумм] denyIncompleteValues=true"
 "ПериодОтчета [Отчетный период]"                                  # только title
-"ПорядокОкругления availableValue=Перечисление.Округления.Окр1 presentation=руб."
+"ПорядокОкругления availableValue=Перечисление.Округления.Окр1: руб., Перечисление.Округления.Окр1000: тыс."
+"СчетПС value=ПланСчетов.Хозрасчетный.КассаПредприятия"
+"Виды value=ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Контрагенты, ПланВидовХарактеристик.ВидыСубконтоХозрасчетные.Договоры"
+"Контрагент @hidden @always"
 ```

 `[Заголовок]` опциональный — устанавливает или заменяет `<title>`. Можно вызывать без других kv-пар, чтобы только обновить title.

-`availableValue=` добавляет один элемент списка допустимых значений (можно несколько через `;;`). Тип значения определяется автоматически (DesignTimeValue для ссылок).
+`availableValue=` **заменяет весь список** допустимых значений (старые удаляются). Формат и кавычки — те же, что в `add-parameter`.
+
+`value=` заменяет значение параметра. Несколько значений через запятую → **список значений** (заменяет все прежние); для запятой внутри значения — кавычки `'...'`.
+
+Флаги `@hidden` / `@always` — те же, что и в `add-parameter`. Идемпотентны.

 ### rename-parameter — переименовать параметр

@@ -229,15 +264,21 @@ Value — имена ресурсов (как в полях/вычисляемы

 Не поддерживает пакетный режим. Value — полный текст запроса или `@path/to/file.sql` (ссылка на внешний файл). Путь разрешается относительно Template.xml, затем CWD.

+Когда что: **существенная переработка** (добавить поля, соединения, переписать пакет) → выгрузи запрос через `/skd-info <tpl> -Mode query -Name <набор> -Raw -OutFile file.sql`, отредактируй файл, верни `set-query @file`. `-Raw` отдаёт запрос целиком без декораций, поэтому выгрузка ↔ возврат точны (включая многопакетные запросы). **Точечная замена** (переименовать идентификатор, заменить подстроку) → выгрузка не нужна, используй `patch-query` ниже.
+
 ### patch-query — точечная замена в тексте запроса

-Shorthand: `"старое => новое"`. Заменяет все вхождения подстроки. Поддерживает пакетный режим и `-DataSet`.
+Shorthand: `"старое => новое [@once]"`. По умолчанию заменяет все вхождения подстроки. Поддерживает пакетный режим и `-DataSet`.

 ```
 "СубконтоДт1) В => СубконтоКт1) В"
-"ЛЕВОЕ СОЕДИНЕНИЕ => ВНУТРЕННЕЕ СОЕДИНЕНИЕ"
+"КАК ВТ_СтароеИмя => КАК ВТ_НовоеИмя @once"
 ```

+`@once` — упасть с ошибкой, если в запросе не **ровно одно** вхождение. Защищает от случайных замен в комментариях и однотипных идентификаторах.
+
+Многострочные подстроки поддерживаются.
+
 ### set-outputParameter — установить параметр вывода

 ```
@@ -249,16 +290,27 @@ Shorthand: `"старое => новое"`. Заменяет все вхожде

 ### set-structure — установить структуру варианта

-Shorthand: `"Поле1 > Поле2 > details"`. `details`/`детали` — детальные записи. Заменяет всю структуру. Не поддерживает пакетный режим.
+Shorthand: `"Поле1 > Поле2 > details"`. `>` — вложенный уровень группировки, `,` — несколько полей в одном уровне, `details` — детальные записи. **Заменяет всю структуру полностью** (включая Selection/order/filter/conditionalAppearance каждой группы). Для точечной модификации полей группировки с сохранением настроек — используй `modify-structure`. Не поддерживает пакетный режим.

 ```
 "Организация > Номенклатура > details"
+"Валюта, НаименованиеБанка, ИНН"
 "details"
 "СчетМеждународногоУчета @name=ДанныеОтчета"
 ```

 `@name=Имя` — присваивает имя группировке (`<dcsset:name>`). Используется для привязки шаблонов через `groupName`.

+### modify-structure — изменить поля группировки существующей группы
+
+Тот же shorthand что и `set-structure`. Находит группу по `@name=`, заменяет только `<groupItems>` (поля группировки). Selection/order/filter/conditionalAppearance/outputParameters группы сохраняются. Без `@name=` — ошибка.
+
+```
+"Валюта @name=ДанныеОтчета"
+"Валюта, НаименованиеБанка @name=ДанныеОтчета"
+"details @name=ДанныеОтчета"
+```
+
 ### modify-field — изменить существующее поле

 Тот же shorthand что и `add-field`. Находит по dataPath, объединяет свойства (непустые переопределяют), сохраняет позицию.
@@ -267,6 +319,23 @@ Shorthand: `"Поле1 > Поле2 > details"`. `details`/`детали` — д
 "Цена [Цена USD]: decimal(10,4) @dimension"
 ```

+### set-field-role — установить роль поля
+
+Shorthand: `"<dataPath> [@флаги] [kv=значение]"`. **Полностью заменяет** роль поля. Если в значении только dataPath без флагов/kv — удаляет роль.
+
+```
+"Сумма"                                                                 # снять роль полностью
+"СуммаОстаток @balance"                                                 # простая балансовая роль
+"СуммаНач @balance balanceGroupName=Сумма balanceType=OpeningBalance"   # с уточнением
+"Контрагент @dimension parentDimension=Группа"
+"Период @period"                                                        # роль периода
+```
+
+Флаги: `@balance`, `@dimension`, `@account`, `@period`, `@required`, `@autoOrder`, `@ignoreNullValues`.
+KV: `balanceGroupName`, `balanceType` (OpeningBalance/ClosingBalance), `parentDimension`, `accountTypeExpression`, `orderType` (Asc/Desc), `expression`, `periodNumber`, `periodType`.
+
+Поддерживает пакетный режим (`;;`).
+
 ### modify-filter — изменить существующий фильтр

 Тот же shorthand что и `add-filter`. Находит по полю, обновляет оператор/значение/флаги. См. правило для `<use>` ниже.
@@ -294,6 +363,7 @@ Shorthand: `"Поле1 > Поле2 > details"`. `details`/`детали` — д
 | `clear-selection` | `*` | Очищает все элементы selection |
 | `clear-order` | `*` | Очищает все элементы order |
 | `clear-filter` | `*` | Очищает все элементы filter |
+| `clear-conditionalAppearance` | `*` | Очищает все правила условного оформления |

 ## Верификация

@@ -1,7 +1,7 @@
 ---
 name: skd-info
 description: Анализ структуры схемы компоновки данных 1С (СКД) — наборы, поля, параметры, варианты. Используй для понимания отчёта — источник данных (запрос), доступные поля, параметры
-argument-hint: <TemplatePath> [-Mode overview|query|fields|links|calculated|resources|params|variant|templates|trace|full] [-Name <dataset|variant|field|group>]
+argument-hint: <TemplatePath> [-Mode overview|query|fields|links|calculated|resources|params|variant|templates|trace|full] [-Name <dataset|variant|field|group>] [-Raw]
 allowed-tools:
  - Bash
  - Read
@@ -20,17 +20,19 @@ allowed-tools:
 | `Mode` | Режим анализа (по умолчанию `overview`) |
 | `Name` | Имя набора (query), поля (fields/calculated/resources/trace), варианта (variant) или группировки/поля (templates) |
 | `Batch` | Номер пакета запроса, 0 = все (только query) |
-| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк) |
+| `Raw` | (только query) сырой текст запроса целиком, без заголовков/оглавления/разделителей пакетов. Для выгрузки в `.sql` и возврата через `skd-edit set-query @file` |
+| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк; `-Raw` не усекается) |
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/skd-info/scripts/skd-info.ps1 -TemplatePath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-info.ps1" -TemplatePath "<путь>"
 ```

 С указанием режима:
 ```powershell
 ... -Mode query -Name НоменклатураСЦенами
 ... -Mode query -Name ДанныеТ13 -Batch 3
+... -Mode query -Name ДанныеТ13 -Raw -OutFile query.sql
 ... -Mode fields -Name КадастроваяСтоимость
 ... -Mode calculated -Name КоэффициентКи
 ... -Mode resources -Name СуммаНалога
@@ -45,7 +47,7 @@ powershell.exe -NoProfile -File .claude/skills/skd-info/scripts/skd-info.ps1 -Te
 | Режим | Без `-Name` | С `-Name` |
 |-------|-------------|-----------|
 | `overview` | Навигационная карта схемы + подсказки Next | — |
-| `query` | — | Текст запроса набора (с оглавлением батчей) |
+| `query` | — | Текст запроса набора (с оглавлением батчей); `-Raw` — чистая выгрузка для правки |
 | `fields` | Карта: имена полей по наборам | Деталь поля: набор, тип, роль, формат |
 | `links` | Все связи наборов | — |
 | `calculated` | Карта: имена вычисляемых полей | Выражение + заголовок + ограничения |
@@ -65,7 +67,10 @@ powershell.exe -NoProfile -File .claude/skills/skd-info/scripts/skd-info.ps1 -Te
 3. `query -Name <набор>` — посмотреть текст SQL-запроса
 4. `variant -Name <N>` — посмотреть группировки и фильтры варианта

-Подробные примеры вывода каждого режима — в `modes-reference.md`.
+Переработка запроса (round-trip): `query -Name <набор> -Raw -OutFile q.sql` →
+правка `q.sql` → `/skd-edit <tpl> -Operation set-query -Value "@q.sql"`. Флаг
+`-Raw` отдаёт запрос целиком без декораций, поэтому выгрузка ↔ возврат
+точны (включая многопакетные запросы с временными таблицами).

 ## Верификация

@@ -1,246 +0,0 @@
-# /skd-info — полная справка по режимам
-
-Компактное описание — в [SKILL.md](SKILL.md).
-
-## overview (по умолчанию) — карта схемы
-
-Компактная навигационная карта (10-25 строк). Показывает структуру и подсказывает следующие шаги:
-
-```
-=== DCS: ОсновнаяСхемаКомпоновкиДанных (362 lines) ===
-
-Sources: ИсточникДанных1 (Local)
-
-Datasets:
-  [Query]  НоменклатураСЦенами   7 fields, query 40 lines
-Calculated: 1
-Resources: 1
-Templates: 1 templates, 1 group bindings
-Params: (none)
-
-Variants:
-  [1] НоменклатураИЦены  "Номенклатура и цены"  Table(detail)  3 filters
-  [2] НоменклатураБезЦен  "Номенклатура без цен"  Group(detail)  2 filters
-
-Next:
-  -Mode query             query text
-  -Mode fields            field tables by dataset
-  -Mode calculated        calculated field expressions
-  -Mode resources         resource aggregation
-  -Mode variant -Name <N> variant structure (1..2)
-```
-
-Для DataSetUnion — дерево наборов + связи:
-```
-Datasets:
-  [Union] РасчетНалогаНаИмущество  52 fields
-    ├─ [Query] РасчетНалогаНаИмущество   51 fields, query 181 lines
-    ├─ [Query] ДанныеПоКадастровой   29 fields, query 40 lines
-    ├─ [Query] ДанныеПоСреднегодовой   34 fields, query 41 lines
-Links: РасчетНалогаНаИмущество -> СостояниеОС (2 fields)
-```
-
-Параметры разделяются на видимые/скрытые:
-```
-Params: 18 (7 visible, 11 hidden): Период, Ответственный, ...
-```
-
-## query — текст запроса
-
-`-Name <набор>` — имя DataSet (обязателен если наборов > 1).
-
-Извлекает raw-текст запроса с деэкранированием XML (`&amp;`→`&`, `&gt;`→`>`). Для пакетных запросов — оглавление батчей:
-
-```
-=== Query: ДанныеТ13 (334 lines, 13 batches) ===
-  Batch 1: lines 1-8     → ПОМЕСТИТЬ Представления_Периоды
-  Batch 2: lines 9-26    → ПОМЕСТИТЬ Представления_СотрудникиОрганизации
-  ...
--- Batch 1 ---
-ВЫБРАТЬ
-  ДАТАВРЕМЯ(1, 1, 1) КАК Период
-ПОМЕСТИТЬ Представления_Периоды
-...
-```
-
-Фильтр по номеру батча: `-Batch 3` покажет только 3-й пакет.
-
-## fields — поля наборов данных
-
-Без `-Name` — карта: имена полей по наборам:
-```
-=== Fields map ===
-СостояниеОС [Query] (3): Организация, ОсновноеСредство, ДатаСостояния
-РасчетНалогаНаИмущество [Union] (52): ДоляСтоимостиЧислитель, ...
-  РасчетНалогаНаИмущество [Query] (51): КадастроваяСтоимость, ...
-```
-
-С `-Name <поле>` — детали конкретного поля:
-```
-=== Field: ДатаСостояния "Дата ввода в эксплуатацию" ===
-
-Dataset: СостояниеОС [Query]
-Format: ДФ=dd.MM.yyyy
-```
-
-Показывает: dataset, title, type, role, useRestriction, format, presentationExpression.
-
-## links — связи наборов данных
-
-```
-=== Links (4) ===
-
-РасчетНалогаНаИмущество -> СостояниеОС :
-  Организация -> Организация
-  ОсновноеСредство -> ОсновноеСредство
-```
-
-Группирует по парам наборов. Показывает поля связи и параметры.
-
-## calculated — вычисляемые поля
-
-Без `-Name` — карта: имена и заголовки:
-```
-=== Calculated fields (23) ===
-  ДоляСтоимости  "Доля стоимости"
-  КоэффициентКи  "Коэффициент Ки"
-  ...
-```
-
-С `-Name <поле>` — полное выражение:
-```
-=== Calculated: ДоляСтоимости ===
-
-Expression:
-  ВЫБОР КОГДА ... ТОГДА "1" ИНАЧЕ ... КОНЕЦ
-Title: Доля стоимости
-Restrict: condition
-```
-
-## resources — ресурсы (итоги по группировкам)
-
-Без `-Name` — карта: имена полей, `*` = есть формулы по группировкам:
-```
-=== Resources (51) ===
-  НалоговаяБаза
-  КоэффициентКи *
-  ...
-  * = has group-level formulas
-```
-
-С `-Name <поле>` — формулы агрегации:
-```
-=== Resource: ДатаСостояния ===
-
-  [ОсновноеСредство] ЕстьNull(ДатаСостояния, "")
-```
-
-## params — параметры схемы
-
-```
-=== Parameters (16) ===
-  Name                       Type                   Default          Visible  Expression
-  Период                     StandardPeriod         LastMonth        yes      -
-  НачалоПериода              DateTime               -                hidden   &Период.ДатаНачала
-  Организация                CatalogRef.Организации null             yes      -
-```
-
-## variant — варианты отчёта
-
-Без `-Name` — список вариантов:
-```
-=== Variants (2) ===
-  [1] НоменклатураИЦены  "Номенклатура и цены"  Table(detail)  3 filters
-  [2] НоменклатураБезЦен  "Номенклатура без цен"  Group(detail)  2 filters
-```
-
-С `-Name <N|имя>` — структура конкретного варианта:
-```
-=== Variant [1]: НоменклатураИЦены "Номенклатура и цены" ===
-
-Structure:
-  Table "Таблица"
-  ├── Columns: [ТипЦен Items]
-  │     Selection: Auto, Цена
-  └── Rows: [Номенклатура Items]
-        Selection: Номенклатура, УИД, Auto
-
-Filter:
-  [ ] Номенклатура InHierarchy  [user]
-  [ ] ТипЦен Equal
-  [x] ВАрхиве = false  "Исключая скрытые товары"
-
-DataParams: КлючВарианта="НоменклатураИЦены"
-Output: style=ЧерноБелый  groups=Separately  totalsH=None  totalsV=None
-```
-
-## templates — привязки шаблонов вывода
-
-Три типа привязок: `fieldTemplate` (к полю), `groupTemplate` (к группировке, Header/Footer), `groupHeaderTemplate` (заголовок группы).
-
-Без `-Name` — карта привязок:
-```
-=== Templates (70 defined: 49 field, 37 group) ===
-
-Field bindings (49): (all trivial)
-  ОстаточнаяСтоимостьНа0101, ОстаточнаяСтоимостьНа0102, ...
-
-Group bindings (37):
-  ВидНалоговойБазы
-    Header -> Макет3 (1 rows, 1 params)
-  СреднегодоваяСтоимость2019
-    Footer -> Макет50 (1 rows) spacer
-    GroupHeader -> Макет40 (3 rows)
-```
-
-С `-Name <группировка|поле>` — содержимое шаблонов:
-```
-=== Templates: СреднегодоваяСтоимость2019 ===
-
-Footer -> Макет50 [1 rows, 1 cells]:
-  Row 1: (empty)
-
-GroupHeader -> Макет40 [3 rows, 78 cells]:
-  Row 1: "№ п/п" | "###Группировки1###" | "Инв. номер" | ...
-  Row 2: "01.01" | "01.02" | ... | "31.12"
-  Row 3: "1" | "2" | ... | "26"
-```
-
-Для field-привязок:
-```
-=== Field template: ОстаточнаяСтоимостьНа0101 -> Макет4 ===
-[1 rows, 1 cells]
-  Row 1: {ОстаточнаяСтоимостьНа0101}
-  (all params trivial)
-```
-
-**Тривиальность выражений**: `Поле = Поле` и `Поле = Представление(Поле)` считаются тривиальными и НЕ выводятся. Показываются только нетривиальные — когда выражение содержит другое поле, вызов метода, пустую строку и т.д.
-
-## trace — трассировка поля от заголовка до запроса
-
-Ищет поле по dataPath ИЛИ заголовку (включая подстроку) и показывает полную цепочку происхождения за один вызов:
-
-```
-=== Trace: КоэффициентКи "Коэффициент Ки" ===
-
-Dataset: (schema-level only, not in dataset fields)
-
-Calculated:
-  ВЫБОР КОГДА ... ТОГДА 0 ИНАЧЕ ... КОНЕЦ
-  Operands:
-    КоличествоМесяцевИспользования -> РасчетНалогаНаИмущество [Query]
-    КоличествоМесяцевВладения -> РасчетНалогаНаИмущество [Query]
-
-Resource:
-  [ОсновноеСредство] Сумма(КоэффициентКи)
-```
-
-Типичный сценарий: пользователь видит колонку "Коэффициент Ки" в отчёте и спрашивает как она считается. Один вызов `trace` показывает: формулу вычисления, откуда берутся операнды, как агрегируется в ресурс.
-
-## Что не выводится
-
- XML namespace-декларации
- Обёртки v8:item/v8:lang/v8:content (извлекаем чистый текст)
- userSettingID (GUID-ы пользовательских настроек)
- Дефолтные periodAdditionBegin/End = 0001-01-01
- viewMode
@@ -1,4 +1,4 @@
-# skd-info v1.3 — Analyze 1C DCS structure
+# skd-info v1.6 — Analyze 1C DCS structure
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory=$true)]
@@ -10,7 +10,8 @@ param(
 	[int]$Batch = 0,
 	[int]$Limit = 150,
 	[int]$Offset = 0,
-	[string]$OutFile
+	[string]$OutFile,
+	[switch]$Raw
 )

 $ErrorActionPreference = "Stop"
@@ -655,6 +656,13 @@ function Show-Query {
 	}

 	$rawQuery = Unescape-Xml $queryNode.InnerText
+
+	# Raw mode: emit verbatim query text only (no headers/TOC/batch split) for round-trip
+	if ($Raw) {
+		foreach ($ql in ($rawQuery.Trim() -split "`n")) { $lines.Add($ql.TrimEnd()) }
+		return
+	}
+
 	$dsNameStr = $targetDs.SelectSingleNode("s:name", $ns).InnerText

 	# Split into batches
@@ -824,8 +832,14 @@ function Show-Fields {
 				$roleParts = @()
 				if ($role) {
 					foreach ($child in $role.ChildNodes) {
-						if ($child.NodeType -eq "Element" -and $child.InnerText -eq "true") {
+						if ($child.NodeType -ne "Element") { continue }
+						$txt = $child.InnerText.Trim()
+						if ($txt -eq "true") {
 							$roleParts += $child.LocalName
+						} elseif ($txt -eq "false") {
+							# skip default-false flags
+						} else {
+							$roleParts += "$($child.LocalName)=$txt"
 						}
 					}
 				}
@@ -1869,7 +1883,12 @@ $totalLines = $result.Count
 # OutFile
 if ($OutFile) {
 	$utf8Bom = New-Object System.Text.UTF8Encoding($true)
-	[System.IO.File]::WriteAllLines((Join-Path (Get-Location) $OutFile), $result, $utf8Bom)
+	if ([System.IO.Path]::IsPathRooted($OutFile)) {
+		$outPath = [System.IO.Path]::GetFullPath($OutFile)
+	} else {
+		$outPath = [System.IO.Path]::GetFullPath((Join-Path (Get-Location).Path $OutFile))
+	}
+	[System.IO.File]::WriteAllLines($outPath, $result, $utf8Bom)
 	Write-Host "Written $totalLines lines to $OutFile"
 	exit 0
 }
@@ -1883,7 +1902,7 @@ if ($Offset -gt 0) {
 	$result = $result[$Offset..($totalLines - 1)]
 }

-if ($result.Count -gt $Limit) {
+if (-not $Raw -and $result.Count -gt $Limit) {
 	$shown = $result[0..($Limit - 1)]
 	foreach ($l in $shown) { Write-Host $l }
 	Write-Host ""
@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# skd-info v1.3 — Analyze 1C DCS structure
+# skd-info v1.6 — Analyze 1C DCS structure
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -278,6 +278,7 @@ def main():
    parser.add_argument("-Limit", type=int, default=150)
    parser.add_argument("-Offset", type=int, default=0)
    parser.add_argument("-OutFile", default=None)
+    parser.add_argument("-Raw", action="store_true")
    args = parser.parse_args()

    # --- Resolve path ---
@@ -634,6 +635,13 @@ def main():
            sys.exit(1)

        raw_query = unescape_xml("".join(query_node.itertext()))
+
+        # Raw mode: emit verbatim query text only (no headers/TOC/batch split) for round-trip
+        if args.Raw:
+            for ql in raw_query.strip().split("\n"):
+                lines.append(ql.rstrip())
+            return
+
        ds_name_str = (target_ds.find("s:name", NSMAP).text or "")

        # Split into batches
@@ -777,8 +785,15 @@ def main():
                role_parts = []
                if role is not None:
                    for child in role:
-                        if isinstance(child.tag, str) and (child.text or "").strip() == "true":
+                        if not isinstance(child.tag, str):
+                            continue
+                        txt = (child.text or "").strip()
+                        if txt == "true":
                            role_parts.append(localname(child))
+                        elif txt == "false":
+                            pass
+                        else:
+                            role_parts.append(f"{localname(child)}={txt}")
                info["role"] = ", ".join(role_parts)

                # UseRestriction
@@ -1712,7 +1727,7 @@ def main():
            sys.exit(0)
        result = result[args.Offset:]

-    if len(result) > args.Limit:
+    if not args.Raw and len(result) > args.Limit:
        shown = result[:args.Limit]
        for line in shown:
            print(line)
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/skd-validate/scripts/skd-validate.ps1 -TemplatePath "src/МойОтчёт/Templates/ОсновнаяСхема"
-powershell.exe -NoProfile -File .claude/skills/skd-validate/scripts/skd-validate.ps1 -TemplatePath "Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-validate.ps1" -TemplatePath "src/МойОтчёт/Templates/ОсновнаяСхема"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-validate.ps1" -TemplatePath "Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml"
 ```
@@ -1,4 +1,4 @@
-# skd-validate v1.1 — Validate 1C DCS structure
+# skd-validate v1.2 — Validate 1C DCS structure
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -438,6 +438,17 @@ if ($script:stopped) { & $finalize; exit 1 }
 if ($calcFieldNodes.Count -gt 0) {
 	$cfOk = $true
 	$cfSeen = @{}
+	# Collect totalField dataPaths — an empty calculatedField is legitimate if a
+	# totalField with the same dataPath provides the expression (real-world
+	# pattern in vendor ERP/БП reports for fields visible only in totals).
+	$tfPaths = @{}
+	foreach ($tf in $totalFieldNodes) {
+		$tfDp = $tf.SelectSingleNode("s:dataPath", $ns)
+		if ($tfDp -and $tfDp.InnerText) {
+			$tfPaths[$tfDp.InnerText] = $true
+		}
+	}
+
 	foreach ($cf in $calcFieldNodes) {
 		$dp = $cf.SelectSingleNode("s:dataPath", $ns)
 		$expr = $cf.SelectSingleNode("s:expression", $ns)
@@ -457,8 +468,15 @@ if ($calcFieldNodes.Count -gt 0) {
 		}

 		if (-not $expr -or -not $expr.InnerText.Trim()) {
-			Report-Error "CalculatedField '$path' has empty expression"
-			$cfOk = $false
+			# Empty expression is legitimate in several vendor patterns:
+			#   - totalField with same dataPath provides the calculation
+			#   - groupTemplate uses the field as group name (declarative only)
+			#   - field is referenced only by settingsVariants for grouping
+			# Surface as warning, not error, to avoid false positives on real
+			# ERP/БП reports while still flagging the unusual shape.
+			if (-not $tfPaths.ContainsKey($path)) {
+				Report-Warn "CalculatedField '$path' has empty expression (declarative-only?)"
+			}
 		}

 		# Warn if collides with a dataset field
@@ -542,14 +560,16 @@ if ($templateNodes.Count -gt 0) {
 		}
 		$tName = $nameNode.InnerText
 		if ($tplSeen.ContainsKey($tName)) {
-			Report-Error "Duplicate template name: $tName"
-			$tplOk = $false
+			# Vendor configs (ERP/БП) ship templates with repeating names — the
+			# platform identifies them by position/context, not by <name>. Demote
+			# to warning so the check still surfaces the collision without failing.
+			Report-Warn "Duplicate template name: $tName (allowed by platform but ambiguous)"
 		} else {
 			$tplSeen[$tName] = $true
 		}
 	}
 	if ($tplOk) {
-		Report-OK "$($templateNodes.Count) template(s): names unique"
+		Report-OK "$($templateNodes.Count) template(s) found"
 	}
 }

@@ -581,7 +601,8 @@ if ($script:stopped) { & $finalize; exit 1 }

 $validComparisonTypes = @(
 	"Equal","NotEqual","Greater","GreaterOrEqual","Less","LessOrEqual",
-	"InList","NotInList","InHierarchy","InListByHierarchy",
+	"InList","NotInList","InHierarchy","NotInHierarchy",
+	"InListByHierarchy","NotInListByHierarchy",
 	"Contains","NotContains","BeginsWith","NotBeginsWith",
 	"Filled","NotFilled"
 )
@@ -734,6 +755,176 @@ if ($variantNodes.Count -eq 0) {
 	}
 }

+# --- 16. valueType structural checks ---
+# Catches broken XDTO that XML/structural checks miss (decimal without xs:,
+# missing qualifiers, mismatched qualifier blocks, unknown sign/length tokens).
+
+$validTypeQualifier = @{
+	'xs:decimal'        = 'v8:NumberQualifiers'
+	'xs:string'         = 'v8:StringQualifiers'
+	'xs:dateTime'       = 'v8:DateQualifiers'
+	'xs:boolean'        = ''
+	'v8:StandardPeriod' = ''
+	'v8:UUID'           = ''
+	'v8:Null'           = ''
+	'v8:Type'           = ''
+	'v8:ValueStorage'   = ''
+}
+$validSign       = @('Any', 'Nonnegative', 'Negative')
+$validLength     = @('Variable', 'Fixed')
+$validFractions  = @('Date', 'DateTime', 'Time')
+
+# DCS supports composite types: multiple <v8:Type> blocks may share a single
+# trailing qualifier block (e.g. xs:string + CatalogRef.X + StringQualifiers).
+# So we collect all types and qualifiers per valueType, then check consistency.
+$qualifierProducers = @{
+	'v8:NumberQualifiers' = 'xs:decimal'
+	'v8:StringQualifiers' = 'xs:string'
+	'v8:DateQualifiers'   = 'xs:dateTime'
+}
+
+$valueTypeNodes = $root.SelectNodes("//s:valueType", $ns)
+$vtChecked = 0
+$vtOk = $true
+foreach ($vt in $valueTypeNodes) {
+	$vtChecked++
+	$types = @()       # list of short type strings; '' marks a ref type
+	$qualifiers = @()  # list of @{ name = 'v8:XQualifiers'; node = $child }
+
+	foreach ($child in $vt.ChildNodes) {
+		if ($child.NodeType -ne 'Element') { continue }
+		if ($child.NamespaceURI -ne 'http://v8.1c.ru/8.1/data/core') { continue }
+		$localName = $child.LocalName
+
+		if ($localName -eq 'Type') {
+			$t = "$($child.InnerText)".Trim()
+			if (-not $t) {
+				Report-Error "valueType: <v8:Type> is empty"
+				$vtOk = $false
+				continue
+			}
+			if ($t -match '^([A-Za-z][A-Za-z0-9]*):(.+)$') {
+				$prefix = $Matches[1]
+				$localT = $Matches[2]
+				if ($prefix -eq 'xs' -or $prefix -eq 'v8') {
+					if (-not $validTypeQualifier.ContainsKey($t)) {
+						Report-Error "valueType: unknown type '$t' (allowed: xs:decimal/xs:string/xs:dateTime/xs:boolean/v8:StandardPeriod or <prefix>:*Ref.X)"
+						$vtOk = $false
+					} else {
+						$types += $t
+					}
+				} else {
+					$prefixNs = $child.GetNamespaceOfPrefix($prefix)
+					if ($prefixNs -eq 'http://v8.1c.ru/8.1/data/enterprise/current-config') {
+						if (-not ($localT -match '^[A-Za-z]+(Ref)?\.')) {
+							Report-Error "valueType: ref type '$t' must look like '<prefix>:<Kind>.<Name>' (e.g. d5p1:CatalogRef.X)"
+							$vtOk = $false
+						} else {
+							$types += ''   # ref — no qualifier needed
+						}
+					} elseif ($prefixNs -eq 'http://v8.1c.ru/8.1/data/enterprise') {
+						# System types: AccumulationRecordType etc. — no qualifiers
+						if (-not ($localT -match '^[A-Za-z][A-Za-z0-9]*$')) {
+							Report-Error "valueType: system type '$t' has unexpected local-name shape"
+							$vtOk = $false
+						} else {
+							$types += ''
+						}
+					} else {
+						Report-Error "valueType: type '$t' uses prefix '$prefix' bound to unexpected namespace '$prefixNs'"
+						$vtOk = $false
+					}
+				}
+			} else {
+				Report-Error "valueType: type '$t' has no namespace prefix (expected xs:/v8:/d5p1: — e.g. xs:decimal not decimal)"
+				$vtOk = $false
+			}
+		} elseif ($localName -match 'Qualifiers$') {
+			$qName = "v8:$localName"
+			$qualifiers += @{ name = $qName; node = $child }
+			# Validate qualifier internals
+			if ($qName -eq 'v8:NumberQualifiers') {
+				$digits = $child.SelectSingleNode("v8:Digits", $ns)
+				$frac   = $child.SelectSingleNode("v8:FractionDigits", $ns)
+				$sign   = $child.SelectSingleNode("v8:AllowedSign", $ns)
+				if (-not $digits -or -not ($digits.InnerText -match '^\d+$')) {
+					Report-Error "v8:NumberQualifiers: <v8:Digits> missing or not a non-negative integer"
+					$vtOk = $false
+				}
+				if (-not $frac -or -not ($frac.InnerText -match '^\d+$')) {
+					Report-Error "v8:NumberQualifiers: <v8:FractionDigits> missing or not a non-negative integer"
+					$vtOk = $false
+				}
+				if ($sign -and $sign.InnerText -and $sign.InnerText -notin $validSign) {
+					Report-Error "v8:NumberQualifiers: <v8:AllowedSign>$($sign.InnerText)</v8:AllowedSign> — must be one of: $($validSign -join ', ')"
+					$vtOk = $false
+				}
+			} elseif ($qName -eq 'v8:StringQualifiers') {
+				$len = $child.SelectSingleNode("v8:Length", $ns)
+				$al  = $child.SelectSingleNode("v8:AllowedLength", $ns)
+				if (-not $len -or -not ($len.InnerText -match '^\d+$')) {
+					Report-Error "v8:StringQualifiers: <v8:Length> missing or not a non-negative integer"
+					$vtOk = $false
+				}
+				if ($al -and $al.InnerText -and $al.InnerText -notin $validLength) {
+					Report-Error "v8:StringQualifiers: <v8:AllowedLength>$($al.InnerText)</v8:AllowedLength> — must be one of: $($validLength -join ', ')"
+					$vtOk = $false
+				}
+			} elseif ($qName -eq 'v8:DateQualifiers') {
+				$df = $child.SelectSingleNode("v8:DateFractions", $ns)
+				if ($df -and $df.InnerText -and $df.InnerText -notin $validFractions) {
+					Report-Error "v8:DateQualifiers: <v8:DateFractions>$($df.InnerText)</v8:DateFractions> — must be one of: $($validFractions -join ', ')"
+					$vtOk = $false
+				}
+			}
+		}
+	}
+
+	# Cross-check: every qualifier must have a matching scalar type in this valueType
+	foreach ($q in $qualifiers) {
+		$producer = $qualifierProducers[$q.name]
+		if (-not $producer) { continue }
+		if ($types -notcontains $producer) {
+			Report-Error "valueType: <$($q.name)> has no matching <v8:Type>$producer</v8:Type> in this valueType"
+			$vtOk = $false
+		}
+	}
+}
+if ($vtChecked -gt 0 -and $vtOk) {
+	Report-OK "$vtChecked valueType block(s): structure and qualifiers OK"
+}
+
+if ($script:stopped) { & $finalize; exit 1 }
+
+# --- 17. value content checks ---
+# Catches literal placeholders ("_") and empty strings in DesignTimeValue refs
+# that XDTO would reject at db-load-xml.
+
+$valueNodes = @()
+$valueNodes += @($root.SelectNodes("//s:value[@xsi:type]", $ns))
+$valueNodes += @($root.SelectNodes("//dcscor:value[@xsi:type]", $ns))
+$vChecked = 0
+$vOk = $true
+foreach ($vn in $valueNodes) {
+	if (-not $vn) { continue }
+	$vChecked++
+	$xsiType = $vn.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
+	$text = $vn.InnerText
+	if ($xsiType -eq 'dcscor:DesignTimeValue') {
+		if (-not $text -or $text.Trim() -eq '' -or $text.Trim() -eq '_') {
+			Report-Error "<value xsi:type=`"dcscor:DesignTimeValue`">$text</value> — DesignTimeValue must be a reference path (e.g. Перечисление.X.Y), not '$text'"
+			$vOk = $false
+		} elseif (-not ($text -match '^[A-Za-zА-Яа-яЁё]+\.[A-Za-zА-Яа-яЁё0-9_]+')) {
+			Report-Warn "<value xsi:type=`"dcscor:DesignTimeValue`">$text</value> — doesn't look like a typical ref path"
+		}
+	}
+}
+if ($vChecked -gt 0 -and $vOk) {
+	Report-OK "$vChecked <value> element(s) with xsi:type: content OK"
+}
+
+if ($script:stopped) { & $finalize; exit 1 }
+
 # --- Final output ---

 & $finalize
@@ -1,4 +1,4 @@
-# skd-validate v1.1 — Validate 1C DCS structure (Python port)
+# skd-validate v1.2 — Validate 1C DCS structure (Python port)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 import argparse
 import os
@@ -434,6 +434,15 @@ if stopped:
 if len(calc_field_nodes) > 0:
    cf_ok = True
    cf_seen = {}
+    # Collect totalField dataPaths — an empty calculatedField is legitimate if a
+    # totalField with the same dataPath provides the expression (real-world
+    # pattern in vendor ERP/БП reports for fields visible only in totals).
+    tf_paths = set()
+    for tf in total_field_nodes:
+        tf_dp = find(tf, "s:dataPath")
+        if tf_dp is not None and inner_text(tf_dp):
+            tf_paths.add(inner_text(tf_dp))
+
    for cf in calc_field_nodes:
        dp = find(cf, "s:dataPath")
        expr = find(cf, "s:expression")
@@ -451,8 +460,14 @@ if len(calc_field_nodes) > 0:
            cf_seen[path] = True

        if expr is None or not text_of(expr):
-            report_error(f"CalculatedField '{path}' has empty expression")
-            cf_ok = False
+            # Empty expression is legitimate in several vendor patterns:
+            #   - totalField with same dataPath provides the calculation
+            #   - groupTemplate uses the field as group name (declarative only)
+            #   - field is referenced only by settingsVariants for grouping
+            # Surface as warning, not error, to avoid false positives on real
+            # ERP/БП reports while still flagging the unusual shape.
+            if path not in tf_paths:
+                report_warn(f"CalculatedField '{path}' has empty expression (declarative-only?)")

        # Warn if collides with a dataset field
        if path in all_field_paths:
@@ -526,12 +541,14 @@ if len(template_nodes) > 0:
            continue
        t_name = inner_text(name_node)
        if t_name in tpl_seen:
-            report_error(f"Duplicate template name: {t_name}")
-            tpl_ok = False
+            # Vendor configs (ERP/БП) ship templates with repeating names — the
+            # platform identifies them by position/context, not by <name>. Demote
+            # to warning so the check still surfaces the collision without failing.
+            report_warn(f"Duplicate template name: {t_name} (allowed by platform but ambiguous)")
        else:
            tpl_seen[t_name] = True
    if tpl_ok:
-        report_ok(f"{len(template_nodes)} template(s): names unique")
+        report_ok(f"{len(template_nodes)} template(s) found")

 # ── 13. GroupTemplate checks ─────────────────────────────────

@@ -558,7 +575,8 @@ if stopped:

 valid_comparison_types = (
    "Equal", "NotEqual", "Greater", "GreaterOrEqual", "Less", "LessOrEqual",
-    "InList", "NotInList", "InHierarchy", "InListByHierarchy",
+    "InList", "NotInList", "InHierarchy", "NotInHierarchy",
+    "InListByHierarchy", "NotInListByHierarchy",
    "Contains", "NotContains", "BeginsWith", "NotBeginsWith",
    "Filled", "NotFilled",
 )
@@ -685,6 +703,166 @@ else:
    if v_ok:
        report_ok(f"{len(variant_nodes)} settingsVariant(s) found")

+# ── 16. valueType structural checks ───────────────────────────
+# Catches broken XDTO that XML/structural checks miss (decimal without xs:,
+# missing qualifiers, mismatched qualifier blocks, unknown sign/length tokens).
+
+import re as _re_vt
+
+_VALID_TYPE_QUALIFIER = {
+    'xs:decimal':        'v8:NumberQualifiers',
+    'xs:string':         'v8:StringQualifiers',
+    'xs:dateTime':       'v8:DateQualifiers',
+    'xs:boolean':        '',
+    'v8:StandardPeriod': '',
+    'v8:UUID':           '',
+    'v8:Null':           '',
+    'v8:Type':           '',
+    'v8:ValueStorage':   '',
+}
+_VALID_SIGN      = ('Any', 'Nonnegative', 'Negative')
+_VALID_LENGTH    = ('Variable', 'Fixed')
+_VALID_FRACTIONS = ('Date', 'DateTime', 'Time')
+_V8_NS_URI       = 'http://v8.1c.ru/8.1/data/core'
+_CONFIG_NS_URI   = 'http://v8.1c.ru/8.1/data/enterprise/current-config'
+
+# DCS supports composite types: multiple <v8:Type> blocks may share a single
+# trailing qualifier block (e.g. xs:string + CatalogRef.X + StringQualifiers).
+# So we collect all types and qualifiers per valueType, then check consistency.
+_QUALIFIER_PRODUCERS = {
+    'v8:NumberQualifiers': 'xs:decimal',
+    'v8:StringQualifiers': 'xs:string',
+    'v8:DateQualifiers':   'xs:dateTime',
+}
+
+vt_nodes = find_all(root, "//s:valueType")
+vt_checked = 0
+vt_ok = True
+for vt in vt_nodes:
+    vt_checked += 1
+    types = []        # short type strings; '' marks a ref type
+    qualifiers = []   # list of (qName, node)
+
+    for child in vt:
+        if not isinstance(child.tag, str):
+            continue
+        qn = etree.QName(child.tag)
+        if qn.namespace != _V8_NS_URI:
+            continue
+        local = qn.localname
+
+        if local == 'Type':
+            t = (child.text or '').strip()
+            if not t:
+                report_error("valueType: <v8:Type> is empty")
+                vt_ok = False
+                continue
+            m = _re_vt.match(r'^([A-Za-z][A-Za-z0-9]*):(.+)$', t)
+            if not m:
+                report_error(f"valueType: type '{t}' has no namespace prefix (expected xs:/v8:/d5p1: — e.g. xs:decimal not decimal)")
+                vt_ok = False
+                continue
+            prefix, local_t = m.group(1), m.group(2)
+            if prefix in ('xs', 'v8'):
+                if t not in _VALID_TYPE_QUALIFIER:
+                    report_error(f"valueType: unknown type '{t}' (allowed: xs:decimal/xs:string/xs:dateTime/xs:boolean/v8:StandardPeriod or <prefix>:*Ref.X)")
+                    vt_ok = False
+                else:
+                    types.append(t)
+            else:
+                prefix_ns = child.nsmap.get(prefix)
+                if prefix_ns == _CONFIG_NS_URI:
+                    if not _re_vt.match(r'^[A-Za-z]+(Ref)?\.', local_t):
+                        report_error(f"valueType: ref type '{t}' must look like '<prefix>:<Kind>.<Name>' (e.g. d5p1:CatalogRef.X)")
+                        vt_ok = False
+                    else:
+                        types.append('')   # ref — no qualifier needed
+                elif prefix_ns == 'http://v8.1c.ru/8.1/data/enterprise':
+                    # System types: AccumulationRecordType etc. — no qualifiers
+                    if not _re_vt.match(r'^[A-Za-z][A-Za-z0-9]*$', local_t):
+                        report_error(f"valueType: system type '{t}' has unexpected local-name shape")
+                        vt_ok = False
+                    else:
+                        types.append('')
+                else:
+                    report_error(f"valueType: type '{t}' uses prefix '{prefix}' bound to unexpected namespace '{prefix_ns}'")
+                    vt_ok = False
+
+        elif local.endswith('Qualifiers'):
+            q_name = f"v8:{local}"
+            qualifiers.append((q_name, child))
+            if q_name == 'v8:NumberQualifiers':
+                digits = find(child, "v8:Digits")
+                frac   = find(child, "v8:FractionDigits")
+                sign   = find(child, "v8:AllowedSign")
+                if digits is None or not _re_vt.match(r'^\d+$', text_of(digits)):
+                    report_error("v8:NumberQualifiers: <v8:Digits> missing or not a non-negative integer")
+                    vt_ok = False
+                if frac is None or not _re_vt.match(r'^\d+$', text_of(frac)):
+                    report_error("v8:NumberQualifiers: <v8:FractionDigits> missing or not a non-negative integer")
+                    vt_ok = False
+                if sign is not None and text_of(sign) and text_of(sign) not in _VALID_SIGN:
+                    report_error(f"v8:NumberQualifiers: <v8:AllowedSign>{text_of(sign)}</v8:AllowedSign> — must be one of: {', '.join(_VALID_SIGN)}")
+                    vt_ok = False
+            elif q_name == 'v8:StringQualifiers':
+                length = find(child, "v8:Length")
+                al     = find(child, "v8:AllowedLength")
+                if length is None or not _re_vt.match(r'^\d+$', text_of(length)):
+                    report_error("v8:StringQualifiers: <v8:Length> missing or not a non-negative integer")
+                    vt_ok = False
+                if al is not None and text_of(al) and text_of(al) not in _VALID_LENGTH:
+                    report_error(f"v8:StringQualifiers: <v8:AllowedLength>{text_of(al)}</v8:AllowedLength> — must be one of: {', '.join(_VALID_LENGTH)}")
+                    vt_ok = False
+            elif q_name == 'v8:DateQualifiers':
+                df = find(child, "v8:DateFractions")
+                if df is not None and text_of(df) and text_of(df) not in _VALID_FRACTIONS:
+                    report_error(f"v8:DateQualifiers: <v8:DateFractions>{text_of(df)}</v8:DateFractions> — must be one of: {', '.join(_VALID_FRACTIONS)}")
+                    vt_ok = False
+
+    # Cross-check: every qualifier must have a matching scalar type in this valueType
+    for q_name, _ in qualifiers:
+        producer = _QUALIFIER_PRODUCERS.get(q_name)
+        if not producer:
+            continue
+        if producer not in types:
+            report_error(f"valueType: <{q_name}> has no matching <v8:Type>{producer}</v8:Type> in this valueType")
+            vt_ok = False
+
+if vt_checked > 0 and vt_ok:
+    report_ok(f"{vt_checked} valueType block(s): structure and qualifiers OK")
+
+if stopped:
+    finalize()
+    sys.exit(1)
+
+# ── 17. value content checks ──────────────────────────────────
+# Catches literal placeholders ('_') and empty strings in DesignTimeValue refs
+# that XDTO would reject at db-load-xml.
+
+value_nodes = find_all(root, "//s:value[@xsi:type]") + find_all(root, "//dcscor:value[@xsi:type]")
+v_checked = 0
+v_ok = True
+for vn in value_nodes:
+    if vn is None:
+        continue
+    v_checked += 1
+    xsi_type = vn.get(XSI_TYPE) or ''
+    text = vn.text or ''
+    if xsi_type == 'dcscor:DesignTimeValue':
+        stripped = text.strip()
+        if not stripped or stripped == '_':
+            report_error(f"<value xsi:type=\"dcscor:DesignTimeValue\">{text}</value> — DesignTimeValue must be a reference path (e.g. Перечисление.X.Y), not '{text}'")
+            v_ok = False
+        elif not _re_vt.match(r'^[A-Za-zА-Яа-яЁё]+\.[A-Za-zА-Яа-яЁё0-9_]+', stripped):
+            report_warn(f"<value xsi:type=\"dcscor:DesignTimeValue\">{text}</value> — doesn't look like a typical ref path")
+
+if v_checked > 0 and v_ok:
+    report_ok(f"{v_checked} <value> element(s) with xsi:type: content OK")
+
+if stopped:
+    finalize()
+    sys.exit(1)
+
 # ── Final output ──────────────────────────────────────────────

 finalize()
@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |

 ```powershell
-powershell.exe -NoProfile -File '.claude/skills/subsystem-compile/scripts/subsystem-compile.ps1' -Value '<json>' -OutputDir '<ConfigDir>'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-compile.ps1" -Value '<json>' -OutputDir '<ConfigDir>'
 ```

 ## JSON-определение
@@ -24,7 +24,7 @@ allowed-tools:
 | `NoValidate` | Пропустить авто-валидацию |

 ```powershell
-powershell.exe -NoProfile -File '.claude/skills/subsystem-edit/scripts/subsystem-edit.ps1' -SubsystemPath '<path>' -Operation add-content -Value 'Catalog.Товары'
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-edit.ps1" -SubsystemPath '<path>' -Operation add-content -Value 'Catalog.Товары'
 ```

 ## Операции
@@ -23,7 +23,7 @@ allowed-tools:
 | `OutFile` | Записать результат в файл (UTF-8 BOM) |

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/subsystem-info/scripts/subsystem-info.ps1 -SubsystemPath "<путь>"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-info.ps1" -SubsystemPath "<путь>"
 ```

 ## Пять режимов
@@ -24,6 +24,6 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи"
-powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи.xml"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи.xml"
 ```
@@ -33,7 +33,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/template-add/scripts/add-template.ps1 -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" -TemplateType "<TemplateType>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-SetMainSKD]
 ```

 ## Пример
@@ -41,7 +41,7 @@ powershell.exe -NoProfile -File .claude/skills/template-add/scripts/add-template
 Добавить основную СКД к отчёту в расширении:

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/template-add/scripts/add-template.ps1 -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/add-template.ps1" -ObjectName "ОтчётПродажи" -TemplateName "ОсновнаяСхемаКомпоновкиДанных" -TemplateType "DataCompositionSchema" -SrcDir "src/cfe/МоёРасширение/Reports"
 ```

 ## Маппинг типов
@@ -1,4 +1,4 @@
-# template-add v1.4 — Add template to 1C object
+# template-add v1.5 — Add template to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -20,6 +20,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 # --- Маппинг типов ---

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# add-template v1.4 — Add template to 1C object
+# add-template v1.5 — Add template to 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -31,7 +31,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/template-remove/scripts/remove-template.ps1 -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" [-SrcDir "<SrcDir>"]
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/remove-template.ps1" -ObjectName "<ObjectName>" -TemplateName "<TemplateName>" [-SrcDir "<SrcDir>"]
 ```

 ## Что удаляется
@@ -1,4 +1,4 @@
-# template-remove v1.1 — Remove template from 1C object
+# template-remove v1.2 — Remove template from 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[Parameter(Mandatory)]
@@ -12,6 +12,8 @@ param(
 )

 $ErrorActionPreference = "Stop"
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8

 # --- Проверки ---

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# remove-template v1.0 — Remove template from 1C object
+# remove-template v1.1 — Remove template from 1C object
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

 import argparse
@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/web-info/scripts/web-info.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -55,8 +55,8 @@ Module: C:/Program Files/1cv8/8.3.24.1691/bin/wsap24.dll

 ```powershell
 # Статус по умолчанию
-powershell.exe -NoProfile -File .claude/skills/web-info/scripts/web-info.ps1
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1"

 # Указать путь к Apache
-powershell.exe -NoProfile -File .claude/skills/web-info/scripts/web-info.ps1 -ApachePath "C:\tools\apache24"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-info.ps1" -ApachePath "C:\tools\apache24"
 ```
@@ -41,7 +41,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -88,14 +88,14 @@ powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.p

 ```powershell
 # Файловая база
-powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

 # С явным именем публикации и портом
-powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -AppName "mydb" -Port 9090
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -AppName "mydb" -Port 9090

 # Серверная база
-powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret"

 # Ручной режим (только инструкция)
-powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -Manual
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-publish.ps1" -InfoBasePath "C:\Bases\MyDB" -Manual
 ```
@@ -26,7 +26,7 @@ allowed-tools:
 ## Команда

 ```powershell
-powershell.exe -NoProfile -File .claude/skills/web-stop/scripts/web-stop.ps1 <параметры>
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1" <параметры>
 ```

 ### Параметры скрипта
@@ -45,8 +45,8 @@ powershell.exe -NoProfile -File .claude/skills/web-stop/scripts/web-stop.ps1 <п

 ```powershell
 # Остановить Apache
-powershell.exe -NoProfile -File .claude/skills/web-stop/scripts/web-stop.ps1
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1"

 # С указанием пути
-powershell.exe -NoProfile -File .claude/skills/web-stop/scripts/web-stop.ps1 -ApachePath "C:\tools\apache24"
+powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/web-stop.ps1" -ApachePath "C:\tools\apache24"
 ```
@@ -17,7 +17,7 @@ Automates user interactions with 1C:Enterprise web client via Playwright — nav
 ## Quick start

 ```bash
-RUN=".claude/skills/web-test/scripts/run.mjs"
+RUN="${CLAUDE_SKILL_DIR}/scripts/run.mjs"

 # One-shot: opens browser → runs script → closes browser → exits
 node $RUN run http://localhost:8081/bpdemo test-scenario.js
@@ -35,7 +35,7 @@ SCRIPT
 ## Setup (first time)

 ```bash
-cd .claude/skills/web-test/scripts && npm install
+cd "${CLAUDE_SKILL_DIR}/scripts" && npm install
 ```

 Requires Node.js 18+. `npm install` downloads Playwright and Chromium.
@@ -69,6 +69,12 @@ SCRIPT
 # 2b. Execute without video recording (for debugging/testing)
 cat script.js | node $RUN exec - --no-record

+# 2c. Override exec HTTP timeout (default 30 min). Use for long scripts
+#     such as multi-block recordings + addNarration.
+cat script.js | node $RUN exec - --timeout-min=120
+cat script.js | node $RUN exec - --timeout=7200000
+WEB_TEST_EXEC_TIMEOUT_MS=7200000 node $RUN exec script.js
+
 # 3. Screenshot
 node $RUN shot result.png

@@ -159,7 +165,7 @@ const form = await getFormState();

 ### Reading data

-#### `readTable({ maxRows?, offset?, table? })` → `{ columns, rows, total, shown, offset }`
+#### `readTable({ maxRows?, offset?, table? })` → `{ columns, rows, total, shown, offset, hasMore }`
 Read actual grid data with pagination. Each row is `{ columnName: value }`.

 | Option | Default | Description |
@@ -168,6 +174,12 @@ Read actual grid data with pagination. Each row is `{ columnName: value }`.
 | `offset` | 0 | Skip first N rows |
 | `table` | — | Grid name from `tables[]` (for multi-grid forms) |

+**Picture columns.** Cells that render an icon (status/stage marks, the "ЭДО" mark, the attached-files paperclip) read as `'pic:<N>'` (`N` = icon frame/state) when shown, `''` when absent — so presence is truthy and icons differ by index. Icon-only columns (no header text) still appear, named by their tooltip or `'(picture)'`. These values are read-only — filter/select rows by a text column, not by `'pic:N'`.
+```js
+if (t.rows[0]['Присоединенные файлы']) { /* has an attached file */ }
+t.rows[0]['ЭДО'] === 'pic:1';   // connected to 1С-ЭДО ('pic:0' = not)
+```
+
 Special row fields:
 - `_kind: 'group'` — hierarchical group row
 - `_kind: 'parent'` — parent row in hierarchy
@@ -177,10 +189,22 @@ Special row fields:
 - `hierarchical: true` — list has groups (on result object)
 - `viewMode: 'tree'` — tree view active (on result object)

+**`total` is misleading for long lists.** 1С virtualizes both dynamic lists and form tabular sections — the DOM holds only a window of visible rows. `total` / `shown` count what's *loaded right now*, not the size of the underlying collection. Use **`hasMore`** to know if there's more data outside the window:
+
+```js
+const t = await readTable();
+// t.hasMore = { above: false, below: true }   ← form tabular section, scrollbar visible
+// t.hasMore = { below: true }                 ← dynamic list (catalog/journal/register)
+// t.hasMore = { below: false }                ← everything visible / end of list reached
+```
+
+- `hasMore.below` — always present. `true` ⇒ scrolling down (PageDown / `clickElement` with `scroll:true`) will reveal more rows.
+- `hasMore.above` — usually present too. Detected via the dynamic-list page-turn buttons (#vertButtonScroll) or the tabular-section scrollbar. Absent only for rare grids that have neither widget — treat absence as unknown.
+
 ```js
 const t = await readTable({ maxRows: 50 });
 console.log('Columns:', t.columns);
-console.log('Rows:', t.rows.length, 'of', t.total);
+console.log('Loaded:', t.shown, 'rows; more below:', t.hasMore.below);
 // Pagination:
 const page2 = await readTable({ maxRows: 50, offset: 50 });
 ```
@@ -211,7 +235,9 @@ Sections + all open tabs.

 ### Actions

-#### `clickElement(text, { dblclick?, table?, expand?, modifier? })` → form state
+**Return shape convention.** All action functions return a **flat form state** (same shape as `getFormState()`) with action-specific extras: `clicked`, `focused`, `selected`, `filled`, `notFilled`, `closed`, `opened`, `navigated`, `deleted`, `filtered`, `unfiltered`. Errors always sit at the top level under `.errors` (when present) — the exec-wrapper automatically throws on `.errors.modal` / `.errors.balloon`.
+
+#### `clickElement(text, { dblclick?, table?, expand?, modifier?, scroll? })` → form state
 Click button, hyperlink, tab, navigation panel link, or grid row (fuzzy match).

 - `table` — scope button search to a specific grid's command panel (by name from `tables[]`):
@@ -233,6 +259,11 @@ Click button, hyperlink, tab, navigation panel link, or grid row (fuzzy match).
  await clickElement('ИСУ ФХД');                      // select row
  await clickElement('ИСУ ФХД', { expand: true });    // expand/collapse
  ```
+- **Focus a field** (last resort, when no `table` given): if `text` matches no clickable control but matches a form field's name/label, clicks the input to focus it **without changing its value**. Returns `focused: { field, id, ok }` (`ok: false` if the field couldn't take focus). Use it to drive focus-dependent keys:
+  ```js
+  await clickElement('Контрагент');          // focus the reference field
+  await getPage().keyboard.press('F4');      // open its selection form
+  ```
 - **Multi-select rows** with `modifier: 'ctrl'` (add to selection) or `modifier: 'shift'` (select range):
  ```js
  await clickElement('Номенклатура 1');                          // select first row
@@ -242,26 +273,32 @@ Click button, hyperlink, tab, navigation panel link, or grid row (fuzzy match).
  const t = await readTable();
  t.rows.filter(r => r._selected);  // rows with _selected: true
  ```
- **SpreadsheetDocument cells** (report drill-down): first argument can be `{ row, column }` object to click a cell in a rendered report. Coordinates match `readSpreadsheet()` output:
+- **Cell click by (row, column)** — first argument as `{ row, column }`. Routes: spreadsheet on form → spreadsheet drill-down; otherwise → grid cell. Pass `table: 'GridName'` to force a specific grid when both are present.
+
+  Spreadsheet report drill-down:
  ```js
  const report = await readSpreadsheet();
  // report.data[0] = { 'К1': 'Материалы строительные', 'К6': '150 000', ... }
-
-  // By data row index + column header name
-  await clickElement({ row: 0, column: 'К6' }, { dblclick: true });
-
-  // By cell value filter (fuzzy match)
-  await clickElement({ row: { 'К1': 'Материалы' }, column: 'К6' }, { dblclick: true });
-
-  // Totals row
-  await clickElement({ row: 'totals', column: 'К6' }, { dblclick: true });
+  await clickElement({ row: 0, column: 'К6' }, { dblclick: true });                      // by index
+  await clickElement({ row: { 'К1': 'Материалы' }, column: 'К6' }, { dblclick: true });  // by filter
+  await clickElement({ row: 'totals', column: 'К6' }, { dblclick: true });               // totals row
+  await clickElement('150 000', { dblclick: true });                                     // fallback: by text
  ```
-  Text search also works as fallback — searches inside spreadsheet iframes:
+
+  Form grid cell (catalog list, journal, table part). Off-viewport columns auto-scroll horizontally (works around frozen columns). Use `scroll: true | number` for filter-based rows outside the current DOM window:
  ```js
-  await clickElement('150 000', { dblclick: true }); // finds cell by text in report
+  await clickElement({ row: 0, column: 'Количество' }, { table: 'Товары', dblclick: true });
+  await clickElement({ row: { 'Номенклатура': 'Бумага' }, column: 'Цена' }, { table: 'Товары' });
+  await clickElement({ row: { 'Номер': '0000-000601' }, column: 'Сумма' },
+                     { table: 'Реализации', scroll: true });  // PageDown loop, max 50
  ```

-#### `fillFields({ name: value })` → `{ filled, form }`
+  Gotchas:
+  - `row: <number>` is the index in the **current DOM window**, not absolute — 1С virtualizes long lists. `row: 0` is the topmost loaded row after any prior scroll. For arbitrary rows in a long list use `row: { col: val }` + `scroll: true`.
+  - `scroll: true` walks **down only** (PageDown). For going up first press `Home` via `getPage().keyboard` or narrow with `filterList`.
+  - First matching row wins on duplicate filter matches — refine the filter to disambiguate.
+
+#### `fillFields({ name: value })` → form state with `filled`
 Fill form fields by label (fuzzy match). Auto-detects field type.

 | Value | Field type | Method |
@@ -280,8 +317,7 @@ await fillFields({
 });
 ```

-Returns `{ filled: [{ field, ok, value, method }], form: {...} }`.
-Method is one of: `'clear'` | `'toggle'` | `'radio'` | `'paste'` | `'dropdown'` | `'form'` | `'typeahead'`
+Returns form state with `filled: [{ field, ok: true, value, method }]` (method: `clear`|`toggle`|`radio`|`paste`|`dropdown`|`form`|`typeahead`). **Throws on any per-field failure** with a detailed message listing problematic fields and available options — if the call returned, all fields were filled, no per-item check needed.

 #### `selectValue(field, search, opts?)` → form state with `selected`
 Select a value from reference field via dropdown or selection form. More reliable than `fillFields` for reference fields that need exact selection from a catalog. Pass empty `search` (`''` or `null`) to clear the field (Shift+F4).
@@ -304,14 +340,19 @@ await selectValue('Документ', '0000-000601', { type: 'Реализаци

 Also supports DCS labels — auto-enables the paired checkbox.

-#### `fillTableRow(fields, opts)` → form state
+#### `fillTableRow(fields, opts)` → form state with `filled` (+ optional `notFilled`)
 Fill table row cells via Tab navigation. Value is a plain string, `{ value, type }` for composite-type cells, or `''`/`null` to clear (Shift+F4).

+Returns form state with `filled: [{ field, ok, ...}]`. Items are `{ field, ok: true, method, value }` on success (method: `direct`|`paste`|`dropdown`|`form`|`type-direct`|`skip`|`clear`|`toggle`) or `{ field, ok: false, error, message }` on per-field failure. Unmatched fields → `notFilled: [...]`.
+
+**Unlike `fillFields`, `fillTableRow` does NOT throw on per-field failures** — errors appear as `ok: false` items in `filled[]` so the caller can react selectively (e.g. retry one cell while the rest of the row stays filled). Check via `r.filled.filter(f => !f.ok)`. Error codes: `composite_type`/`type_required`/`type_dialog_failed` (retry with `{value, type}`); `column_not_found` (check column name via `readTable`); `no_selection_form`/`no_selection_after_type` (retry or fall back to `selectValue`); `not_found`/`no_match`/`ambiguous` (refine search text); `still_open` (picked a group — pick a leaf row). Soft validation errors from 1C (`balloon`, `modal`) still throw via the exec-wrapper.
+
 | Option | Description |
 |--------|-------------|
 | `tab` | Switch to tab before filling |
 | `add` | Add new row before filling |
-| `row` | Edit existing row by 0-based index |
+| `row` | Edit existing row: 0-based index, **or** a `{ col: value }` filter (one or more columns) to locate the row by its cell values |
+| `scroll` | With a `row` filter — scan beyond the current DOM window (`true` = up to 50 PageDowns, number = limit) |
 | `table` | Grid name from `tables[]` (for multi-grid forms) |

 ```js
@@ -320,11 +361,14 @@ await fillTableRow(
  { 'Номенклатура': 'Бумага', 'Количество': '10', 'Цена': '100' },
  { tab: 'Товары', add: true }
 );
-// Edit existing row:
+// Edit existing row by index:
 await fillTableRow(
  { 'Количество': '20' },
  { tab: 'Товары', row: 0 }
 );
+// Edit existing row located by cell values (одна или несколько колонок):
+await fillTableRow({ 'Цена': '120' }, { table: 'Товары', row: { 'Номенклатура': 'Бумага' } });
+await fillTableRow({ 'Сумма': '500' }, { row: { 'Номер': '0000-000601', 'Дата': '29.12.2016' }, scroll: true });
 // Multi-grid form — add row to specific table:
 await fillTableRow(
  { 'Объект': 'БДДС' },
@@ -525,7 +569,11 @@ On error (auto-screenshot taken):
 - **Headed mode** — 1C requires visible browser, no headless
 - **Startup time** — 1C loads 30-60s on initial connect (built into `start`)
 - **Fuzzy matching** — all name lookups: exact > startsWith > includes
- **Clipboard paste** — all text fields filled via Ctrl+V (triggers 1C events properly)
+- **Clipboard paste** — all text fields filled via Ctrl+V (triggers 1C events properly). The OS clipboard is automatically saved before each action and restored after, so a local user's clipboard survives a test run. Opt out with `--no-preserve-clipboard` (any command), `WEB_TEST_PRESERVE_CLIPBOARD=0` env, or `preserveClipboard: false` in `webtest.config.mjs`
 - **Cyrillic in bash** — use `cat <<'SCRIPT' | node $RUN exec -` to avoid escaping issues
 - **Non-breaking spaces** — 1C uses `\u00a0` instead of regular spaces. All matching is normalized internally
 - **Section panel display** — `navigateSection()` works with any panel position (side, top) but requires "Picture and text" or "Text" display mode. Icon-only mode is not supported — API cannot read section names from icons alone
+
+## Regression suites
+
+When the user asks to cover a 1C solution with automated regression — multi-file test suites with assertions, hooks, tags, retries, Allure/JUnit reports, multi-user process tests — switch to the `test` mode. See [regress.md](regress.md) for authoring discipline, recon flow (metadata + live walkthrough via `exec`), per-application folder layout, ready-to-paste templates, and failure triage. Default to ad-hoc `run`/`exec` for single-script automation — `test` is the specialised mode for project-wide coverage.
@@ -0,0 +1,424 @@
+# Regression suite authoring
+
+Use this when the user asks to cover a 1C solution with automated regression tests, build out a test suite, or run an existing suite and analyse failures. For ad-hoc single-script automation, stay with the `run`/`exec` modes from SKILL.md instead.
+
+The runner is the same `run.mjs`. The mode is `test`:
+
+```bash
+node $RUN test <dir|file>... [flags]
+```
+
+Positional args are test paths (files and/or dirs, multiple allowed). URL is NOT positional — it comes from `webtest.config.mjs`; override with `--url=<url>`.
+
+Tests live next to the project they cover (not inside the skill). Convention: `tests/` at the project root, with `_hooks.mjs` and `webtest.config.mjs` at the suite root. Tests are ES modules with `*.test.mjs` suffix.
+
+## When to choose `test` over `exec`
+
+| Goal | Mode |
+|------|------|
+| Explore a form, prototype a single step, debug one selector | `exec` (interactive session) |
+| Reproduce a bug as a failing test before fixing it | `test` |
+| Cover a feature so future changes are checked automatically | `test` |
+| Run the project's regression on a new build | `test` |
+| Generate a screencast walkthrough | `exec` with `startRecording` |
+
+Don't write a `.test.mjs` for a one-shot user request. Don't drive a regression suite through chained `exec` calls.
+
+## Before writing tests — recon
+
+Two layers, in order.
+
+**1. Static recon — metadata.** Never invent identifiers. For every metadata object the user mentions, run the matching info skill first: `/meta-info` (attributes/tabular sections), `/form-info` (form layout), `/skd-info` (DCS), `/mxl-info` (templates), `/role-info` (rights), `/subsystem-info` (composition / command interface). If the user names objects you can't find — stop and ask.
+
+**2. Live recon — interactive walkthrough.** For any non-trivial scenario, walk the path live in `exec` mode before transcribing it. Metadata tells you what exists; the live walkthrough tells you what actually happens. Capture from `getFormState()`: exact button names (`'Провести и закрыть'`, not `'Сохранить'`), table section names for multi-grid forms, required fields, places where a real async wait is needed. Then transcribe the working sequence into `*.test.mjs`, wrapping logical chunks in `step('...', async () => { ... })`.
+
+The mechanics of `exec` / `getFormState` / `fillFields` / `clickElement` are in [SKILL.md](SKILL.md) — read it before recon if you haven't already.
+
+When live recon is overkill: trivial reads (`navigateSection` + `readTable` + assert non-empty), or scenarios you've already proven once in this session. When it's essential: confirmation dialogs, posting/cancellation flows, reports with custom filters, multi-grid forms, user-customised forms.
+
+## Suite layout
+
+**Each application gets its own subfolder under `tests/`.** A single repo may host several independent suites side by side — they must not share `_hooks.mjs` or `webtest.config.mjs`, because each suite restores a different DB, publishes to a different URL, and ships its own test data.
+
+```
+tests/
+  <app-name>/                  # application regression — one per solution
+    _hooks.mjs
+    webtest.config.mjs
+    _allure/                   # optional static Allure config
+    01-login/
+    02-counterparties/
+    ...
+  <another-app>/               # second solution, fully isolated
+```
+
+Inside the application subfolder, organize by **feature**, not by metadata kind. Numeric prefixes on both folder and file enforce run order — discovery walks recursively and sorts files by full relative path; entries starting with `_` or `.` are skipped (so `_hooks.mjs`, `_allure/` won't be picked up as tests).
+
+```
+tests/<app-name>/
+  01-login/
+    01-open-base.test.mjs
+    02-section-navigation.test.mjs
+  02-counterparties/
+    01-create.test.mjs
+    02-edit-phone.test.mjs
+  03-goods-receipt/
+    01-fill.test.mjs
+    02-post.test.mjs
+  05-approval-process/
+    01-end-to-end.test.mjs     # multi-user
+```
+
+Per-folder `_hooks.mjs` / `webtest.config.mjs` inside the application subfolder are NOT supported — only the application-root copies are loaded.
+
+## Test file anatomy
+
+```js
+export const name = 'Создание контрагента';       // required
+export const tags = ['catalog', 'create'];        // optional, used for filtering + Allure
+export const timeout = 60000;                     // optional, default 30000
+// export const skip = 'pending fix #123';        // optional: true | string
+// export const only = true;                      // debug-only — never commit
+// export const context = 'manager';              // optional, single non-default context
+// export const contexts = ['clerk', 'manager'];  // optional, multi-user test
+// export const severity = 'critical';            // optional, overrides config severity
+
+export async function setup(ctx) {
+  // per-test prep — runs before default. Skip if not needed.
+}
+
+export async function teardown(ctx) {
+  // per-test cleanup — runs after default, always (even on failure).
+}
+
+export default async function(ctx) {
+  const { navigateSection, openCommand, clickElement, fillFields,
+          readTable, closeForm, getFormState,
+          assert, step, log } = ctx;
+
+  await step('Открыть список контрагентов', async () => {
+    await navigateSection('Продажи');
+    await openCommand('Контрагенты');
+  });
+
+  await step('Создать нового контрагента', async () => {
+    await clickElement('Создать');
+    await fillFields({ 'Наименование': 'Тест ' + Date.now() });
+    await clickElement('Записать и закрыть');
+  });
+
+  await step('Убедиться, что элемент появился в списке', async () => {
+    const t = await readTable();
+    assert.tableHasRow(t, r => r['Наименование']?.startsWith('Тест '));
+  });
+}
+```
+
+**Step names — in Russian, descriptive.** Step labels surface in the console output, in JSON/JUnit, and as Allure step nodes. Russian-speaking QA reads them. Use a full action phrase (`'Создать нового контрагента'`), not a tag (`'create'`) and not a transliteration. Same applies to `export const name` and `displayName` in `webtest.config.mjs`.
+
+## `ctx` contract
+
+The runner injects every `browser.mjs` export into `ctx` (all 1C action functions auto-detect platform errors — see SKILL.md), plus the test utilities below.
+
+### Test utilities
+
+```js
+step(name, fn)             // async wrapper. Records start/stop. Nested calls supported.
+                           // On throw: marks the step failed, re-throws.
+                           // On screenshot='every-step': captures after fn().
+log(...args)               // adds a line to ctx.testInfo's output (goes into JSON / Allure
+                           // attachment). Use instead of console.log inside tests.
+assert.*                   // see "Assertions" below
+```
+
+### `ctx.testInfo` (always set, read-only)
+
+```js
+{
+  name,             // 'Навигация по разделам' (with params substituted)
+  file,             // '01-navigation.test.mjs' (basename)
+  filePath,         // relative path inside testDir
+  tags,             // ['nav', 'smoke']
+  timeout,          // ms
+  attempt,          // 1..maxAttempts (1-based)
+  maxAttempts,      // 1 + retry
+  param,            // { ... } | undefined (only when export const params is set)
+  contexts: {       // mirrors config.contexts; includes custom fields like displayName
+    clerk:   { url, isolation, displayName, ... },
+    manager: { ... },
+  },
+  primaryContext,   // 'clerk' — name of the context active at test entry
+                    // (= t.context for single, t.contexts[0] for multi)
+}
+```
+
+### `ctx.testResult` (only in `afterEach`)
+
+```js
+{
+  status,      // 'passed' | 'failed'
+  duration,    // ms
+  attempts,    // attempts actually executed
+  error,       // { message, step?, screenshot? } | null
+  steps,       // array of step results (each: { name, start, stop, status, error?, steps[] })
+}
+```
+
+### Context shape
+
+- **Single-context (default or `export const context = 'manager'`):** all API on `ctx` top-level — `ctx.clickElement(...)`, `ctx.getFormState()`, etc.
+- **Multi-context (`export const contexts = ['clerk', 'manager']`):** each name is its own scoped namespace — `ctx.clerk.clickElement(...)`, `ctx.manager.fillFields(...)`. `step`, `assert`, `log`, `testInfo` stay top-level. Scoped methods auto-switch the active page before each call.
+
+## Assertions
+
+All on `ctx.assert`. Throw `AssertionError` with `.message`, `.actual`, `.expected`. No dependencies.
+
+```js
+// generic
+assert.ok(value, msg?)                    // truthy
+assert.equal(actual, expected, msg?)      // ===
+assert.notEqual(actual, expected, msg?)   // !==
+assert.deepEqual(actual, expected, msg?)  // JSON-compare
+assert.includes(haystack, needle, msg?)   // string.includes / array.includes
+assert.match(string, regex, msg?)         // regex.test(string)
+await assert.throws(asyncFn, msg?)        // passes if fn throws (use await)
+
+// 1C-specific — operate on getFormState() / readTable() output
+assert.formHasField(state, 'Контрагент', msg?)        // state.fields[name] exists
+assert.formTitle(state, expected, msg?)               // state.title includes expected
+assert.tableHasRow(table, predicate, msg?)            // predicate: object (partial match) or fn(row) => bool
+                                                      //   object form: { 'Наименование': 'Тест' }
+                                                      //   fn form:     r => r['Сумма'] > 100
+assert.tableRowCount(table, expected, msg?)           // table.rows.length === expected
+assert.noErrors(state, msg?)                          // !state.errors
+```
+
+Beyond these, just use plain JS (`throw new Error(...)`) — there's no custom matcher extension API. The 1C-specific helpers are the ones worth preferring over hand-rolled equivalents because their error messages name the actual fields/rows present, which speeds up triage.
+
+## webtest.config.mjs
+
+```js
+export default {
+  // Single-context shorthand:
+  url: 'http://localhost:9191/myapp/ru_RU',
+
+  // OR multi-context:
+  // contexts: {
+  //   clerk:   { url: 'http://localhost:9191/myapp-clerk/ru_RU',   displayName: 'Кладовщик' },
+  //   manager: { url: 'http://localhost:9191/myapp-manager/ru_RU', displayName: 'Менеджер' },
+  // },
+  // defaultContext: 'clerk',
+
+  timeout: 30000,
+  retries: 0,
+  screenshot: 'on-failure',  // 'every-step' | 'off'
+  record: false,
+
+  // Severity → tags mapping for Allure. Each tag at most one bucket.
+  severity: {
+    critical: ['smoke', 'crud'],
+    minor:    ['recording'],
+  },
+  defaultSeverity: 'normal',
+};
+```
+
+CLI flags override config. Use latin context IDs + Russian `displayName` for ergonomics — `ctx.testInfo.contexts.clerk.displayName` is friendlier than mixed-case Cyrillic keys.
+
+## _hooks.mjs
+
+Two layers. Infra hooks run without a browser; testlevel hooks receive `ctx`.
+
+```js
+import { execSync } from 'child_process';
+
+// Infra — runs once around the whole suite.
+export async function prepare({ hookArgs, log, config }) {
+  // hookArgs: everything after `--` on the CLI, as a string[]. Parse yourself.
+  const force = hookArgs.includes('--rebuild-stand');
+  const dataArg = hookArgs.find(a => a.startsWith('--data='))?.slice('--data='.length);
+  log('preparing stand, force=', force, 'data=', dataArg);
+  // Idempotent hash-locks on inputs (config sources, EPF spec, DB dump) keep
+  // warm starts to a liveness probe.
+}
+
+export async function cleanup({ log, config }) { /* optional */ }
+
+// Testlevel — runs with browser ctx.
+export async function beforeAll(ctx) { /* once after first context opens */ }
+export async function afterAll(ctx)  { /* once before final teardown */ }
+export async function beforeEach(ctx) { /* ctx.testInfo is set */ }
+export async function afterEach(ctx)  { /* ctx.testInfo + ctx.testResult set */ }
+
+// Per-context — runs whenever a context is created/closed.
+export async function afterOpenContext(ctx, name, spec)   { /* spec = config.contexts[name] */ }
+export async function beforeCloseContext(ctx, name, spec) { }
+```
+
+Built-in state reset (`dismissPendingErrors` + close all forms) runs after `afterEach` automatically. Don't reimplement it in `afterEach`.
+
+Pass hook args after `--`:
+
+```bash
+node $RUN test tests/<app-name>/ --bail -- --rebuild-stand --data=demo
+                                 └─runner─┘ └────── hookArgs ─────────┘
+```
+
+**Where to put data setup:**
+- DB restore, publication, EPF build → `prepare()`. Make it idempotent (hash-locks).
+- Test-specific seed data → per-test `setup`.
+- Shared session-wide warmup → `beforeAll`.
+
+## Ready-to-paste patterns
+
+A minimal CRUD shape is in *Test file anatomy* above — use it as the rhythm for catalog/document tests, swapping in the right section/command/fields. The patterns below cover what's specific to the regression engine, not the browser API (those live in SKILL.md).
+
+### DCS report
+
+```js
+await openCommand('Остатки товаров');
+// Reset user settings — 1C persists them between sessions.
+await clickElement('Ещё');
+await clickElement('Установить стандартные настройки');
+
+await selectValue('Номенклатура', 'Товар 02');   // auto-enables the filter checkbox
+await clickElement('Сформировать');
+await wait(3);
+const r = await readSpreadsheet();
+assert.deepEqual(r.headers, ['Номенклатура', 'Количество', 'Сумма']);
+assert.ok(r.data.length >= 1);
+assert.ok(r.totals?.['Сумма']);
+```
+
+### Multi-user process
+
+```js
+export const contexts = ['clerk', 'manager'];
+
+export default async function({ clerk, manager, step, assert }) {
+  await step('Кладовщик создаёт накладную', async () => {
+    await clerk.navigateSection('Склад');
+    await clerk.openCommand('Приходные накладные');
+    await clerk.clickElement('Создать');
+    await clerk.fillFields({ 'Контрагент': 'ООО Север' });
+    await clerk.clickElement('Записать');
+  });
+  await step('Менеджер утверждает накладную', async () => {
+    await manager.navigateSection('Согласование');
+    await manager.openCommand('На утверждении');
+    await manager.clickElement('ООО Север', { dblclick: true });
+    await manager.clickElement('Утвердить');
+  });
+  await step('Кладовщик видит новый статус', async () => {
+    const s = await clerk.getFormState();
+    assert.equal(s.fields['Статус']?.value, 'Утверждён');
+  });
+  await step('Освободить сессию кладовщика', async () => {
+    await manager.closeContext('clerk');   // free a 1C license for the next test
+  });
+}
+```
+
+Close contexts you no longer need (`manager.closeContext('clerk')`) before the next multi-user test starts — frees a 1C web-client license and stops the previous role from holding state.
+
+### Failing-test repro
+
+```js
+export const name = 'Bug #123: накладная без контрагента не должна проводиться';
+export const tags = ['bug', 'validation'];
+
+export default async function({ openCommand, clickElement, getFormState, assert, step }) {
+  await openCommand('Приходные накладные');
+  await clickElement('Создать');
+  await clickElement('Провести');
+  const s = await getFormState();
+  assert.ok(s.errorModal || s.fields['Контрагент']?.required,
+    'Должна быть ошибка валидации или поле помечено обязательным');
+}
+```
+
+Write it red first, hand it to the user, fix the underlying issue, re-run green.
+
+### Parameterised test
+
+```js
+export const name = 'Заполнение поля {type}';
+export const params = [
+  { type: 'String', field: 'Наименование', value: 'Тест' },
+  { type: 'Number', field: 'Цена', value: '100.50' },
+  { type: 'Date',   field: 'ДатаПоступления', value: '01.01.2024' },
+];
+
+export default async function({ fillFields, getFormState, assert }, { type, field, value }) {
+  await fillFields({ [field]: value });
+  const state = await getFormState();
+  assert.equal(state.fields[field]?.value, String(value));
+}
+```
+
+Each `params` entry becomes its own test in the report. `{key}` placeholders in `name` get substituted; without placeholders, a `[index]` suffix is added. `ctx.testInfo.param` carries the current row.
+
+## Running
+
+```bash
+node $RUN test tests/<app-name>/                                       # full app suite
+node $RUN test tests/<app-name>/03-goods-receipt/                      # one feature folder
+node $RUN test tests/<app-name>/02-counterparties/01-create.test.mjs   # one file
+node $RUN test tests/<app-name>/02-x.test.mjs tests/<app-name>/05-y.test.mjs  # several files
+node $RUN test tests/<app-name>/ --tags=smoke                          # by tag (intersection)
+node $RUN test tests/<app-name>/ --grep='накладн'                      # by name regex
+node $RUN test tests/<app-name>/ --bail --retry=1                      # stop on first fail, allow 1 retry
+node $RUN test tests/<app-name>/ --report=allure-results --format=allure --report-dir=allure-results
+node $RUN test tests/<app-name>/ --report=-                            # machine JSON to stdout, progress to stderr
+node $RUN test tests/<app-name>/ -- --rebuild-stand                    # after `--` → hookArgs
+```
+
+**Output contract.** `test` behaves like a test runner: by default the human report (with the summary as the last line) goes to **stdout** — read the tail of stdout + exit code. The machine report is opt-in via `--report`: `--report=path` writes it to a file (default JSON; XML for `--format=junit`), `--report=-` writes it to stdout while progress moves to stderr. Allure needs `--format=allure` + a directory (`-` is invalid for allure). For detailed triage use `--report=path` or `--report=-`. **In `--report=-` mode never use `2>&1`** — it merges stderr progress into the stdout JSON. (In the default mode there is no JSON in stdout, so `… | tail` is safe.)
+
+### Allure static config — `_allure/`
+
+The runner copies `<testDir>/_allure/` into the report directory before generating Allure output. Drop in `categories.json` (regex-based failure classification — useful for 1C-specific buckets: license pool exhaustion, platform exceptions, runner timeouts, assertion failures), `environment.properties` (optional, often emitted dynamically by `prepare()`), `executor.json` (CI metadata, skip locally). The underscore prefix keeps the directory out of test discovery.
+
+## Severity guidance
+
+When the user doesn't dictate, default to:
+
+| Test kind | Severity |
+|-----------|----------|
+| Login + section navigation, basic CRUD on covered entities | `critical` (also tag `smoke`) |
+| Documents posting, report generation, end-to-end processes | `critical` |
+| Field-level edge cases, formatting, optional flows | `normal` |
+| Cosmetic / recording / non-functional | `minor` |
+| Reserved for show-stopper protections | `blocker` (use sparingly) |
+
+Don't promote everything to `critical` — it loses signal in the Allure dashboard.
+
+## Anti-patterns
+
+- **Sleeps as a substitute for assertions.** `wait(5)` after `openCommand` is fine; `wait(30)` because something flakes is a bug — wait on `getFormState` instead.
+- **Retry as a substitute for understanding.** "Not found" twice means the data isn't there or the label is wrong. Don't loop.
+- **Position-based row identification** (`rows[0]`) when the DB has shared seed data. Filter by a unique marker (`Date.now()` suffix) instead.
+- **Hand-writing reset code in `afterEach`.** The runner already closes forms and dismisses errors after the hook.
+- **Cross-test state assumptions.** Each test must start from the desktop and seed its own data. Order-of-execution coupling is a regression-suite trap.
+- **`tags: ['smoke']` on a 90-second test.** Smoke means fast.
+- **Skipping recon** because "I know what this catalog looks like." The project's customisation almost certainly differs from stock.
+
+(General browser-API anti-patterns — raw DOM, `clickElement('Закрыть')` instead of `closeForm()` — live in SKILL.md.)
+
+## After a run — failure triage
+
+1. Scan the JSON or Allure summary for `failed`.
+2. For each failure, read `error.message` + `error.step` + screenshot.
+3. If `error.onecError.stack` is present — it's a 1C exception, look at the platform trace.
+4. Classify:
+   - **Test bug** — selector wrong, expectation wrong, race with no anchor → fix the test.
+   - **Application bug** — actual misbehaviour reproduced → report to the user with the failing step name and the platform stack.
+   - **Stand flake** — Apache timeout, login form not loading, license shortage → fix the hook idempotency or session-cleanup logic, not the test.
+5. After fixes, re-run only the affected files before the full suite.
+
+Report back to the user with the classification, not raw failure dumps.
+
+## Reference
+
+- Browser API: [SKILL.md](SKILL.md)
+- Video and narration: [recording.md](recording.md)
--- a/Show More
+++ b/Show More