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