bsl-ai-toolkit
Набор скиллов, правил и MCP-серверов для разработки на 1С:Предприятие 8.3: агент работает по реальному коду и справке, а не по памяти
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Правит метаданные и код конфигурации с применением в тестовую базу
- Ходит к данным информационной базы и эксплуатационным системам
- Использует ssh, scp и учетные данные через переменные окружения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bsl-ai-toolkitОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Клонируй репозиторий и запусти онбординг: git clone https://github.com/vgtitov/bsl-ai-toolkit, затем sh onboard/onboard.sh. Заполни пути к коду 1С, платформе и инструментам в переменных окружения по .env.example, после чего работай через сгенерированные правила и MCP-конфиг.
Другие способы из описания автора
git clone https://github.com/vgtitov/bsl-ai-toolkit
cd bsl-ai-toolkit
sh onboard/onboard.shИдемпотентный онбординг. На Windows используйте onboard/onboard.ps1. Пути и учетные данные задаются в переменных окружения по .env.example.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Переиспользуемый контур для разработки на 1С:Предприятие 8.3 на языке BSL: правила, восемь скиллов по ролям, MCP-серверы и детерминированный движок правки метаданных. Единое ядро в каталоге core общее для разных агентов, а тонкие адаптеры подключают Claude Code, Cursor, Copilot, Gemini CLI, Codex, Cline и Windsurf. MCP-серверы дают поиск по реальному коду конфигурации и расширения, диагностики BSL Language Server после правки, чтение эксплуатационных данных и доступ к данным базы только на чтение. Движок правит формы, СКД и реквизиты в формате Конфигуратора и EDT с проверкой обратной загрузкой, чтобы модель не выдумывала методы и структуру.
Для кого. Для разработчиков и команд на 1С, которым нужна проверяемая AI-разработка по реальному коду, а не по догадкам модели.
Подходит, если
- Пишете или ревьюите код BSL и хотите сверки по реальному коду через MCP
- Нужно править формы, СКД или реквизиты без ручной ломки формата
- Ведете разработку на 1С сразу под несколько агентов и ОС
Не подходит, если
- Задача не про 1С:Предприятие и язык BSL
- Нет доступа к коду конфигурации, платформе или тестовой базе, на которые опирается контур
Пример запроса к агенту
Добавь реквизит в документ через движок метаданных и проверь диагностики BSL после правкиОграничения
Движок метаданных на чистом Python, но для полной пользы нужны локальные клоны кода конфигурации и расширения, платформа 1С и тестовая база, а слой применения правок использует ssh, scp и tar или локальный раннер. Часть MCP-серверов требует внешних инструментов: BSL Language Server, JDK, при желании Zabbix или Prometheus. Пути и учетные данные задаются через переменные окружения. Секреты и персональные данные в модель не передаются, данные базы читаются только на чтение с обезличиванием.
Как отключить. Уберите сгенерированные файлы контура из проекта: CLAUDE.md, AGENTS.md, GEMINI.md, .mcp.json и каталог .claude, и удалите клон репозитория.
Проверка безопасности
- Правит метаданные и код конфигурации с применением в тестовую базу
- Ходит к данным информационной базы и эксплуатационным системам
- Использует ssh, scp и учетные данные через переменные окружения
Коротко о README
README представляет bsl-ai-toolkit как переиспользуемый контур AI-разработки на 1С:Предприятие 8.3: правила, восемь скиллов, MCP-серверы и движок правки метаданных. Идея в проверяемости через инструменты: поиск по реальному коду onec-code, диагностики bsl-ls после правки, детерминированный движок onec_metadata с обратной загрузкой, эксплуатация onec-ops и доступ к данным onec-data только на чтение. Ядро в каталоге core общее для всех агентов, тонкие адаптеры подключают конкретные хосты, сборка идет через build.sh, онбординг через onboard. Заявлена кросс-платформенность и работа под ограниченный доступ к моделям.
SKILL.md
--- name: 1c-dev description: > Разработка и код-ревью на 1С:Предприятие 8.3 (BSL) с проверкой по РЕАЛЬНОМУ коду через MCP, а не по памяти. Используй всякий раз, когда пишешь, правишь или ревьюишь BSL-код, работаешь с общими модулями, формами, запросами, СКД, регистрами, ролями; реализуешь задачу по ЧТЗ/тех-проекту; ищешь, как устроена типовая конфигурация или что уже есть в расширении. Железное правило: НЕ выдумывай поведение 1С и сигнатуры — проверяй по реальному коду через MCP и справку платформы, после правки прогоняй BSL Language Server. Анализ/архитектура — скилл 1c-analyst. --- # Разработка 1С (BSL) — писать корректный и производительный код по реальному коду ## Главное правило: спроси инструмент, не угадывай Нейросеть врёт в деталях 1С. Источник истины — реальный код и официальная справка.
Частые вопросы
Привязан ли контур к одному агенту?
Нет. Ядро в каталоге core общее, а адаптеры подключают Claude Code, Cursor, Copilot, Gemini CLI, Codex, Cline и Windsurf. Claude Code это эталонная реализация.
Что дает byte-perfect правка метаданных?
Изменения форм, СКД и реквизитов идут детерминированно и проверяются обратной загрузкой в тестовую базу, поэтому дифф выходит ровно целевым, а верстка не ломается.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything