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…
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.