skd-compile

Name: skd-compile
Author: Arman-Kudaibergenov

150stars20forks

How to install skd-compile?

arman-kudaibergenov/1c-ai-development-kit/skd-compile

$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill skd-compile

Installs into the current project.

Summary

Этот скилл MUST быть вызван когда нужно создать схему компоновки данных 1С (СКД) с нуля из JSON-определения. SHOULD также вызывать при создании новых отчётов со сложной структурой данных. Do NOT использовать для модификации существующей СКД — используй skd-edit; для анализа СКД —

Files · 1

View on GitHub

SKILL.md

1	# /skd-compile — генерация СКД из JSON DSL
2
3	Принимает JSON-определение схемы компоновки данных → генерирует Template.xml (DataCompositionSchema).
4
5	## Параметры и команда
6
7	\| Параметр \| Описание \|
8	\|----------\|----------\|
9	\| `DefinitionFile` \| Путь к JSON-файлу с определением СКД (взаимоисключающий с Value) \|
10	\| `Value` \| JSON-строка с определением СКД (взаимоисключающий с DefinitionFile) \|
11	\| `OutputPath` \| Путь к выходному Template.xml \|
12
13	```powershell
14	# Из файла
15	powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -DefinitionFile "<json>" -OutputPath "<Template.xml>"
16
17	# Из строки (без промежуточного файла)
18	powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -Value '<json-string>' -OutputPath "<Template.xml>"
19	```
20
21	## JSON DSL — краткий справочник
22
23	Полная спецификация: `docs/skd-dsl-spec.md`.
24
25	### Корневая структура
26
27	```json
28	{
29	"dataSets": [...],
30	"calculatedFields": [...],
31	"totalFields": [...],
32	"parameters": [...],
33	"dataSetLinks": [...],
34	"settingsVariants": [...]
35	}
36	```
37
38	Умолчания: `dataSources` → авто `ИсточникДанных1/Local`; `settingsVariants` → авто "Основной" с деталями.
39
40	### Наборы данных
41
42	Тип по ключу: `query` → DataSetQuery, `objectName` → DataSetObject, `items` → DataSetUnion.
43
44	```json
45	{ "name": "Продажи", "query": "ВЫБРАТЬ ...", "fields": [...] }
46	```
47
48	### Поля — shorthand
49
50	```
51	"Наименование" — просто имя
52	"Количество: decimal(15,2)" — имя + тип
53	"Организация: CatalogRef.Организации @dimension" — + роль
54	"Служебное: string #noFilter #noOrder" — + ограничения
55	```
56
57	Типы: `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 со ссылочными типами требует базу с соответствующей конфигурацией.
58
59	Синонимы типов (русские и альтернативные): `число` = decimal, `строка` = string, `булево` = boolean, `дата` = date, `датаВремя` = dateTime, `СтандартныйПериод` = StandardPeriod, `СправочникСсылка.X` = CatalogRef.X, `ДокументСсылка.X` = DocumentRef.X, `int`/`number` = decimal, `bool` = boolean. Регистронезависимые.
60
61	Роли: `@dimension`, `@account`, `@balance`, `@period`.
62
63	Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.
64
65	### Итоги (shorthand)
66
67	```json
68	"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]
69	```
70
71	### Параметры (shorthand + @autoDates)
72
73	```json
74	"parameters": [
75	"Период: StandardPeriod = LastMonth @autoDates"
76	]
77	```
78
79	`@autoDates` — автоматически генерирует параметры `ДатаНачала` и `ДатаОкончания` с выражениями `&Период.ДатаНачала` / `&Период.ДатаОкончания` и `availableAsField=false`. Заменяет 5 строк на 1.
80
81	### Фильтры — shorthand
82
83	```json
84	"filter": [
85	"Организация = _ @off @user",
86	"Дата >= 2024-01-01T00:00:00",
87	"Статус filled"
88	]
89	```
90
91	Формат: `"Поле оператор значение @флаги"`. Значение `_` = пустое (placeholder). Флаги: `@off` (use=false), `@user` (userSettingID=auto), `@quickAccess`, `@normal`, `@inaccessible`.
92
93	В объектной форме доступны: `viewMode`, `userSettingID`, `userSettingPresentation`.
94
95	Группы фильтров (Or/And/Not):
96	```json
97	{ "group": "Or", "items": [
98	{ "group": "And", "items": [
99	{ "field": "Статус", "op": "=", "value": "Активен" },
100	{ "field": "Сумма", "op": ">", "value": 1000 }
101	]},
102	{ "field": "Количество", "op": "filled" }
103	]}
104	```
105
106	### Параметры данных — shorthand
107
108	```json
109	"dataParameters": [
110	"Период = LastMonth @user",
111	"Организация @off @user"
112	]
113	```
114
115	Формат: `"Имя [= значение] @флаги"`. Для StandardPeriod варианты (LastMonth, ThisYear и т.д.) распознаются автоматически.
116
117	### Структура — string shorthand
118
119	```json
120	"structure": "Организация > details"
121	"structure": "Организация > Номенклатура > details"
122	```
123
124	`>` разделяет уровни группировки. `details` (или `детали`) = детальные записи. `selection` и `order` по умолчанию `["Auto"]` на каждом уровне.
125
126	Для сложных случаев (таблицы, диаграммы, фильтры на уровне группировки) используется объектная форма.
127
128	### Варианты настроек
129
130	```json
131	"settingsVariants": [{
132	"name": "Основной",
133	"settings": {
134	"selection": ["Номенклатура", "Количество", "Auto"],
135	"filter": ["Организация = _ @off @user"],
136	"order": ["Количество desc", "Auto"],
137	"conditionalAppearance": [
138	{
139	"filter": ["Просрочено = true"],
140	"appearance": { "ЦветТекста": "style:ПросроченныеДанныеЦвет" },
141	"presentation

People who liked this also viewed

6 picks

Type

skd-compile

150stars20forks

View on GitHub

How to install skd-compile?

arman-kudaibergenov/1c-ai-development-kit/skd-compile

$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill skd-compile

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /skd-compile — генерация СКД из JSON DSL
2
3	Принимает JSON-определение схемы компоновки данных → генерирует Template.xml (DataCompositionSchema).
4
5	## Параметры и команда
6
7	\| Параметр \| Описание \|
8	\|----------\|----------\|
9	\| `DefinitionFile` \| Путь к JSON-файлу с определением СКД (взаимоисключающий с Value) \|
10	\| `Value` \| JSON-строка с определением СКД (взаимоисключающий с DefinitionFile) \|
11	\| `OutputPath` \| Путь к выходному Template.xml \|
12
13	```powershell
14	# Из файла
15	powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -DefinitionFile "<json>" -OutputPath "<Template.xml>"
16
17	# Из строки (без промежуточного файла)
18	powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.ps1 -Value '<json-string>' -OutputPath "<Template.xml>"
19	```
20
21	## JSON DSL — краткий справочник
22
23	Полная спецификация: `docs/skd-dsl-spec.md`.
24
25	### Корневая структура
26
27	```json
28	{
29	"dataSets": [...],
30	"calculatedFields": [...],
31	"totalFields": [...],
32	"parameters": [...],
33	"dataSetLinks": [...],
34	"settingsVariants": [...]
35	}
36	```
37
38	Умолчания: `dataSources` → авто `ИсточникДанных1/Local`; `settingsVariants` → авто "Основной" с деталями.
39
40	### Наборы данных
41
42	Тип по ключу: `query` → DataSetQuery, `objectName` → DataSetObject, `items` → DataSetUnion.
43
44	```json
45	{ "name": "Продажи", "query": "ВЫБРАТЬ ...", "fields": [...] }
46	```
47
48	### Поля — shorthand
49
50	```
51	"Наименование" — просто имя
52	"Количество: decimal(15,2)" — имя + тип
53	"Организация: CatalogRef.Организации @dimension" — + роль
54	"Служебное: string #noFilter #noOrder" — + ограничения
55	```
56
57	Типы: `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 со ссылочными типами требует базу с соответствующей конфигурацией.
58
59	Синонимы типов (русские и альтернативные): `число` = decimal, `строка` = string, `булево` = boolean, `дата` = date, `датаВремя` = dateTime, `СтандартныйПериод` = StandardPeriod, `СправочникСсылка.X` = CatalogRef.X, `ДокументСсылка.X` = DocumentRef.X, `int`/`number` = decimal, `bool` = boolean. Регистронезависимые.
60
61	Роли: `@dimension`, `@account`, `@balance`, `@period`.
62
63	Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.
64
65	### Итоги (shorthand)
66
67	```json
68	"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]
69	```
70
71	### Параметры (shorthand + @autoDates)
72
73	```json
74	"parameters": [
75	"Период: StandardPeriod = LastMonth @autoDates"
76	]
77	```
78
79	`@autoDates` — автоматически генерирует параметры `ДатаНачала` и `ДатаОкончания` с выражениями `&Период.ДатаНачала` / `&Период.ДатаОкончания` и `availableAsField=false`. Заменяет 5 строк на 1.
80
81	### Фильтры — shorthand
82
83	```json
84	"filter": [
85	"Организация = _ @off @user",
86	"Дата >= 2024-01-01T00:00:00",
87	"Статус filled"
88	]
89	```
90
91	Формат: `"Поле оператор значение @флаги"`. Значение `_` = пустое (placeholder). Флаги: `@off` (use=false), `@user` (userSettingID=auto), `@quickAccess`, `@normal`, `@inaccessible`.
92
93	В объектной форме доступны: `viewMode`, `userSettingID`, `userSettingPresentation`.
94
95	Группы фильтров (Or/And/Not):
96	```json
97	{ "group": "Or", "items": [
98	{ "group": "And", "items": [
99	{ "field": "Статус", "op": "=", "value": "Активен" },
100	{ "field": "Сумма", "op": ">", "value": 1000 }
101	]},
102	{ "field": "Количество", "op": "filled" }
103	]}
104	```
105
106	### Параметры данных — shorthand
107
108	```json
109	"dataParameters": [
110	"Период = LastMonth @user",
111	"Организация @off @user"
112	]
113	```
114
115	Формат: `"Имя [= значение] @флаги"`. Для StandardPeriod варианты (LastMonth, ThisYear и т.д.) распознаются автоматически.
116
117	### Структура — string shorthand
118
119	```json
120	"structure": "Организация > details"
121	"structure": "Организация > Номенклатура > details"
122	```
123
124	`>` разделяет уровни группировки. `details` (или `детали`) = детальные записи. `selection` и `order` по умолчанию `["Auto"]` на каждом уровне.
125
126	Для сложных случаев (таблицы, диаграммы, фильтры на уровне группировки) используется объектная форма.
127
128	### Варианты настроек
129
130	```json
131	"settingsVariants": [{
132	"name": "Основной",
133	"settings": {
134	"selection": ["Номенклатура", "Количество", "Auto"],
135	"filter": ["Организация = _ @off @user"],
136	"order": ["Количество desc", "Auto"],
137	"conditionalAppearance": [
138	{
139	"filter": ["Просрочено = true"],
140	"appearance": { "ЦветТекста": "style:ПросроченныеДанныеЦвет" },
141	"presentation

People who liked this also viewed

6 picks

Type