关于 skd-info
skd-info 是用于分析 1C 数据编排方案 Template.xml 的技能,面向需要检查报表结构和查询的开发者。它提供索引式概览、元素详情以及从字段到计算和资源的追踪。
主要功能
- 01概览方案结构并提供导航提示
- 02查看查询、字段、关联和参数
- 03检查计算字段、资源及变体
- 04查看模板绑定与内容
- 05追踪字段到查询和资源的计算链
- 06将查询原文导出到文件
适用场景
- 01快速了解大型 Template.xml 的结构
- 02追踪报表列的计算来源
- 03提取并修改查询文本
- 04检查变体的分组、筛选和输出
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nikolay-shirokov/ cc-1c-skills --skill skd-info安装后在 Claude Code 中输入/skd-info确认已加载。
附带文件scripts/skd-info.ps1scripts/skd-info.py
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
/skd-info — Анализ схемы компоновки данных
Читает Template.xml схемы компоновки данных (СКД) и выводит компактную сводку. Заменяет необходимость читать тысячи строк XML.
Параметры и команда
| Параметр | Описание |
|---|---|
TemplatePath | Путь к Template.xml или каталогу макета (авто-резолв в Ext/Template.xml) |
Mode | Режим анализа (по умолчанию overview) |
Name | Имя набора (query), поля (fields/calculated/resources/trace), варианта (variant) или группировки/поля (templates) |
Batch | Номер пакета запроса, 0 = все (только query) |
Raw | (только query) сырой текст запроса целиком, без заголовков/оглавления/разделителей пакетов. Для выгрузки в .sql и возврата через skd-edit set-query @file |
Limit / Offset | Пагинация (по умолчанию 150 строк; -Raw не усекается) |
OutFile | Записать результат в файл (UTF-8 BOM) |
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-info.ps1" -TemplatePath "<путь>"
С указанием режима:
... -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 СуммаНалога
... -Mode trace -Name "Коэффициент Ки"
... -Mode variant -Name 1
... -Mode templates
... -Mode templates -Name ВидНалоговойБазы
Режимы
| Режим | Без -Name | С -Name |
|---|---|---|
overview | Навигационная карта схемы + подсказки Next | — |
query | — | Текст запроса набора (с оглавлением батчей); -Raw — чистая выгрузка для правки |
fields | Карта: имена полей по наборам | Деталь поля: набор, тип, роль, формат |
links | Все связи наборов | — |
calculated | Карта: имена вычисляемых полей | Выражение + заголовок + ограничения |
resources | Карта: имена ресурсов (* = групповые формулы) | Формулы агрегации по группировкам |
params | Таблица параметров: тип, значение, видимость | — |
variant | Список вариантов | Структура группировок + фильтры + вывод |
templates | Карта привязок шаблонов (field/group) | Содержимое шаблона: строки, ячейки, выражения |
trace | — | Полная цепочка: набор → вычисление → ресурс |
full | Полная сводка: overview + query + fields + resources + params + variant | — |
Паттерн: без -Name — карта/индекс, с -Name — деталь конкретного элемента. Режим full объединяет 6 ключевых режимов в один вызов.
Типичный workflow
overview— понять структуру, увидеть подсказкиtrace -Name <поле>— узнать как считается колонка отчёта (от заголовка до запроса за один вызов)query -Name <набор>— посмотреть текст SQL-запросаvariant -Name <N>— посмотреть группировки и фильтры варианта
Переработка запроса (round-trip): query -Name <набор> -Raw -OutFile q.sql →
правка q.sql → /skd-edit <tpl> -Operation set-query -Value "@q.sql". Флаг
-Raw отдаёт запрос целиком без декораций, поэтому выгрузка ↔ возврат
точны (включая многопакетные запросы с временными таблицами).
Верификация
/skd-info <path> — overview (точка входа)
/skd-info <path> -Mode trace -Name <field> — трассировка поля