bitrix-framework-skills

Bitrix Framework Skills: скиллы для ИИ-агентов на 1С-Битрикс D7 и Битрикс24

Скиллы для Claude Code, Cursor и Codex, чтобы ИИ писал код на 1С-Битрикс по канону D7, а не legacy. 50 скиллов: ORM, контроллеры, кеш, безопасность, инфоблоки, компоненты, интернет-магазин и Битрикс24 (CRM, задачи, REST, MCP). Ставятся одной командой в любой проект.

Зачем: нейросеть пишет на Битриксе по-старому

Без подсказок нейросеть пишет для Битрикса старым API: CIBlockElement::GetList, $DB->Query со склейкой SQL, глобальные $USER и $APPLICATION, код вне /local/. Такой код работает, но его трудно поддерживать, а безопасность и кеш остаются на совести разработчика. Скиллы дают агенту канон D7: ORM, контроллеры, сервисы через DI, проверки CSRF и прав, тегированный кеш. Агент открывает нужный скилл сам, когда задача его касается.

Это не официальная документация Битрикса, а правила, как писать код в /local/. Документация по продукту — на docs.1c-bitrix.ru («1С-Битрикс: Управление сайтом») и apidocs.bitrix24.ru (REST Битрикс24).

Установка в Claude Code, Cursor и Codex

npx skills add bxmaximum/bitrix-framework-skills --skill '*'

Запустите в корне проекта. CLI skills спросит, в какие агенты ставить. Скиллы попадут в .agents/skills/ (для Claude Code — ещё и в .claude/skills/).

Другие способы

Без вопросов, сразу в нужные агенты (Cursor, Codex и другие читают общую папку .agents/skills/):

npx skills add bxmaximum/bitrix-framework-skills --skill '*' -a claude-code cursor -y

Попросить агента:

Добавь в проект скиллы из репозитория https://github.com/bxmaximum/bitrix-framework-skills

Только нужные скиллы или список без установки:

npx skills add bxmaximum/bitrix-framework-skills --skill bitrix-orm bitrix-controllers
npx skills add bxmaximum/bitrix-framework-skills --list   # список без установки

Обновление:

npx skills update

Флаг --all не советуем: это --skill '*' --agent '*' -y, скиллы ставятся сразу во все ~60 поддерживаемых агентов, и в проекте появляются десятки папок вроде .windsurf/, .roo/.

AGENTS.md

Общие правила — /local/, D7, границы DI, безопасность, политика версий — лежат в скилле bitrix-framework. Он ставится вместе с остальными, поэтому отдельный системный промпт не обязателен.

AGENTS.md — короткий системный промпт: язык ответов, порядок работы и индекс скиллов. Его можно скопировать в корень проекта или подключить как rule в Cursor.

Пример: выборка из инфоблока без скиллов и со скиллами

Задача: 10 активных новостей автора «Иван Петров».

Без скиллов агент часто пишет так:

CModule::IncludeModule('iblock');

$res = CIBlockElement::GetList(
    ['SORT' => 'ASC'],
    ['IBLOCK_ID' => 5, 'ACTIVE' => 'Y', 'PROPERTY_AUTHOR' => 'Иван Петров'],
    false,
    ['nTopCount' => 10],
    ['ID', 'NAME', 'PREVIEW_TEXT', 'PROPERTY_AUTHOR']
);
while ($row = $res->GetNext()) {
    $items[] = $row;
}

Это работает, но ID инфоблока зашит в код и на другом стенде будет другим. Свойства идут через PROPERTY_*, результат — массивы без типов.

Со скиллом bitrix-iblocks агент берёт ORM D7:

use Bitrix\Iblock\Elements\ElementNewsTable;
use Bitrix\Main\Loader;

Loader::includeModule('iblock');

$news = ElementNewsTable::query()
    ->setSelect(['ID', 'NAME', 'PREVIEW_TEXT', 'AUTHOR'])
    ->where('ACTIVE', 'Y')
    ->where('AUTHOR.VALUE', 'Иван Петров')
    ->setOrder(['SORT' => 'ASC'])
    ->setLimit(10)
    ->setCacheTtl(3600)
    ->cacheJoins(true)
    ->fetchCollection();

• Класс ElementNewsTable ядро создаёт само для инфоблока с API_CODE = News. Инфоблок находится по коду, без ID.
• Свойство AUTHOR — поле ORM: его можно выбрать и отфильтровать (AUTHOR.VALUE).
• Кеш запроса включён вместе с JOIN свойств.
• Результат — коллекция объектов: $item->getName(), $item->getAuthor()?->getValue().

Скилл заодно предупреждает: ORM не проверяет права на инфоблок и даты активности, это нужно сделать отдельно. Пример взят из skills/bitrix-iblocks/rules/. Оба фрагмента проходят php -l и tools/verify-skills.php на main 26.800.0.

Каталог скиллов

Каждый скилл — skills/<name>/SKILL.md. Большие скиллы разбиты на темы в rules/*.md: агент читает только нужный файл, поэтому 50 скиллов не забивают контекст.

Битрикс24:

MCP для Битрикс24: документация REST в агенте

Для работы с REST Битрикс24 подключите официальный MCP-сервер документации: он ищет методы, поля и события в актуальной документации REST. Доступа к данным портала у него нет, авторизация не нужна.

claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.com/mcp

Настройка для Cursor, Codex и других клиентов — в скилле bitrix24-ai-tools.

Как проверяются скиллы

Скиллы сверены с ядром коробки Битрикс24 main 26.800.0. Каждый PHP-пример проходит php -l, а классы, методы, константы и именованные аргументы проверяются по исходникам ядра скриптом tools/verify-skills.php. Скрипт не видит неверного поведения, поэтому рискованные утверждения в изменённых скиллах перепроверяются по коду ядра вручную.

Базовые паттерны рассчитаны на main 23.0+. Всё, что новее, помечено Since с вариантом для старого ядра.

Какая нейросеть лучше пишет код на 1С-Битрикс

Bitrix AI Challenge — бенчмарк BXMax. Связки «приложение + модель + скиллы» (Claude Code, Codex, Cursor и другие) делают один и тот же реальный заказ веб-студии на живом стенде 1С-Битрикс: лендинг с онлайн-записью, инфоблоками и модулем записи. Результат оценивают модель-ревьювер и автор по одной рубрике.

Все участники получают на стенде одни и те же скиллы из этого репозитория, коммит записан в run.yaml каждого прогона: с октября 2026 — релиз 2026-10.

Вклад скиллов отдельно не измеряется: бенчмарк оценивает связку целиком. Методология и код прогонов — в bxmaximum/bitrix_ai_challenge.

Обновления и участие

Скиллы обновляются раз в месяц: после релиза документации, по разборам обновлений ядра и по issue сообщества. Что изменилось — в CHANGELOG.md. Как устроен скилл, как его проверить и как прислать правку — в CONTRIBUTING.md.

php tools/verify-skills.php --kernel=/path/to/bitrix/modules

Связанные проекты

• bxmaximum/bitrix_ai_challenge — исследование AI-моделей на Bitrix; публикации на bxmax.ru/bitrix-ai.
• bitrix-tools/best-practice — operational best practices от команды Bitrix Tools.

BXMax

Скиллы поддерживает BXMax — сообщество разработчиков 1С-Битрикс. Мы разбираем ядро и проверяем ИИ-агентов на реальных задачах, по этим задачам и собираем скиллы.

Ссылки: bxmax.ru · Telegram · Bitrix × AI · GitHub

Лицензия

MIT