XBSL Skills — AI-инструменты для 1С:Элемент

Набор скиллов для работы с проектами на платформе 1С:Элемент (XBSL).

Скиллы совместимы с Claude Code и другими AI-агентами, поддерживающими формат скиллов.

Релиз 10.0.0.0

Актуальная линия скиллов рассчитана на 1С:Элемент 10.0. В выпуск вошли новые контракты метаданных и форм, журнал данных, интегрируемые приложения, подчинённые регистры сведений, настройки списков и обновлённые сценарии развёртывания. Сверка всех 20 скиллов с изменениями платформы, результаты локальных тестов и облачных проверок описаны в docs/element-10-audit.md.

Проверка нативного расширения в облаке (#197) и импорта внешней XSD в SOAP-сборке (#194) запланирована отдельно. Пользовательские сценарии TestApp после публикации вынесены в #202–#205.

Видео

Запись живого созвона: подключаем Claude Code и Codex к проекту на 1С:Элемент, работаем со скиллами, создаём объекты конфигурации и доводим всё до деплоя в 1CmyCloud.

Скиллы

Покрытие типов xbsl-meta-add для 1С:Предприятие.Элемент 10.0 хранится в каноническом registry object-coverage.json. Человекочитаемая матрица object-coverage.md генерируется из JSON и не редактируется вручную.

Общие reference-контракты находятся в references/: reference-contract.md, types.md и ТабличныеЧасти.md.

Требования

• Claude Code или другой AI-агент, поддерживающий скиллы
• Python 3.10+ — для работы 19 скиллов: xbsl-uuid, xbsl-init, xbsl-subsystem-add, xbsl-explore, xbsl-meta-add, xbsl-form-info, xbsl-form-add, xbsl-file-add, xbsl-image-add, xbsl-deploy, xbsl-pattern-register, xbsl-form-cards, xbsl-rename, xbsl-form-dashboard, xbsl-lib-connect, xbsl-access-set, xbsl-pattern-rls, xbsl-scheduled-task и xbsl-validate
• PyYAML 6.x — runtime-зависимость CLI xbsl-validate
• Node.js и @playwright/test — только для исполнения xbsl-playwright в consumer-проекте; в этот репозиторий Node-зависимости не устанавливаются

Во всех командах ниже {python} означает python в Windows и python3 в macOS/Linux/WSL. Выбранный интерпретатор должен быть Python 3.10+; если сомневаешься, проверь через {python} --version. Выбирай команду сразу по текущей ОС, не запускай оба варианта.

Установка

Клонируй репозиторий. Канонические исходники находятся в top-level каталоге skills/; .claude/skills не является source mirror.

Для Claude Code скопируй содержимое source-каталога в runtime-каталог проекта:

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

Для Codex установи их в runtime-каталог пользователя:

mkdir -p ~/.codex/skills/
cp -r xbsl-ai-skills/skills/. ~/.codex/skills/

Для установки только Playwright-скилла в Codex:

mkdir -p ~/.codex/skills
cp -R xbsl-ai-skills/skills/xbsl-playwright ~/.codex/skills/

При обновлении заменяй папку скилла целиком: старые дополнительные файлы не должны оставаться рядом с новой версией.

Использование

Скиллы подхватываются автоматически. Просто опиши задачу в Claude Code:

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

Добавь перечисление статусов задачи: Новая, В работе, Завершена

Задеплой ветку main на Элемент

Добавь движения документа РасходнаяНакладная в регистр ТоварыНаСкладах

Добавь к справочнику Контрагенты возможность прикреплять файлы

Проверь через Playwright формы уже развёрнутого приложения и сохрани тесты, чтобы я мог запускать их повторно

Для проверки записи данных задай разрешённый объём, например:

Проверь форму заказа через Playwright: .
Разрешаю создать до двух записей за всю задачу, включая повторные попытки.
Проверь обязательные поля, сохранение и сумму после повторного открытия.
Оставь данные для просмотра. Сохрани тесты; повтор должен проверить эти же
записи без создания новых.

Агент использует существующую настройку Playwright или создаёт отдельный e2e/ в проекте приложения. Исходники приложения, готовые тесты и сессия для старта не обязательны: достаточно URL и описания проверки. Если локального проекта нет, агент выберет постоянный каталог для тестов. При необходимости он подготовит Playwright, откроет браузер для вашего входа и проверит сохранённую сессию. Пароли вводятся в браузере; содержимое сессии не нужно в чате.

Состав проверок определяется вашей задачей. Формы, поля, роли и бизнес-формулы агент уточняет по текущему приложению; примеры не задают обязательного сценария. CRUD, обязательность полей и вычисления проверяются, только если входят в задачу.

Результат — обычные TypeScript-тесты @playwright/test, отчёт о проверках и команда повторения из каталога тестов. В сценариях с созданием и сохранением тестовых данных первое создание выполняется в prepare, обычный повтор — в verify: он читает прежние записи. Файл .test-data/.json хранит их маркеры, ID и общий лимит между попытками. Если нужна очистка, укажи это в задаче; удаляются только точные собственные записи. Для новых сценариев агент дополнит тесты по фактическому интерфейсу.

Для следующей проверки достаточно попросить:

Повтори сохранённую проверку заказа через Playwright. Используй оставленные
записи, новых не создавай.

Структура проекта 1С:Элемент

Скиллы ориентируются на стандартную структуру проекта:

/
    /
        /
            Проект.yaml
            Проект.xbsl     # обработчики НастройкаПриложения / ОбновлениеПроекта
            /
                Подсистема.yaml
                СтатусЗадачи.yaml     # объект метаданных
                СтатусЗадачи.xbsl     # методы объекта (опционально)

Конфигурация xbsl-deploy

Создай файл .env в корне проекта:

# Обязательные
ELEMENT_BASE_URL=https://...
ELEMENT_CLIENT_ID=...
ELEMENT_CLIENT_SECRET=...

# Опциональные (экономят время на каждом деплое)
ELEMENT_APP_ID=...
ELEMENT_PROJECT_ID=...
ELEMENT_BRANCH=main
ELEMENT_SPACE_ID=...

Разработка

# Установить зависимости
pip install -r requirements-dev.txt

# Запустить все тесты
pytest

# Тесты одного скилла
pytest tests/skills/xbsl_deploy/
pytest tests/skills/xbsl_explore/
pytest tests/skills/xbsl_form_info/
pytest tests/skills/xbsl_form_add/
pytest tests/skills/xbsl_pattern_register/

# Покрытие кода
coverage run -m pytest && coverage report

GitHub Pages

Сайт собирается автоматически через GitHub Actions из README.md и файлов skills/*/SKILL.md.

Локальная сборка:

pip install -r requirements-site.txt
{python} scripts/build_site.py

Добавление новых скиллов

Каждый скилл — папка в skills/ с файлом SKILL.md. Frontmatter:

---
name: имя-скилла
description: >
  Описание для триггера скилла (по нему агент решает, когда вызывать)
---

Для создания и улучшения скиллов рекомендуется использовать skill-creator, а также руководствоваться рекомендациями agentskills.io.

Лицензия

MIT