AI-контур разработки для 1С-Битрикс

bitrix-ai-toolkit

Набор правил, скиллов, линтеров и MCP-профиля для AI-разработки на 1С-Битрикс: Управление сайтом, с единым ядром под Claude Code, Codex и Gemini CLI

  • 3 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Расширенный доступ

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

  • Хуки автоматически запускают линтеры и правки после каждого изменения файла агентом
  • Скрипты init_project.py и install_git_hooks.py меняют настройки git и конфигурацию проекта
Все причины и проверки
Российский стек

vgtitov/bitrix-ai-toolkit

Установка

Сервисы

Ручная установка

git clone https://github.com/vgtitov/bitrix-ai-toolkit && cd bitrix-ai-toolkit
sh onboard/install.sh

Ставит линтеры, git-хуки, копирует скиллы в ~/.claude/skills и собирает конфиги.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Хуки автоматически запускают линтеры и правки после каждого изменения файла агентом
  • Скрипты init_project.py и install_git_hooks.py меняют настройки git и конфигурацию проекта

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Toolkit решает проблему у Битрикса нет официальных IDE-стабов и публичного репозитория ядра: правки проверяются по реальному коду ядра из vendor (bitrix-toolkit/bitrix-ci) и стабам bxApiDocs, а не по памяти модели. Единый источник истины в core собирает правила AGENTS.md, пять скиллов (разработка, аналитик, производительность, администрирование, тестировщик), конфиги линтеров PHPStan, PHP-CS-Fixer, ast-grep, Rector и MCP-профиль с bitrix24/mcp-rest-doc и Serena. Скрипт build.sh генерирует из core конфиги под конкретного агента: CLAUDE.md с хуками PostToolUse для Claude Code, AGENTS.md для Codex и Gemini CLI, .rulesync для Cursor, Copilot и Cline. Основной принцип, зашитый в правила: различать процедурное и D7 ядро Битрикса, писать только в /local, структуру инфоблоков вести миграциями sprint.migration, а не руками в БД.

Для кого. Для разработчиков 1С-Битрикс: Управление сайтом, которые хотят, чтобы агент писал production-ready код по реальному ядру, а не угадывал API по памяти.

Подходит, если

  • Нужно, чтобы агент писал код Битрикса по реальным сигнатурам ядра, а не по устаревшей памяти модели
  • Нужны единые правила и скиллы сразу для нескольких агентов: Claude Code, Codex, Gemini CLI
  • Нужен автоматический прогон PHPStan и PHP-CS-Fixer после каждой правки кода агентом

Не подходит, если

  • Проект не на 1С-Битрикс: Управление сайтом, правила и стабы предметно привязаны к этой CMS
  • Нет возможности подключить vendor-репозиторий с реальным кодом ядра bitrix-ci: без него теряется основной смысл инструмента
  • Нужна интеграция с агентом за пределами Claude Code, Codex, Gemini CLI, Cursor, Copilot, Cline: Windsurf и Aider README называет ручными и не из коробки

Пример запроса к агенту

Добавь в модуль /local новый обработчик события каталога по стандартам D7, проверь его PHPStan и стилем перед коммитом

Ограничения

Claude Code заявлен как эталонная реализация, остальные агенты подключаются минимальной адаптацией из общего ядра, полнота хуков и MCP может отличаться. После обновления toolkit одного git pull недостаточно, нужно повторно выполнить sh onboard/install.sh --no-tools, иначе изменения hooks, скиллов и сгенерированных конфигов не применятся. Правило /local-only полагается на дисциплину: правки в ядро /bitrix/modules технически возможны, но перезаписываются при обновлении Битрикса. Инструмент независим и не аффилирован с 1С-Битрикс, товарный знак принадлежит правообладателю.

Как отключить. Удалите сгенерированные CLAUDE.md, AGENTS.md, .mcp.json и .claude из проекта, отключите git-хуки командой из scripts/install_git_hooks.py и удалите скиллы из ~/.claude/skills.

Частые вопросы

Toolkit работает только с Claude Code?

Нет, из коробки build.sh собирает конфиги для Claude Code, Codex и Gemini CLI, а Cursor, Copilot и Cline подключаются через rulesync.

Можно ли агенту редактировать код ядра Битрикса напрямую?

Правило гейта требует писать только в /local, ядро /bitrix/modules считается read-only и перезаписывается при обновлении платформы.

Обсуждение

Вопросов и отзывов пока нет.

Официальный

Скиллы-маршрутизаторы с операционными правилами кода для 1С-Битрикс и Битрикс24: контроллеры, ORM, кеш, роутинг

СкиллМинимальный доступ27Звезды репозитория
Российский стек

Справочник по API вашей установки 1С-Битрикс для агента: индекс ядра с версиями модулей, чтобы он не путал методы разных версий

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

39 скиллов по ядру Bitrix Framework D7: ORM, контроллеры, кеш, REST, безопасность, миграции и другие темы разработки

СкиллМинимальный доступ58Звезды репозитория
Российский стек

Модуль 1С-Битрикс с MCP-сервером: агент видит окружение сайта, ищет функции ядра и может выполнять PHP, shell и SQL на сервере

MCP-серверШирокий доступ26Звезды репозитория
Российский стек

Локальный MCP-индексатор проекта на 1С-Битрикс без токена: символы, события, ORM, граф зависимостей и опциональный доступ к БД

MCP-серверШирокий доступ2Звезды репозитория
Российский стек

Модуль 1С-Битрикс, который поднимает MCP-сервер внутри проекта: инфоблоки, HL-блоки, роуты, агенты и консольные команды для AI-разработки

MCP-серверРасширенный доступ6Звезды репозитория

Коротко о README

README объясняет нишу проекта: у Битрикса нет официальных стабов и публичного ядра, поэтому рычаг это реальный код в vendor плюс локальный поиск и детерминированные хуки линтеров. Описывает состав репозитория (core, adapters, build.sh, scripts, onboard, tests, demo, docs), ключевые методологические принципы (спрашивай инструмент, два ядра, гейт /local, reuse-first), три канала интеграции с агентом (hooks, LSP, MCP), таблицу поддерживаемых агентов и стек бесплатных open-source инструментов статанализа и рефакторинга. Дает установку через onboard/install.sh и предупреждение, что после обновления нужен повторный запуск установки. Лицензия MIT, происхождение по образцу bsl-ai-toolkit.

Бейдж для README

Сообщить о проблеме