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

Установка

git clone https://github.com/korolevpavel/xbsl-ai-skills.git
mkdir -p /путь/к/твоему/проекту/.claude/skills/
cp -r xbsl-ai-skills/skills/. /путь/к/твоему/проекту/.claude/skills/

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор учит агента работать со структурой проекта 1С:Элемент на XBSL. Скиллы инициализируют проект, добавляют подсистемы, справочники, документы и перечисления, создают формы списка, карточки и главную страницу с виджетами. Отдельные скиллы делают движения по регистрам, RLS, запланированные задания, безопасное переименование с обновлением ссылок и read-only проверку YAML. xbsl-deploy управляет приложениями на 1С:Предприятие.Элемент, а xbsl-playwright сохраняет повторяемые e2e-тесты.

Для кого. Разработчикам на платформе 1С:Элемент, которые хотят поручать агенту рутинное создание объектов метаданных и деплой.

Пример запроса к агенту

Создай справочник Контрагенты с полями ИНН и КПП

Ограничения

19 скиллов требуют Python 3.10+, xbsl-validate также PyYAML 6. Для xbsl-playwright нужны Node.js и @playwright/test в проекте приложения. Для деплоя нужны ELEMENT_BASE_URL, ELEMENT_CLIENT_ID и ELEMENT_CLIENT_SECRET в .env. При обновлении папку скилла нужно заменять целиком.

Как отключить. Удалите папки xbsl-* из .claude/skills проекта или из ~/.codex/skills.

Проверка безопасности

• Запускает Python-скрипты, которые создают и меняют файлы проекта
• Деплой использует клиентский секрет Элемента
• Playwright-проверки могут создавать записи в приложении

Коротко о README

XBSL Skills содержит набор скиллов для платформы 1С:Элемент, совместимых с Claude Code и другими агентами. README перечисляет 20 скиллов от генерации UUID до RLS и дашбордов, описывает требования и установку копированием в .claude/skills или ~/.codex/skills. Есть примеры запросов, описание структуры проекта Элемента и настройки деплоя через .env. К репозиторию прилагаются тесты на pytest и сайт на GitHub Pages. Лицензия MIT.

SKILL.md

---
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` — заготовки обработчиков

Похожие