Отладчик шаблонов бизнес-процессов Битрикс24

Установка

npx skillfoxx add skills/bitrix-bizproc

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a claude-code -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a cursor -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a github-copilot -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a codex -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a gemini-cli -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a cline -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a roo -y

npx skills add shydamn/bitrix-bizproc-skill --skill bitrix-bizproc -a opencode -y

pip install phpserialize

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

Что делает

Скилл читает формат bpt: дерево PHP-массивов, сериализованное serialize() и сжатое zlib, в котором визуальный редактор бизнес-процессов Битрикс24 хранит шаблон. Битрикс не проверяет ссылки внутри такого файла, поэтому ссылка на удаленную активность или необъявленную константу молча превращается в пустую строку, и дефект не виден в интерфейсе. По умолчанию скилл работает с выгруженными файлами bpt: показывает сводку и дерево шаблона, ищет активности по типу или заголовку и проверяет целостность ссылок. Если на портале установлен отдельный модуль-шлюз bizproc-agent и заданы переменные с его адресом и токеном, тот же скилл читает и записывает шаблоны прямо на живом портале, с автоматическими снимками перед записью и откатом к прошлой версии. Автор проверил разбор и сборку формата на 31 боевом шаблоне с нескольких порталов и на всех 2584 шаблонах одного рабочего портала: расхождений с исходником не было.

Для кого. Для разработчиков Битрикс24, которые сопровождают сложные бизнес-процессы и хотят находить скрытые дефекты шаблонов до того, как они проявятся в проде.

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

Разбери шаблон process.bpt и проверь, нет ли в нем ссылок на удаленные активности

Ограничения

Репозиторий свежий, автор один, звезд нет. Проверка ссылок семантическая только частично: она находит битые ссылки, но не гарантирует, что дерево исполнимо. Без модуля-шлюза скилл не пишет в базу Битрикс24 и не чинит запущенные процессы: заливка исправленного файла это ручной импорт bpt в интерфейсе. С модулем-шлюзом сервер получает возможность читать и переписывать шаблоны бизнес-процессов на портале, а активность CodeActivity внутри шаблона содержит произвольный PHP, который выполняется на сервере портала, поэтому такие правки нужно всегда показывать пользователю целиком и подтверждать отдельно. Нужен Python с пакетом phpserialize.

Как отключить. Удалите папку скилла из каталога скиллов Claude Code и, если он использовался, модуль bizproc-agent с портала.

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

• В базовом режиме работает только с локальными bpt-файлами и в Битрикс24 не пишет
• При включенном модуле-шлюзе может читать и переписывать шаблоны прямо на портале, а узел CodeActivity в шаблоне содержит исполняемый на сервере PHP-код

Коротко о README

README и полный SKILL.md объясняют формат bpt и то, что Битрикс24 не проверяет ссылки внутри него, из-за чего процесс может работать с молчаливой дырой. Описаны четыре диалекта узлов, разница между обычным деревом и машиной состояний, порядок разведки без загрузки всего шаблона в контекст, режим работы через модуль-шлюз с версионированием и откатом, а также предупреждение о том, что CodeActivity выполняет произвольный PHP на сервере портала. Лицензия MIT.

SKILL.md

---
name: bitrix-bizproc
description: Чтение, разбор, проверка и правка шаблонов бизнес-процессов Битрикс24 (.bpt-файлы и содержимое b_bp_workflow_template). Используй этот скилл всегда, когда речь заходит о бизнес-процессах Битрикса, БП, шаблонах согласования, роботах, маршрутах согласования, .bpt-файлах, автоматизации в CRM или смарт-процессах, даже если пользователь не называет формат и просто просит «поменять маршрут» или «починить согласование». Также используй, если видишь zlib-сжатый PHP serialize с ключами TEMPLATE, VARIABLES, CONSTANTS.
---

# Шаблоны бизнес-процессов Битрикс24

Визуальный редактор БП рисует квадратики, а хранит дерево PHP-массивов,
сериализованное serialize() и сжатое zlib. Ни в интерфейсе, ни в базе нет
проверки ссылок: шаблон со ссылкой на удаленную активность или на необъявленную
константу спокойно сохранится, импортируется и запустится, просто подставив
пустую строку. Ошибки здесь тихие: процесс идет, письмо уходит с дыркой,
согласующий не назначается, в журнале чисто.

Отсюда главное правило работы: правь дерево, а не текст, и проверяй ссылки
до отдачи результата.

## Два режима работы

Скилл работает либо с файлами .bpt, либо с живым порталом через шлюз.

Файлы. Пользователь выгрузил шаблон из интерфейса. Работают
inspect_bpt.py, validate_bpt.py, bpt.py. Ничего настраивать не надо.

Живой портал. На портале установлен модуль-шлюз, и есть переменные
BPAGENT_URL и BPAGENT_TOKEN. Тогда все идет через bpagent.py.

Похожие