// Точечное редактирование схемы компоновки данных 1С (СКД). Используй когда нужно модифицировать существующую СКД — добавить поля, итоги, фильтры, параметры, изменить текст запроса
Компиляция схемы компоновки данных 1С (СКД) из компактного JSON-определения. Используй когда нужно создать СКД с нуля
Тестирование 1С через веб-клиент — автоматизация действий в браузере. Используй когда пользователь просит проверить, протестировать, автоматизировать действия в 1С через браузер
Декомпиляция схемы компоновки данных 1С (СКД) в JSON-черновик в формате skd-compile. Используй для scaffold нового отчёта по образцу или структурного рефакторинга. Не для точечных правок
Анализ структуры схемы компоновки данных 1С (СКД) — наборы, поля, параметры, варианты. Используй для понимания отчёта — источник данных (запрос), доступные поля, параметры
Валидация схемы компоновки данных 1С (СКД). Используй после создания или модификации СКД для проверки корректности
Валидация управляемой формы 1С. Используй после создания или модификации формы для проверки корректности. При наличии BaseForm автоматически проверяет callType и ID расширений
| name | skd-edit |
| description | Точечное редактирование схемы компоновки данных 1С (СКД). Используй когда нужно модифицировать существующую СКД — добавить поля, итоги, фильтры, параметры, изменить текст запроса |
| argument-hint | <TemplatePath> -Operation <op> -Value <value> |
| allowed-tools | ["Bash","Read","Write","Glob"] |
Атомарные операции модификации существующей схемы компоновки данных: добавление, удаление и модификация полей, итогов, фильтров, параметров, настроек варианта, управление структурой, замена запроса.
| Параметр | Описание |
|---|---|
TemplatePath | Путь к Template.xml (или к папке — автодополнение Ext/Template.xml) |
Operation | Операция (см. список ниже) |
Value | Значение операции (shorthand-строка или текст запроса) |
DataSet | (опц.) Имя набора данных (умолч. первый) |
Variant | (опц.) Имя варианта настроек (умолч. первый) |
NoSelection | (опц.) Не добавлять поле в selection варианта |
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/skd-edit.ps1" -TemplatePath "<path>" -Operation <op> -Value "<value>"
Несколько значений в одном вызове через разделитель ;;:
-Operation add-field -Value "Цена: decimal(15,2) ;; Количество: decimal(15,3) ;; Сумма: decimal(15,2)"
Работает для всех операций кроме set-query, set-structure и add-dataSet.
Shorthand: "Имя [Заголовок]: тип @роль #ограничение".
"Цена: decimal(15,2)"
"Организация [Орг-ция]: CatalogRef.Организации @dimension"
"Служебное: string #noFilter #noOrder"
Поле добавляется в набор и в selection варианта (если нет -NoSelection). Дубликат dataPath — предупреждение, пропуск.
Чтобы поле попало в selection не варианта, а конкретной группировки структуры — используй -NoSelection и затем add-selection "Имя @group=ИмяГруппы".
Shorthand: "<dataPath>: <выражение>". Если выражение — известная аггрегатная функция без скобок (Сумма, Количество, Минимум, Максимум, Среднее), оно автоматически оборачивается в Func(dataPath). Если функция со скобками или произвольное выражение — используется как есть.
"Цена: Среднее" # → Среднее(Цена)
"Стоимость: Сумма(Кол * Цена)" # → как есть
"Проверка: Проверка" # identity: выражение = Проверка
Shorthand: "Имя [Заголовок]: тип = Выражение #noFilter #noOrder #noGroup".
"Маржа = Продажа - Закупка"
"Наценка [Наценка, %]: decimal(10,2) = Маржа / Закупка * 100"
"Служебное: string = \"\" #noFilter #noOrder #noGroup"
#noFilter, #noOrder, #noGroup, #noField → <useRestriction> (аналогично add-field).
Также добавляется в selection варианта.
"Период [Отчетный период]: StandardPeriod = LastMonth @autoDates"
"Организация: CatalogRef.Организации"
Shorthand: "Имя [Заголовок]: тип = значение [availableValue=список] [@флаги]". [Заголовок] опциональный — добавляет <title>.
Флаги:
@autoDates — генерирует пару скрытых параметров ДатаНачала/ДатаОкончания для StandardPeriod-параметра.@hidden — скрывает параметр от пользовательских настроек (для параметров-констант, используемых в запросе).@always — параметр всегда подставляется в запрос. Часто вместе с @hidden, но используется и отдельно (для видимых обязательных параметров типа отчётного периода)."ПС: CatalogRef.Контрагенты = Справочник.Контрагенты.ПустаяСсылка @hidden"
"Период: StandardPeriod = LastMonth @always"
"ПСчет: ChartOfAccountsRef.Хозрасчетный = ПланСчетов.Хозрасчетный.X @hidden @always"
"Округление: EnumRef.Округления = Окр1 availableValue=Перечисление.Округления.Окр1: руб., Перечисление.Округления.Окр1000: тыс."
availableValue= задаёт начальный список допустимых значений. Формат списка: v1[: p1], v2[: p2], ... — элементы через ,, представление после :. Если в значении или представлении встречается , или : — оборачивай в одинарные кавычки '...':
"Округление: ... = Окр1 availableValue=Окр1_00: 'руб., коп.', Окр1: руб."
Shorthand: "ИмяПараметра [Заголовок] [ключ=значение]... [@флаги]". Находит параметр по имени, обновляет указанные свойства.
"ПорядокОкругления use=Always"
"ПорядокОкругления [Округление сумм] denyIncompleteValues=true"
"ПериодОтчета [Отчетный период]" # только title
"ПорядокОкругления availableValue=Перечисление.Округления.Окр1: руб., Перечисление.Округления.Окр1000: тыс."
"СчетПС value=ПланСчетов.Хозрасчетный.КассаПредприятия"
"Контрагент @hidden @always"
[Заголовок] опциональный — устанавливает или заменяет <title>. Можно вызывать без других kv-пар, чтобы только обновить title.
availableValue= заменяет весь список допустимых значений (старые удаляются). Формат и кавычки — те же, что в add-parameter.
value= заменяет значение параметра (тип значения подбирается автоматически по объявленному типу параметра).
Флаги @hidden / @always — те же, что и в add-parameter. Идемпотентны.
Shorthand: "OldName => NewName". Атомарно обновляет имя параметра, ссылки &Имя в выражениях других параметров (только полные совпадения, &ПериодX не задевается), и записи в dataParameters всех вариантов. Текст запроса не трогает — переименование строго в области параметров.
"Период => ПериодОтчета"
Shorthand: "Имя1, Имя2, Имя3". Частичный список — указанные параметры идут первыми в заданном порядке, остальные сохраняют исходный порядок и идут в конце. Параметры из списка, которых нет в схеме — warning, пропуск.
"ПериодОтчета, НачалоПериода, КонецПериода"
Shorthand: "Поле оператор значение @флаги". Флаги: @off (use=false), @user (userSettingID=auto), @quickAccess, @normal, @inaccessible.
"Номенклатура = _ @off @user"
"Дата >= 2024-01-01T00:00:00"
"Статус filled"
Shorthand: "Имя [= значение] @флаги".
"Период = LastMonth @user"
"Организация @off @user"
Shorthand: "Поле [desc]". По умолчанию asc. Auto — авто-элемент.
"Количество desc"
"Auto"
"Номенклатура"
"Auto"
"Folder(Поступление: ПолеА, ПолеБ, ПолеВ)"
Folder(Название: поле1, поле2) — группа полей (SelectedItemFolder) с заголовком и placement=Auto.
@group=ИмяГруппировки — добавить в selection именованной группировки (вместо уровня варианта):
"Folder(Поступление: ПолеА, ПолеБ) @group=ДанныеОтчета"
Shorthand: "Источник > Приёмник on ВырИсточника = ВырПриёмника [param Имя]".
"Набор1 > Набор2 on Поле1 = Поле2"
"Набор1 > Набор2 on Поле1 = Поле2 [param Связь]"
Shorthand: "Имя: ТЕКСТ_ЗАПРОСА" или "ТЕКСТ_ЗАПРОСА" (авто-имя НаборДанныхN).
"Доп: ВЫБРАТЬ 1 КАК Тест"
"ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура"
"Продажи: @queries/sales.sql"
dataSource берётся из первого существующего. Дубликат имени — предупреждение, пропуск. Не поддерживает пакетный режим (запрос может содержать ;;).
Shorthand: "Имя [Представление]". Представление опционально, по умолчанию = имя.
"Детальный"
"Детальный [Детальный отчёт]"
Создаёт вариант с Auto selection + detail group. Дубликат имени — предупреждение, пропуск.
Shorthand: "Параметр = значение [when условие] [for Поле1, Поле2]". Блок when — синтаксис add-filter (Поле оператор значение).
"ЦветТекста = web:Red when Сумма < 0"
"ЦветФона = web:LightGreen when Статус = Одобрен for Статус"
"МинимальнаяШирина = 50 for Организация"
"Формат = ЧДЦ=2 for Цена, Сумма"
Типы значений appearance (автодетект): web:*/style:*/win:* → Color, true/false → Boolean, параметр Формат/Текст/Заголовок → LocalStringType, иначе String.
Типы значений фильтра (автодетект): Перечисление.*/Справочник.*/ПланСчетов.*/Документ.* → DesignTimeValue, true/false → Boolean, дата → DateTime, числа → Decimal, иначе String.
OrGroup: несколько условий через or в when объединяются в FilterItemGroup/OrGroup:
"Формат = ЧЦ=15; ЧДЦ=0 when ПараметрыДанных.Округление = Перечисление.Округления.Окр1 or ПараметрыДанных.Округление = Перечисление.Округления.Окр1000"
Важно: для параметров данных используйте префикс ПараметрыДанных. в поле фильтра.
Value — имена ресурсов (как в полях/вычисляемых полях СКД) через запятую.
"ПоступлениеИзПроизводства, ВыбытиеПрочее"
"Сумма_Дт83, Сумма_Дт99, Сумма_68, Сумма_84"
Подключает DrillDown по ИмяРесурса ко всем шаблонам, содержащим указанные ресурсы. Идемпотентно.
Не поддерживает пакетный режим. Value — полный текст запроса или @path/to/file.sql (ссылка на внешний файл). Путь разрешается относительно Template.xml, затем CWD.
Shorthand: "старое => новое [@once]". По умолчанию заменяет все вхождения подстроки. Поддерживает пакетный режим и -DataSet.
"СубконтоДт1) В => СубконтоКт1) В"
"КАК ВТ_СтароеИмя => КАК ВТ_НовоеИмя @once"
@once — упасть с ошибкой, если в запросе не ровно одно вхождение. Защищает от случайных замен в комментариях и однотипных идентификаторах.
Многострочные подстроки поддерживаются.
"Заголовок = Мой отчёт"
"ВыводитьЗаголовок = true"
Если параметр уже существует — заменяет значение.
Shorthand: "Поле1 > Поле2 > details". > — вложенный уровень группировки, , — несколько полей в одном уровне, details — детальные записи. Заменяет всю структуру полностью (включая Selection/order/filter/conditionalAppearance каждой группы). Для точечной модификации полей группировки с сохранением настроек — используй modify-structure. Не поддерживает пакетный режим.
"Организация > Номенклатура > details"
"Валюта, НаименованиеБанка, ИНН"
"details"
"СчетМеждународногоУчета @name=ДанныеОтчета"
@name=Имя — присваивает имя группировке (<dcsset:name>). Используется для привязки шаблонов через groupName.
Тот же shorthand что и set-structure. Находит группу по @name=, заменяет только <groupItems> (поля группировки). Selection/order/filter/conditionalAppearance/outputParameters группы сохраняются. Без @name= — ошибка.
"Валюта @name=ДанныеОтчета"
"Валюта, НаименованиеБанка @name=ДанныеОтчета"
"details @name=ДанныеОтчета"
Тот же shorthand что и add-field. Находит по dataPath, объединяет свойства (непустые переопределяют), сохраняет позицию.
"Цена [Цена USD]: decimal(10,4) @dimension"
Shorthand: "<dataPath> [@флаги] [kv=значение]". Полностью заменяет роль поля. Если в значении только dataPath без флагов/kv — удаляет роль.
"Сумма" # снять роль полностью
"СуммаОстаток @balance" # простая балансовая роль
"СуммаНач @balance balanceGroupName=Сумма balanceType=OpeningBalance" # с уточнением
"Контрагент @dimension parentDimension=Группа"
"Период @period" # роль периода
Флаги: @balance, @dimension, @account, @period, @required, @autoOrder, @ignoreNullValues.
KV: balanceGroupName, balanceType (OpeningBalance/ClosingBalance), parentDimension, accountTypeExpression, orderType (Asc/Desc), expression, periodNumber, periodType.
Поддерживает пакетный режим (;;).
Тот же shorthand что и add-filter. Находит по полю, обновляет оператор/значение/флаги. См. правило для <use> ниже.
Тот же shorthand что и add-dataParameter. Находит по имени, обновляет значение/флаги. См. правило для <use> ниже.
<use> для modify-filter / modify-dataParameterВ отличие от add-*, в modify-* поле <use> обновляется только если флаг задан явно:
@off — установить <use>false</use>@on — убрать существующий <use>false</use> (включить параметр)@off, ни @on не задано — <use> не трогается, существующее значение сохраняется (важно: это значит, что отключённый параметр останется отключённым после модификации других свойств)| Операция | Value | Действие |
|---|---|---|
remove-field | dataPath | Удаляет поле из набора + из selection варианта |
remove-total | dataPath | Удаляет итог |
remove-calculated-field | dataPath | Удаляет вычисляемое поле + из selection |
remove-parameter | name | Удаляет параметр |
remove-filter | поле | Удаляет первый фильтр с указанным полем |
clear-selection | * | Очищает все элементы selection |
clear-order | * | Очищает все элементы order |
clear-filter | * | Очищает все элементы filter |
clear-conditionalAppearance | * | Очищает все правила условного оформления |
/skd-validate <TemplatePath> — валидация структуры после редактирования
/skd-info <TemplatePath> — визуальная сводка