XBSL Skills для 1С:Элемент

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

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

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

Перед созданием или дополнением `.xbsl` прочитай `docs/xbsl-spec.md`; API
HttpСервиса и других объектов сверяй по reference-файлам скилла и официальным
источникам из registry.

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

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

### Шаг 1 — Dry-run

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

Опциональные флаги:
- `--subsystem <ИмяПодсистемы>` — если нужно выбрать конкретную подсистему
- `--access РазрешеноАутентифицированным` — добавить контроль доступа; без `--access` блок контроля доступа не добавляется.

`/api` зарезервирован платформой и отклоняется: платформа автоматически добавляет
этот префикс к `КорневойUrl`.

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

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

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

### Шаг 3 — Итог

Перечислить созданные файлы из вывода скрипта:
- `<ИмяСервиса>.yaml` — объект HttpСервис с маршрутами
- `<ИмяСервиса>.xbsl` — заготовки обработчиков