1c-bitrix-cms

name	1c-bitrix-cms
description	Создание и доработка сайтов на «1С-Битрикс: Управление сайтом» (корпоративные сайты и интернет-магазины, ядро 26.x) — инфоблоки, компоненты, шаблоны, SEO, магазин, установка/миграции/бэкап, обновления, безопасность, качество. Используй, когда пользователь работает с сайтом на 1С-Битрикс / Bitrix (не с порталом Битрикс24).

1c-bitrix-cms — оркестратор

Точка входа для работы с сайтами на «1С-Битрикс: Управление сайтом». Определи среду, объяви гейты, направь к нужному под-скиллу и подгрузи только релевантный срез базы знаний.

Знания актуальны для ядра 26.x (выверено на 26.150.0); на более новых ядрах перепроверяйте версионно-зависимые факты.

Карта решений

Общий поток: отсеки чужую платформу → определи среду → держи гейты → маршрутизируй по намерению → подгрузи только нужный срез базы знаний.

digraph orchestrator {
    "Запрос: сайт на 1С-Битрикс" [shape=doublecircle];
    "Битрикс24 / иная платформа?" [shape=diamond];
    "Вне зоны: направь в админку/мастер" [shape=box];
    "Определи среду (детектор, без угадывания)" [shape=box];
    "Гейты: /local · ядро не трогать · check-conventions" [shape=box];
    "Намерение → под-скилл" [shape=diamond];
    "setup · settings · template · content · seo · commerce · security · quality · update · rest" [shape=box];
    "Подгрузи срез KB под задачу" [shape=box];

    "Запрос: сайт на 1С-Битрикс" -> "Битрикс24 / иная платформа?";
    "Битрикс24 / иная платформа?" -> "Вне зоны: направь в админку/мастер" [label="да"];
    "Битрикс24 / иная платформа?" -> "Определи среду (детектор, без угадывания)" [label="нет"];
    "Определи среду (детектор, без угадывания)" -> "Гейты: /local · ядро не трогать · check-conventions";
    "Гейты: /local · ядро не трогать · check-conventions" -> "Намерение → под-скилл";
    "Намерение → под-скилл" -> "setup · settings · template · content · seo · commerce · security · quality · update · rest";
    "setup · settings · template · content · seo · commerce · security · quality · update · rest" -> "Подгрузи срез KB под задачу";
}

Детали каждого шага — в разделах ниже.

1. Определи среду (по сигналам, без угадывания)

• «живой Битрикс» — в корне есть bitrix/ и bitrix/.settings.php, доступен php, есть коннект к БД → можно выполнять код и проверять результат.
• «только файлы» — есть проект//local (или пустая папка), БД недоступна → создавай корректные файлы и давай инструкцию запуска (агент/CLI/админка).
• «удалённый» — даны доступы FTP/SSH/REST → работай через них.
• «чистый старт» — Битрикса нет вовсе → начни с под-скилла 1c-bitrix-cms-setup.
• Конфликт сигналов (например, bitrix/ есть, но БД недоступна) — задай один уточняющий вопрос. Дефолт при отказе — «только файлы».

Для детерминированной картины окружения можно запустить ../../shared/scripts/detect-bitrix.sh [корень_проекта] — read-only детектор, отдающий JSON (mode, core_present, core_version, local_present, settings_location, php_available, encoding, d7_available, install_finalized). Это ground-truth для шага «определи среду»; решение всё равно за тобой, детектор лишь снимает угадывание.

2. Гейты-инварианты (держи всегда)

• Не изменять ядро (/bitrix/modules, /bitrix/components/bitrix). Весь свой код — в /local.
• Применять правила безопасности (см. ../../shared/kb/conventions.md).
• Перед сдачей — прогон проверок: ../../shared/scripts/check-conventions.sh <каталог_проекта>. Выход 0 сам по себе НЕ означает готовность к сдаче: эвристики безопасности дают только [REVIEW], и «OK» не значит «безопасно». Каждый пункт [REVIEW] нужно явно разобрать — устранить или обоснованно отклонить — до сдачи.
• Не использовать сторонние сборки/зеркала ядра.
• Право исполнять: чтение/диагностика — везде; обратимая запись — в /local под git; необратимое/привилегированное (обновления, восстановление, откат) — не на проде по умолчанию (инструкция человеку или изолированная копия). Подробно — ../../shared/kb/conventions.md («0. Право исполнять»).

3. Маршрутизация (намерение → под-скилл)

• инфоблоки / компоненты / страницы / вывод контента / интроспекция проекта → 1c-bitrix-cms-content
• sitemap / ЧПУ / редиректы / мета / robots / Open Graph → 1c-bitrix-cms-seo
• шаблон сайта / вёрстка / меню / включаемые области → 1c-bitrix-cms-template
• окружение / установка / структура проекта / CLI / миграции структуры и данных / бэкап и восстановление / перенос между средами → 1c-bitrix-cms-setup
• .settings / конфиг / события / агенты / кэш → 1c-bitrix-cms-settings
• магазин / каталог / заказы / оплата / доставка / обмен с 1С → 1c-bitrix-cms-commerce
• защита / права доступа / уязвимости → 1c-bitrix-cms-security
• Монитор качества / приёмка / тесты / нагрузка → 1c-bitrix-cms-quality
• любые обновления ядра/модулей/решений, проверка конфликтов и версионные переходы (24→25→26, UTF-8) → 1c-bitrix-cms-update
• REST / вебхуки / интеграции с внешними сервисами и CRM → 1c-bitrix-cms-rest

Реализованы все под-скиллы: setup · settings · template · content · seo · commerce · security · quality · update · rest.

Вне зоны скилла

Скилл НЕ покрывает перечисленное ниже. Не импровизируй и не выдумывай рецепты — направь пользователя в админку Битрикса (модуль/мастер) или честно скажи, что это вне зоны скилла:

• landing / «Сайты24» (внутренняя сборка блоков лендингов) — собирается в визуальном конструкторе, отдельного рецепта нет.
• bizproc — бизнес-процессы, согласования, конструктор БП.
• sender / subscribe — email-маркетинг, рассылки, подписки.
• vote — голосования и опросы.
• веб-аналитика — Яндекс.Метрика / GA4 e-commerce, цели, электронная коммерция.
• push&pull-сервер — реалтайм-уведомления, очереди сообщений.
• bigdata-персонализация — рекомендательные сервисы, персонализация контента.
• clouds — вынос медиа в облако / S3.
• установка marketplace-решений (в отличие от обновления существующих — это под-скилл update).
• мониторинг ошибок (внешние системы трекинга ошибок/APM).
• сообществные модули коробки — форум (forum), блоги (blog), вики (wiki), фотогалерея (photogallery), календарь событий (calendar), обучение/тесты (learning), техподдержка (support), соцсеть (socialnetwork): отдельных рецептов нет — настраиваются штатной админкой/мастерами модулей.

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

Обновление пакета (необязательно, без навязывания)

Версия установленного пакета — в файле VERSION в корне установки. Если на github.com/vrtalex/1c-bitrix-cms-skill есть более свежий релиз, можно один раз за сессию предложить пользователю обновиться — и продолжить задачу независимо от ответа. Не редактируй настройки автоматически, не повторяй предложение и не зашумляй ответ.

4. Подгрузка знаний (только нужное)

• общая модель — ../../shared/kb/00-overview.md
• правила/конвенции — ../../shared/kb/conventions.md
• «задача → класс/способ» — ../../shared/kb/api-map.md
• пошаговые рецепты — ../../shared/kb/recipes/
• эксплуатация — ../../shared/kb/operations.md
• термины — ../../shared/kb/glossary.md

Не загружай всю базу целиком — подавай срез под конкретную задачу.

База знаний самодостаточна. Ссылки [src] и блоки «Источники» — это указание происхождения факта, а не материал для чтения: по умолчанию их не открывай. Обращайся к внешнему первоисточнику только когда нужен версионно-зависимый факт, которого в базе нет, и не обходи вложенные ссылки рекурсивно.