1c-skd-info · diff
git:20260827.7eca834 to git:20260828.2b87e3e
16 added, 16 removed. Audit A to A.
---
name: 1c-skd-info
- description: Анализ структуры схемы компоновки данных 1С (СКД) — наборы, поля, параметры, варианты. Используй для понимания отчёта — источник данных (запрос), доступные поля, параметры
+ description: Анализ структуры схемы компоновки данных 1С (СКД) - наборы, поля, параметры, варианты. Используй для понимания отчета - источник данных (запрос), доступные поля, параметры
argument-hint: <TemplatePath> [-Mode overview|query|fields|links|calculated|resources|params|variant|templates|trace|full] [-Name <dataset|variant|field|group>]
allowed-tools:
- Bash
- Read
- Glob
---
- # /skd-info — Анализ схемы компоновки данных
+ # /skd-info - Анализ схемы компоновки данных
Читает Template.xml схемы компоновки данных (СКД) и выводит компактную сводку. Заменяет необходимость читать тысячи строк XML.
## Параметры и команда
| Параметр | Описание |
|----------|----------|
| `TemplatePath` | Путь к Template.xml или каталогу макета (авто-резолв в `Ext/Template.xml`) |
| `Mode` | Режим анализа (по умолчанию `overview`) |
| `Name` | Имя набора (query), поля (fields/calculated/resources/trace), варианта (variant) или группировки/поля (templates) |
| `Batch` | Номер пакета запроса, 0 = все (только query) |
| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк) |
| `Raw` | Текст запроса без заголовков и разбивки на пакеты (только query) |
| `OutFile` | Записать результат в файл (UTF-8 BOM) |
```powershell
powershell.exe -NoProfile -File skills/1c-skd-info/scripts/skd-info.ps1 -TemplatePath "<путь>"
```
С указанием режима:
```powershell
... -Mode query -Name НоменклатураСЦенами
... -Mode query -Name ДанныеТ13 -Batch 3
... -Mode fields -Name КадастроваяСтоимость
... -Mode calculated -Name КоэффициентКи
... -Mode resources -Name СуммаНалога
... -Mode trace -Name "Коэффициент Ки"
... -Mode variant -Name 1
... -Mode templates
... -Mode templates -Name ВидНалоговойБазы
```
## Режимы
| Режим | Без `-Name` | С `-Name` |
|-------|-------------|-----------|
- | `overview` | Навигационная карта схемы + подсказки Next | — |
- | `query` | — | Текст запроса набора (с оглавлением батчей) |
+ | `overview` | Навигационная карта схемы + подсказки Next | - |
+ | `query` | - | Текст запроса набора (с оглавлением батчей) |
| `fields` | Карта: имена полей по наборам | Деталь поля: набор, тип, роль, формат |
- | `links` | Все связи наборов | — |
+ | `links` | Все связи наборов | - |
| `calculated` | Карта: имена вычисляемых полей | Выражение + заголовок + ограничения |
| `resources` | Карта: имена ресурсов (`*` = групповые формулы) | Формулы агрегации по группировкам |
- | `params` | Таблица параметров: тип, значение, видимость | — |
+ | `params` | Таблица параметров: тип, значение, видимость | - |
| `variant` | Список вариантов | Структура группировок + фильтры + вывод |
| `templates` | Карта привязок шаблонов (field/group) | Содержимое шаблона: строки, ячейки, выражения |
- | `trace` | — | Полная цепочка: набор → вычисление → ресурс |
- | `full` | Полная сводка: overview + query + fields + resources + params + variant | — |
+ | `trace` | - | Полная цепочка: набор → вычисление → ресурс |
+ | `full` | Полная сводка: overview + query + fields + resources + params + variant | - |
- Паттерн: без `-Name` — карта/индекс, с `-Name` — деталь конкретного элемента. Режим `full` объединяет 6 ключевых режимов в один вызов.
+ Паттерн: без `-Name` - карта/индекс, с `-Name` - деталь конкретного элемента. Режим `full` объединяет 6 ключевых режимов в один вызов.
## Типичный workflow
- 1. `overview` — понять структуру, увидеть подсказки
- 2. `trace -Name <поле>` — узнать как считается колонка отчёта (от заголовка до запроса за один вызов)
- 3. `query -Name <набор>` — посмотреть текст SQL-запроса
- 4. `variant -Name <N>` — посмотреть группировки и фильтры варианта
+ 1. `overview` - понять структуру, увидеть подсказки
+ 2. `trace -Name <поле>` - узнать как считается колонка отчета (от заголовка до запроса за один вызов)
+ 3. `query -Name <набор>` - посмотреть текст SQL-запроса
+ 4. `variant -Name <N>` - посмотреть группировки и фильтры варианта
- Подробные примеры вывода каждого режима — в `modes-reference.md`.
+ Подробные примеры вывода каждого режима - в `modes-reference.md`.
## Верификация
```
- /skd-info <path> — overview (точка входа)
- /skd-info <path> -Mode trace -Name <field> — трассировка поля
+ /skd-info <path> - overview (точка входа)
+ /skd-info <path> -Mode trace -Name <field> - трассировка поля
```