agentleFS
anymasoftanymasoft/1c-ai/.claude/skills/form-compile/SKILL.md

form-compile

Skill0 starsChanged 4 months agoMITView on GitHub

Этот скилл MUST быть вызван когда нужно создать управляемую форму с нуля по JSON-определению элементов. SHOULD также вызывать когда структура формы хорошо определена и требует генерации. Do NOT использовать для модификации существующей формы — используй form-edit; для добавления формы-заглушки — используй form-add.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/form-compile — Генерация Form.xml из JSON DSL

Принимает компактное JSON-определение формы (20–50 строк) и генерирует полный корректный Form.xml (100–500+ строк) с namespace-декларациями, автогенерированными companion-элементами, последовательными ID.

При проектировании формы с нуля (5+ элементов или нечёткие требования) — вызовите /form-patterns для загрузки справочника: архетипы, конвенции именования, продвинутые паттерны. Для простых форм (1–3 поля, пользователь описал что нужно) — не нужно.

Использование

/form-compile <JsonPath> <OutputPath>

Параметры

ПараметрОбязательныйОписание
JsonPathдаПуть к JSON-определению формы
OutputPathдаПуть к выходному файлу Form.xml

Команда

powershell.exe -NoProfile -File .claude/skills/form-compile/scripts/form-compile.ps1 -JsonPath "<json>" -OutputPath "<xml>"

JSON DSL — справка

Структура верхнего уровня

{
  "title": "Заголовок формы",
  "properties": { "autoTitle": false, ... },
  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
  "excludedCommands": ["Reread"],
  "elements": [ ... ],
  "attributes": [ ... ],
  "commands": [ ... ],
  "parameters": [ ... ]
}
  • title — заголовок формы (multilingual). Можно указать и в properties, но лучше на верхнем уровне
  • properties — свойства формы: autoTitle, windowOpeningMode, commandBarLocation, saveDataInSettings, width, height и др.
  • events — обработчики событий формы (ключ: имя события 1С, значение: имя процедуры)
  • excludedCommands — исключённые стандартные команды

Элементы (ключ определяет тип)

DSL ключXML элементЗначение ключа
"group"UsualGroup"horizontal" / "vertical" / "alwaysHorizontal" / "alwaysVertical" / "collapsible"
"input"InputFieldимя элемента
"check"CheckBoxFieldимя
"label"LabelDecorationимя (текст задаётся через title)
"labelField"LabelFieldимя
"table"Tableимя
"pages"Pagesимя
"page"Pageимя
"button"Buttonимя
"picture"PictureDecorationимя
"picField"PictureFieldимя
"calendar"CalendarFieldимя
"cmdBar"CommandBarимя
"popup"Popupимя

Общие свойства (все типы элементов)

КлючОписание
nameПереопределить имя (по умолчанию = значение ключа типа)
titleЗаголовок элемента
visible: falseСкрыть (синоним: hidden: true)
enabled: falseСделать недоступным (синоним: disabled: true)
readOnly: trueТолько чтение
on: [...]События с автоименованием обработчиков
handlers: {...}Явное задание имён обработчиков: {"OnChange": "МоёИмя"}

Допустимые имена событий (on)

Компилятор предупреждает о неизвестных событиях. Имена регистрозависимы — используйте точно как указано.

Форма (events): OnCreateAtServer, OnOpen, BeforeClose, OnClose, NotificationProcessing, ChoiceProcessing, OnReadAtServer, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer, BeforeWrite, AfterWrite, FillCheckProcessingAtServer, BeforeLoadDataFromSettingsAtServer, OnLoadDataFromSettingsAtServer, ExternalEvent, Opening

input / picField: OnChange, StartChoice, ChoiceProcessing, AutoComplete, TextEditEnd, Clearing, Creating, EditTextChange

check: OnChange

table: OnStartEdit, OnEditEnd, OnChange, Selection, ValueChoice, BeforeAddRow, BeforeDeleteRow, AfterDeleteRow, BeforeRowChange, BeforeEditEnd, OnActivateRow, OnActivateCell, Drag, DragStart, DragCheck, DragEnd

label / picture: Click, URLProcessing

labelField: OnChange, StartChoice, ChoiceProcessing, Click, URLProcessing, Clearing

button: Click

pages: OnCurrentPageChange

Поле ввода (input)

КлючОписаниеПример
pathDataPath — привязка к данным"Объект.Организация"
titleLocationРазмещение заголовка"none", "left", "top"
multiLine: trueМногострочное полетекстовое поле, комментарий
passwordMode: trueРежим пароля (звёздочки)поле ввода пароля
choiceButton: trueКнопка выбора ("...")ссылочное поле
clearButton: trueКнопка очистки ("X")
spinButton: trueКнопка прокруткичисловые поля
dropListButton: trueКнопка выпадающего списка
markIncomplete: trueПометка незаполненногообязательные поля
skipOnInput: trueПропускать при обходе Tab
inputHintПодсказка в пустом поле"Введите наименование..."
width / heightРазмерчисла
autoMaxWidth: falseОтключить авто-ширинудля фиксированных полей
horizontalStretch: trueРастягивать по ширине

Чекбокс (check)

КлючОписание
pathDataPath
titleLocationРазмещение заголовка

Надпись-декорация (label)

КлючОписание
titleТекст надписи (обязательно)
hyperlink: trueСделать ссылкой
width / heightРазмер

Группа (group)

Значение ключа задаёт ориентацию: "horizontal", "vertical", "alwaysHorizontal", "alwaysVertical", "collapsible".

КлючОписание
showTitle: trueПоказывать заголовок группы
united: falseНе объединять рамку
representation"none", "normal", "weak", "strong"
children: [...]Вложенные элементы

Таблица (table)

Важно: таблица требует связанный реквизит формы типа ValueTable с колонками (см. раздел "Связки").

КлючОписание
pathDataPath (привязка к реквизиту-таблице)
columns: [...]Колонки — массив элементов (обычно input)
changeRowSet: trueРазрешить добавление/удаление строк
changeRowOrder: trueРазрешить перемещение строк
heightВысота в строках таблицы
header: falseСкрыть шапку
footer: trueПоказать подвал
commandBarLocation"None", "Top", "Auto"
searchStringLocation"None", "Top", "Auto"

Страницы (pages + page)

Ключ (pages)Описание
pagesRepresentation"None", "TabsOnTop", "TabsOnBottom" и др.
children: [...]Массив page
Ключ (page)Описание
titleЗаголовок вкладки
groupОриентация внутри страницы
children: [...]Содержимое страницы

Кнопка (button)

КлючОписание
commandИмя команды формы → Form.Command.Имя
stdCommandСтандартная команда: "Close" → Form.StandardCommand.Close; с точкой: "Товары.Add" → Form.Item.Товары.StandardCommand.Add
defaultButton: trueКнопка по умолчанию
type"usual", "hyperlink", "commandBar"
pictureКартинка кнопки
representation"Auto", "Text", "Picture", "PictureAndText"
locationInCommandBar"Auto", "InCommandBar", "InAdditionalSubmenu"

Командная панель (cmdBar)

КлючОписание
autofill: trueАвтозаполнение стандартными командами
children: [...]Кнопки панели

Выпадающее меню (popup)

КлючОписание
titleЗаголовок подменю
children: [...]Кнопки подменю

Используется внутри cmdBar для группировки кнопок в подменю:

{ "cmdBar": "Панель", "children": [
  { "popup": "Добавить", "title": "Добавить", "children": [
    { "button": "ДобавитьСтроку", "stdCommand": "Товары.Add" },
    { "button": "ДобавитьИзДокумента", "command": "ДобавитьИзДокумента", "title": "Из документа" }
  ]}
]}

Реквизиты (attributes)

{ "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true }
{ "name": "Итого", "type": "decimal(15,2)" }
{ "name": "Таблица", "type": "ValueTable", "columns": [
    { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },
    { "name": "Количество", "type": "decimal(10,3)" }
]}
  • savedData: true — сохраняемые данные

Команды (commands)

{ "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" }
  • title — заголовок (если отличается от name)
  • picture — картинка команды

Система типов

DSLXML
"string" / "string(100)"xs:string + StringQualifiers
"decimal(15,2)"xs:decimal + NumberQualifiers
"decimal(10,0,nonneg)"с AllowedSign=Nonnegative
"boolean"xs:boolean
"date" / "dateTime" / "time"xs:dateTime + DateFractions
"CatalogRef.XXX"cfg:CatalogRef.XXX
"DocumentRef.XXX"cfg:DocumentRef.XXX
"ValueTable"v8:ValueTable
"ValueList"v8:ValueListType
"Type1 | Type2"составной тип

Связки: элемент + реквизит

Таблица и некоторые поля требуют связанный реквизит. Элемент ссылается на реквизит через path.

Таблица — элемент table + реквизит ValueTable:

{
  "elements": [
    { "table": "Товары", "path": "Объект.Товары", "columns": [
      { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
    ]}
  ],
  "attributes": [
    { "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true,
      "columns": [
        { "name": "Товары", "type": "ValueTable", "columns": [
          { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" }
        ]}
      ]
    }
  ]
}

Или, если таблица привязана к реквизиту формы (не к Объект):

{
  "elements": [
    { "table": "ТаблицаДанных", "path": "ТаблицаДанных", "columns": [
      { "input": "Наименование", "path": "ТаблицаДанных.Наименование" }
    ]}
  ],
  "attributes": [
    { "name": "ТаблицаДанных", "type": "ValueTable", "columns": [
      { "name": "Наименование", "type": "string(150)" }
    ]}
  ]
}

Паттерны

Диалог загрузки файла

{
  "title": "Загрузка из файла",
  "properties": { "autoTitle": false },
  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
  "elements": [
    { "group": "horizontal", "name": "ГруппаФайл", "children": [
      { "input": "ИмяФайла", "path": "ИмяФайла", "title": "Файл", "inputHint": "Выберите файл...", "choiceButton": true, "on": ["StartChoice"] },
      { "check": "ПерваяСтрокаЗаголовок", "path": "ПерваяСтрокаЗаголовок" }
    ]},
    { "input": "Результат", "path": "Результат", "multiLine": true, "height": 8, "readOnly": true, "title": "Лог" },
    { "group": "horizontal", "name": "ГруппаКнопок", "children": [
      { "button": "Загрузить", "command": "Загрузить", "defaultButton": true },
      { "button": "Закрыть", "stdCommand": "Close" }
    ]}
  ],
  "attributes": [
    { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзФайла", "main": true },
    { "name": "ИмяФайла", "type": "string" },
    { "name": "ПерваяСтрокаЗаголовок", "type": "boolean" },
    { "name": "Результат", "type": "string" }
  ],
  "commands": [
    { "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" }
  ]
}

Мастер (wizard) с шагами

{
  "title": "Мастер настройки",
  "properties": { "autoTitle": false },
  "elements": [
    { "pages": "СтраницыМастера", "pagesRepresentation": "None", "children": [
      { "page": "Шаг1", "title": "Параметры", "children": [
        { "input": "Параметр1", "path": "Параметр1" }
      ]},
      { "page": "Шаг2", "title": "Результат", "children": [
        { "input": "Итог", "path": "Итог", "readOnly": true }
      ]}
    ]},
    { "group": "horizontal", "name": "Навигация", "children": [
      { "button": "Назад", "command": "Назад", "title": "< Назад" },
      { "button": "Далее", "command": "Далее", "title": "Далее >" }
    ]}
  ],
  "attributes": [
    { "name": "Объект", "type": "ExternalDataProcessorObject.Мастер", "main": true },
    { "name": "Параметр1", "type": "string" },
    { "name": "Итог", "type": "string" }
  ],
  "commands": [
    { "name": "Назад", "action": "НазадОбработка" },
    { "name": "Далее", "action": "ДалееОбработка" }
  ]
}

Список с фильтром и таблицей

{
  "title": "Просмотр данных",
  "elements": [
    { "group": "horizontal", "name": "Фильтр", "children": [
      { "input": "Период", "path": "Период", "on": ["OnChange"] },
      { "input": "Организация", "path": "Организация", "on": ["OnChange"] }
    ]},
    { "table": "Данные", "path": "Данные", "changeRowSet": true, "columns": [
      { "input": "Дата", "path": "Данные.Дата" },
      { "input": "Сумма", "path": "Данные.Сумма" },
      { "input": "Комментарий", "path": "Данные.Комментарий" }
    ]}
  ],
  "attributes": [
    { "name": "Объект", "type": "ExternalDataProcessorObject.Просмотр", "main": true },
    { "name": "Период", "type": "date" },
    { "name": "Организация", "type": "string" },
    { "name": "Данные", "type": "ValueTable", "columns": [
      { "name": "Дата", "type": "date" },
      { "name": "Сумма", "type": "decimal(15,2)" },
      { "name": "Комментарий", "type": "string(200)" }
    ]}
  ]
}

Автогенерация

  • Companion-элементы: ContextMenu, ExtendedTooltip и др. создаются автоматически
  • Обработчики событий: "on": ["OnChange"] → ОрганизацияПриИзменении
  • Namespace: все 17 namespace-деклараций
  • ID: последовательная нумерация, AutoCommandBar = id="-1"
  • Unknown keys: выводится предупреждение о нераспознанных ключах

Верификация

/form-validate <OutputPath>    — проверка корректности XML
/form-info <OutputPath>        — визуальная сводка структуры

Особенности для внешних обработок (EPF)

  • Тип главного реквизита: ExternalDataProcessorObject.ИмяОбработки (не DataProcessorObject)
  • DataPath: используйте реквизиты формы (ИмяРеквизита), а не Объект.ИмяРеквизита — у внешних обработок нет реквизитов объекта в метаданных
  • Ссылочные типы: CatalogRef.XXX, DocumentRef.XXX допустимы в XML, но для сборки EPF потребуется база с целевой конфигурацией (см. /epf-build)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.