xbsl-meta-add

name	xbsl-meta-add
description	Создание объекта конфигурации в 1С:Элемент (XBSL). Используй этот скилл когда пользователь хочет создать новый объект метаданных в проекте
compatibility	Requires Python 3.

Во всех командах ниже {python} означает python в Windows и python3 в macOS/Linux/WSL. Выбирай команду сразу по текущей ОС, не запускай оба варианта.

Создание объекта конфигурации в 1С:Элемент

HttpСервис — быстрый путь

Если тип объекта HttpСервис — используй скрипт вместо шагов 1–4:

Шаг 1 — Dry-run

{python} .claude/skills/xbsl-meta-add/scripts/generate_http.py \
  --name <ИмяСервиса> \
  --url /api/<ресурс> \
  --routes "GET /, POST /, GET /{id}" \
  --root <корень>

Опциональные флаги:

• --subsystem <ИмяПодсистемы> — если нужно выбрать конкретную подсистему
• --access РазрешеноАутентифицированным — контроль доступа (по умолчанию РазрешеноВсем)

Показать вывод пользователю. Если ⚠️ Сервис уже существует — спросить: заменить или отмена. Если скрипт завершился с ошибкой — сообщи пользователю и остановись.

Шаг 2 — Применить (только после подтверждения)

{python} .claude/skills/xbsl-meta-add/scripts/generate_http.py \
  --name <ИмяСервиса> --url /api/<ресурс> --routes "..." --root <корень> --apply

Шаг 3 — Итог

Перечислить созданные файлы из вывода скрипта:

• <ИмяСервиса>.yaml — объект HttpСервис с маршрутами
• <ИмяСервиса>.xbsl — заготовки обработчиков

---

Добавление маршрутов в существующий сервис

Если пользователь хочет добавить endpoint в уже существующий HttpСервис:

Шаг 1 — Dry-run

{python} .claude/skills/xbsl-meta-add/scripts/generate_http.py \
  --service <ИмяСервиса> \
  --add-routes "DELETE /{id}, GET /{id}/items" \
  --root <корень>

Показать вывод пользователю. Если ⚠️ обработчик уже существует — он будет пропущен.

Шаг 2 — Применить

{python} .claude/skills/xbsl-meta-add/scripts/generate_http.py \
  --service <ИмяСервиса> --add-routes "..." --root <корень> --apply

Шаг 3 — Итог

• <ИмяСервиса>.yaml — добавлены новые ШаблоныUrl
• <ИмяСервиса>.xbsl — добавлены новые методы-обработчики

---

Все остальные типы объектов

Шаг 0: Определи тип объекта

Из запроса пользователя определи ВидЭлемента:

ВидЭлемента	Когда использовать
Перечисление	Фиксированный набор значений (статусы, приоритеты, виды)
Справочник	Хранилище записей (сотрудники, контрагенты, товары)
Документ	Бизнес-событие с историей (заказы, накладные, акты)
РегистрСведений	Срезы данных по измерениям (курсы валют, цены)
РегистрНакопления	Обороты или остатки (продажи, складские остатки)
ОбщийМодуль	Переиспользуемый код (утилиты, сервисы)
Структура	DTO / value object (данные для передачи между методами)
ЛокализованныеСтроки	Тексты интерфейса (один объект на подсистему)
HttpСервис	REST API (эндпоинты для внешних систем)
ГлобальноеКлиентскоеСобытие	Событие между подсистемами (оповещение об изменении)
КлючДоступа	Маркер прав доступа (роль, владелец)
Отчет	Аналитический отчёт с визуализацией (остатки, продажи, анализ данных)

Шаги 1 и 2: выполни параллельно

Шаг 1 — Загрузи спецификацию. Прочитай файл спецификации для нужного типа:

references/{ТипОбъекта}.md

Для объектов с реквизитами (Справочник, Документ, РегистрСведений, РегистрНакопления) дополнительно прочитай references/types.md.

Для Отчет — читай references/Отчет.md; если есть ПараметрыЗапроса — дополнительно прочитай references/types.md.

Если в запросе упоминаются табличные части (ТЧ, строки, таблица, колонки) — дополнительно прочитай references/ТабличныеЧасти.md.

Шаг 2 — Разведка проекта. Используй скилл xbsl-explore, передав тип объекта и имя (если известно из запроса).

Если xbsl-explore вернул пустой список projects — остановись и предложи пользователю сначала создать проект через скилл xbsl-init, затем повторить запрос.

Шаг 3: Сгенерируй UUID

Из спецификации узнай, сколько UUID нужно (1 на объект + по 1 на каждый реквизит/элемент/измерение/ресурс). Посчитай точное количество и вызови скилл xbsl-uuid с этим числом.

Шаг 3а: Проверь межподсистемные ссылки

Для каждого ссылочного реквизита (<Имя>.Ссылка?) из запроса определи подсистему объекта-источника.

Как определить подсистему источника:

• Из результатов xbsl-explore (шаг 2) извлеки корень проекта
• Найди файл <Имя>.yaml в дереве проекта: <root>/**/<Имя>.yaml
• Имя папки-родителя этого файла — подсистема Y источника
• Имя папки из suggested_path нового объекта — подсистема X

Если подсистема Y источника отличается от подсистемы X нового объекта:

Файл	Действие
<ПодсистемаY>/<Источник>.yaml	Прочитай. Если ОбластьВидимости: ВПодсистеме — изменить на ВПроекте
<ПодсистемаX>/Подсистема.yaml	Добавить Y в список Использование (если Y ещё не в списке)
Новый объект (создаётся в Шаге 4)	Включить поле Импорт: [Y] (объединить все внешние подсистемы одним списком)

Для каждого изменённого существующего файла кратко сообщи пользователю:

• «Обновлён ОбластьВидимости → ВПроекте в Основное/Склады.yaml»
• «Добавлено Использование: [Основное] в Закупки/Подсистема.yaml»

Если объект-источник не найден в проекте — действуй по текущему правилу (ставь Тип: Строка, предупреди пользователя).

Шаг 4: Создай файлы

• Создай {ИмяОбъекта}.yaml по структуре из спецификации, в suggested_path из разведки
• Создай {ИмяОбъекта}.xbsl только если пользователь явно запросил методы

Шаг 5: Контроль доступа

Если тип объекта — Справочник, Документ, РегистрСведений или РегистрНакопления — вызови скилл xbsl-access-set, передав:

• корень проекта (из результатов xbsl-explore, шаг 2)
• имя только что созданного объекта (параметр --object)

Скилл сам спросит у пользователя желаемое значение ПоУмолчанию, покажет dry-run и применит изменения после подтверждения.

Для всех остальных типов (Перечисление, ОбщийМодуль, Структура, ЛокализованныеСтроки, ГлобальноеКлиентскоеСобытие, КлючДоступа, Отчет) — шаг пропускается. Для HttpСервис шаг не нужен: быстрый путь уже принимает флаг --access.

Шаг 6: Движения по регистру (только для Документа)

Если создаётся Документ и пользователь упоминает движения, регистр накопления, регистр сведений, приход, расход, списание, поступление, проведение — после создания .yaml вызови скилл xbsl-pattern-register.

Скилл напишет код в файл <ИмяДокумента>.Объект.xbsl (не .xbsl). Без суффикса .Объект платформа не привяжет код к объекту.