Auto-build: copilot (python) from 7fa279c

2026-07-14 06:45:17 +03:00 · 2026-05-17 11:22:33 +00:00
commit bbd2f7a8c1
207 changed files with 98901 additions and 0 deletions
@@ -0,0 +1,75 @@
+---
+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>]
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+---
+
+# /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 строк) |
+| `OutFile` | Записать результат в файл (UTF-8 BOM) |
+
+```powershell
+python ".github/skills/skd-info/scripts/skd-info.py" -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` | — | Текст запроса набора (с оглавлением батчей) |
+| `fields` | Карта: имена полей по наборам | Деталь поля: набор, тип, роль, формат |
+| `links` | Все связи наборов | — |
+| `calculated` | Карта: имена вычисляемых полей | Выражение + заголовок + ограничения |
+| `resources` | Карта: имена ресурсов (`*` = групповые формулы) | Формулы агрегации по группировкам |
+| `params` | Таблица параметров: тип, значение, видимость | — |
+| `variant` | Список вариантов | Структура группировок + фильтры + вывод |
+| `templates` | Карта привязок шаблонов (field/group) | Содержимое шаблона: строки, ячейки, выражения |
+| `trace` | — | Полная цепочка: набор → вычисление → ресурс |
+| `full` | Полная сводка: overview + query + fields + resources + params + variant | — |
+
+Паттерн: без `-Name` — карта/индекс, с `-Name` — деталь конкретного элемента. Режим `full` объединяет 6 ключевых режимов в один вызов.
+
+## Типичный workflow
+
+1. `overview` — понять структуру, увидеть подсказки
+2. `trace -Name <поле>` — узнать как считается колонка отчёта (от заголовка до запроса за один вызов)
+3. `query -Name <набор>` — посмотреть текст SQL-запроса
+4. `variant -Name <N>` — посмотреть группировки и фильтры варианта
+
+Подробные примеры вывода каждого режима — в `modes-reference.md`.
+
+## Верификация
+
+```
+/skd-info <path>                            — overview (точка входа)
+/skd-info <path> -Mode trace -Name <field>  — трассировка поля
+```
@@ -0,0 +1,246 @@
+# /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