XBSL: тулкит для 1С:Элемент
XBSL
Линтер с автофиксами, LSP, поиск по документации платформы и метаданные-скаффолдинг для 1С:Элемент, плюс MCP-сервер и расширение VS Code на одном движке
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Команда --fix и операции скаффолдинга напрямую переписывают yaml и xbsl файлы проекта
- Приватные плагины через entry points могут добавлять сторонний код в движок линтера
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/xbslОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Установите утилиту
pipx install xbslБез pipx подойдет pip install xbsl.
Установи пакет командой pip install xbsl, сгенерируй данные языка командой xbsl extract --dist "путь к дистрибутиву 1С:Элемент", затем подключи MCP-сервер командой claude mcp add xbsl -- xbsl-mcp.
Другие способы из описания автора
pip install xbslУстановка пакета из PyPI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
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-клиента.
Проверка безопасности
- Команда --fix и операции скаффолдинга напрямую переписывают yaml и xbsl файлы проекта
- Приватные плагины через entry points могут добавлять сторонний код в движок линтера
Коротко о README
README объясняет проблему отсутствия тулинга у 1С:Элемент вне платформы и архитектуру одного движка с четырьмя поверхностями (CLI, LSP, MCP, веб). Описывает быстрый старт из трех шагов включая обязательную генерацию данных языка из своего дистрибутива, набор из 250 правил в четырех уровнях, автофиксы и baseline, метаданные-скаффолдинг с 33 видами элементов и примерами команд, расширение VS Code на LSP-сервере, 51 встроенный шаблон кода, поиск по документации через локальный docs.sqlite, MCP-сервер с инструментами линтинга и meta_* операций, локальный веб-интерфейс, интеграцию CI и механизм расширения через entry points для приватных плагинов. Лицензия MIT.
Частые вопросы
Данные для линтера идут вместе с пакетом?
Нет, README прямо говорит, что ничего из этого не входит в репозиторий, все данные генерируются из собственного дистрибутива платформы командой xbsl extract.
MCP-сервер умеет создавать объекты, а не только проверять код?
Да, все операции скаффолдинга доступны через MCP как meta_* инструменты, агент может создать объект и сразу получить линт написанных файлов в одном вызове.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything