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
プロジェクトの README よりこの README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。
/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> — трассировка поля