| 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] и блоки «Источники» — это указание происхождения факта, а не материал для чтения: по умолчанию их не открывай. Обращайся к внешнему первоисточнику только когда нужен версионно-зависимый факт, которого в базе нет, и не обходи вложенные ссылки рекурсивно.
