bsl-ai-toolkit

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

Скилл

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Правит метаданные и код конфигурации с применением в тестовую базу
  • Ходит к данным информационной базы и эксплуатационным системам
  • Использует ssh, scp и учетные данные через переменные окружения
Все причины и проверки
Российский стек

vgtitov/bsl-ai-toolkit

Установка

В терминале, через 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.

Понадобится: Node.js

Сверено с репозиторием 26 сент. 2026, коммит 8160cc1.

Текст для агента

Клонируй репозиторий и запусти онбординг: 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, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.Звезды репозитория
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.Звезды репозитория
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.Звезды репозитория

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.Звезды репозитория
Foxx AIbsl-ai-toolkit

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.