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

Установка

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

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

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

Что делает

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 по памяти.

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

Добавь в модуль /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.

Проверка безопасности

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

Коротко о 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.

Похожие