Skill v1.0.0
currentAutomated scan100/100name: xbsl-form-cards description: > Создаёт форму списка в виде карточек (ПроизвольныйСписок с матричной компоновкой) для объекта конфигурации 1С:Элемент. Создаёт два файла: ФормаСписка.yaml и СтрокаСписка<Объект>.yaml. Вызывай когда пользователь хочет отображать список в виде карточек, плиток, kanban-вида, новостной ленты или grid-сетки (не таблицей). Работает для Справочников и Документов. compatibility: Requires Python 3. metadata: version: "1.0.0"
Во всех командах ниже {python} означает python в Windows и python3 в macOS/Linux/WSL. Выбирай команду сразу по текущей ОС, не запускай оба варианта.
Отличие от стандартной ФормаСписка
Стандартная форма списка (xbsl-form-add) создаёт Таблица<ДинамическийСписок> — строчный список. Этот скилл создаёт ПроизвольныйСписок<ДинамическийСписок> с КонтейнерСтрок: Матричная — сетку карточек. Требует ДВУХ файлов: форма + компонент строки (СтрокаСписка<Объект>.yaml).
Справочная документация по YAML-шаблонам — в references/patterns.md.
Алгоритм
Шаг 1 — Dry-run
{python} skills/xbsl-form-cards/scripts/generate.py --object <ИмяОбъекта> --root <корень>
Скрипт выводит:
- роли полей (заголовок, фото, содержимое)
- тип карточки (
СтандартнаяКарточкаилиПроизвольнаяКарточка) - файлы которые будут созданы/обновлены
Показать вывод пользователю.
Если вывод содержит ⚠️ Форма списка уже существует — спросить пользователя:
- Заменить → продолжить с
--apply - Отмена → остановиться
Если скрипт завершился с ошибкой — сообщи пользователю и остановись.
Шаг 2 — Применить (только после подтверждения)
{python} skills/xbsl-form-cards/scripts/generate.py --object <ИмяОбъекта> --root <корень> --apply
Опциональный флаг --min-width 250 (для портретов людей) или --min-width 400 (по умолчанию). Скрипт автоматически выбирает 250 если есть поле ДвоичныйОбъект.Ссылка?.
Для целевой версии 10.0 при необходимости добавь --settings-mode Расширенный, --auto-filter <Поле>[:Всегда|Опционально|НеОтображать], --auto-sort <Поле>, --deletion-filter, --multi-sort. Флаги полей можно повторять. Их размещение и YAML-паттерн описаны в references/patterns.md.
Шаг 3 — Итог
Перечислить созданные/изменённые файлы из вывода скрипта:
<Объект>ФормаСписка.yaml— создана форма карточекСтрокаСписка<Объект>.yaml— создан компонент строки<ОбъектYAML>— обновлёнИнтерфейс.Список.Форма