XBSL: тулкит для 1С:Элемент

XBSL

Линтер с автофиксами, LSP, поиск по документации платформы и метаданные-скаффолдинг для 1С:Элемент, плюс MCP-сервер и расширение VS Code на одном движке

  • 3 ★ репозитория
  • Последний коммит
  • MIT
CLI

Расширенный доступ

Почему такой уровень

  • Команда --fix и операции скаффолдинга напрямую переписывают yaml и xbsl файлы проекта
  • Приватные плагины через entry points могут добавлять сторонний код в движок линтера
Все причины и проверки
Российский стек

keyfire/xbsl

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/xbsl

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Команда --fix и операции скаффолдинга напрямую переписывают yaml и xbsl файлы проекта
  • Приватные плагины через entry points могут добавлять сторонний код в движок линтера

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

Что делает

XBSL закрывает разрыв в том, что у 1С:Элемент нет инструментов вне самой платформы, а единственная проверка кода это медленная серверная компиляция при деплое. Движок читает пары файлов Имя.yaml и Имя.xbsl и отвечает сразу на своей машине: 250 правил в четырех уровнях от структуры и yaml-схемы до семантики по данным платформы и проекта, автофиксы через --fix, baseline для принятия правила на старом коде без немедленной чистки всего. Метаданные-скаффолдинг создает объекты, реквизиты, маршруты и формы без ручного yaml: 33 вида элементов, генерация форм с реальным содержимым, контекстное переименование объекта. Один и тот же движок отдается через четыре поверхности: CLI, LSP-сервер для редакторов, MCP-сервер для AI-агентов и локальный веб-интерфейс, а данные языка платформы генерируются из собственного дистрибутива пользователя, а не поставляются в репозитории.

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

Подходит, если

  • Нужна проверка кода 1С:Элемент прямо на своей машине, без ожидания деплоя и серверной компиляции
  • Нужно быстро создать объект, реквизит или форму без ручного написания yaml
  • Нужен MCP-сервер, который дает агенту линтинг, поиск по документации и операции скаффолдинга в одном раунд-трипе

Не подходит, если

  • Проект не на 1С:Элемент: правила и метамодель предметно привязаны к этой платформе
  • Нет доступа к собственному дистрибутиву 1С:Элемент: данные языка (ключевые слова, типы, метамодель) генерируются только из него и не входят в репозиторий
  • Нужна проверка без установки Python-пакета: альтернативных бинарных сборок README не описывает, кроме нативных mypyc wheels

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

Создай новый справочник Товары в проекте vendor/App/Main и добавь ему реквизит Цвет строкового типа

Ограничения

Данные языка платформы (ключевые слова, каталог типов stdlib, метамодель конфигурации, термины, индекс документации, схема компонентов) не входят в репозиторий и генерируются командой xbsl extract из собственного дистрибутива 1С:Элемент пользователя. Проект независим и не аффилирован с 1С, названия 1С:Элемент и 1С:Fresh это товарные знаки правообладателей. До версии 0.16 проект назывался xbsl-lint с пакетом xbsllint, старые команды и импорты сохранены как алиасы. Приватный плагин может добавлять правила и данные языка через entry points, что расширяет поверхность стороннего кода, если такой плагин установлен.

Как отключить. Удалите пакет командой pip uninstall xbsl, отключите расширение VS Code и удалите блок xbsl из конфигурации MCP-клиента.

Частые вопросы

Данные для линтера идут вместе с пакетом?

Нет, README прямо говорит, что ничего из этого не входит в репозиторий, все данные генерируются из собственного дистрибутива платформы командой xbsl extract.

MCP-сервер умеет создавать объекты, а не только проверять код?

Да, все операции скаффолдинга доступны через MCP как meta_* инструменты, агент может создать объект и сразу получить линт написанных файлов в одном вызове.

Чем XBSL отличается от проверки кода 1С:Элемент через серверную компиляцию?

У 1С:Элемент нет инструментов вне платформы, а единственная проверка кода это медленная серверная компиляция при деплое. XBSL дает линтер с автофиксами, LSP, поиск по документации платформы, скаффолдинг метаданных, MCP-сервер и расширение VS Code на одном движке.

Что входит в пакет XBSL и умеет ли MCP-сервер создавать объекты?

Установка: pip install xbsl, данные для линтера идут в пакете. MCP-сервер работает с Claude Code, а расширение с VS Code. Возможности создания объектов описаны в README, это скаффолдинг метаданных.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

CLI-линтер и форматтер BSL со 180 диагностиками, LSP-сервером для VS Code и Cursor и MCP-инструментами для локальных ИИ-ассистентов

CLIРасширенный доступ13Звезды репозитория
Российский стек

20 скиллов для проектов на 1С:Элемент: создание объектов конфигурации, форм, прав доступа, деплой и проверка через Playwright

СкиллРасширенный доступ45Звезды репозитория
Российский стек

Language Server для BSL на Rust с диагностиками кода, инкрементальным анализом и встроенным MCP-сервером для ИИ-агентов

MCP-серверРасширенный доступ117Звезды репозитория
Российский стек

Скилл Claude Code для деплоя проекта 1С:Элемент (xBSL) на английском языке разработки в облако через Console API

СкиллРасширенный доступ
Российский стек

MCP-сервер со справочником платформы 1С и проверкой BSL-кода на соответствие реальному API нужной версии платформы

MCP-серверРасширенный доступ33Звезды репозитория
Российский стек

Набор скиллов, правил и MCP-серверов для разработки на 1С:Предприятие 8.3: агент работает по реальному коду и справке, а не по памяти

СкиллШирокий доступ35Звезды репозитория

Коротко о README

README объясняет проблему отсутствия тулинга у 1С:Элемент вне платформы и архитектуру одного движка с четырьмя поверхностями (CLI, LSP, MCP, веб). Описывает быстрый старт из трех шагов включая обязательную генерацию данных языка из своего дистрибутива, набор из 250 правил в четырех уровнях, автофиксы и baseline, метаданные-скаффолдинг с 33 видами элементов и примерами команд, расширение VS Code на LSP-сервере, 51 встроенный шаблон кода, поиск по документации через локальный docs.sqlite, MCP-сервер с инструментами линтинга и meta_* операций, локальный веб-интерфейс, интеграцию CI и механизм расширения через entry points для приватных плагинов. Лицензия MIT.

Бейдж для README

Сообщить о проблеме