Bsl Ai Toolkit

AI agent toolkit for 1C:Enterprise 8.3 (BSL): rules, skills and MCP servers so the agent works from your real code, plus byte-perfect metadata editing verified…

LLM Mart 3 views 162 listing impressions

AI agent toolkit for 1C:Enterprise 8.3 (BSL) development. MIT. Documentation is in Russian.

Набор правил, скиллов и MCP-серверов для разработки на 1С:Предприятие 8.3 (BSL) с ИИ-агентом. Агент ищет по коду вашей конфигурации и расширений, получает диагностики BSL Language Server после каждой правки и меняет метаданные (формы, СКД, реквизиты) детерминированным движком с проверкой в тестовой базе. Эталонная реализация — Claude Code; Cursor, Copilot, Gemini CLI, Codex, Cline, Windsurf и Aider подключаются адаптерами из общего ядра. Лицензия MIT, привязки к конкретной организации нет.

Быстрый старт

git clone https://github.com/vgtitov/bsl-ai-toolkit && cd bsl-ai-toolkit
bash onboard/onboard.sh          # macOS/Linux; исходники 1С — из ONEC_SRC_DIR или --srcdir <путь>
git clone https://github.com/vgtitov/bsl-ai-toolkit ; cd bsl-ai-toolkit
.\onboard\onboard.ps1            # Windows; исходники 1С — из ONEC_SRC_DIR или -SrcDir <путь>

Понадобится: git, uv, java, rg, Claude Code (или другой агент — sh build.sh <agent>, на Windows build.ps1, см. adapters/README.md) и выгрузка вашей конфигурации в файлы (EDT или Конфигуратор-XML). onboard сам проверит пререквизиты, разложит скиллы, профиль .mcp.json и правила, задаст env, поставит git-хуки и сделает самотест. Дальше перезапусти агента и подтверди MCP-серверы; здоровье окружения — python scripts/doctor.py.

Безопасность. Правки метаданных проверяются только в ТЕСТ-базе. Доступ к данным живой базы (onec-data) — read-only под исследуемым пользователем, с маскированием ПДн. Пути и креды — через переменные окружения: не в репозиторий и не в чат с агентом. Подробнее — SECURITY.md.

Пусть настроит сам агент. Можно не настраивать руками — дай ИИ-агенту готовый промпт из docs/AGENT_SETUP.md, и он развернёт окружение сам (человеку — только склонировать свои 1С-исходники, ввести секреты и опубликовать тест-базу).

  • Установка инструментов ИИ (гайд + грабли) — docs/AI_INSTALL_GUIDE.md.
  • Клон сделан до 05.10.2026? История репозитория переписана — см. UPDATING.md.
  • Версионирование и обновление — docs/AI_UPDATE.md (ядро пинится semver-тегом; ИИ обновляется сам).
  • Здоровье окружения — python scripts/doctor.py (пререквизиты + MCP из .mcp.json + доступы).

Три оси переносимости: AGENTS.md (правила) + SKILL.md (навыки) + MCP (инструменты); остальные агенты подключаются минимальной адаптацией из общего ядра (core/) — см. adapters/. Не 1С-Битрикс (это CMS на PHP — отдельный toolkit).

Идея

Вся RU-сцена AI-разработки 1С («вайб-кодинг», агенты в EDT/Cursor) упирается в одно: модель галлюцинирует детали 1С — выдумывает методы, путает фасады (менеджер/объект/выборка), не знает состав типовой и режим совместимости; а формы/СКД/ метаданные считаются «последним рубежом» генерации и обходятся вручную. Рычаг toolkit — проверяемость через инструменты:

  • onec-code — поиск по реальному коду конфигурации и расширения (оба слоя контура), а не по памяти;
  • bsl-ls — диагностики BSL Language Server после каждой правки;
  • onec_metadata — детерминированная byte-perfect правка метаданных (Конфигуратор-XML + EDT .mdo/.dcs) с round-trip verify (загрузка в ТЕСТ-базу платформой + повторная выгрузка = ровно целевой дифф). Это закрывает тот самый «последний рубеж», который остальные обходят;
  • onec-ops — эксплуатация и производительность (ТЖ, план запроса, APDEX, Zabbix/Prometheus): agentic SWE, а не только кодинг;
  • onec-data — доступ к данным живой ИБ read-only под исследуемым пользователем (честный RLS, маскирование ПДн).

From the project's README.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

29 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views

Portable, vendor-neutral home for agent skills, MCP servers, personas, and memory.

28 views