SkillFoxx
Telegram

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

bitrix-bizproc

Скилл Claude Code для разбора и проверки bpt-шаблонов бизнес-процессов Битрикс24: находит битые ссылки на активности и константы

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

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

shydamn/bitrix-bizproc-skillАвтор:ShyDamn

Установка

Сервисы

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

pip install phpserialize

Единственная зависимость. После установки положите папку скилла в каталог скиллов Claude Code.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

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

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

Что делает

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

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

Подходит, если

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

Не подходит, если

  • Нужно исправить уже запущенный экземпляр процесса, а не шаблон
  • Нужна проверка, что дерево процесса вообще исполнимо, а не только ссылочно целостно

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

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

Ограничения

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

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

Частые вопросы

Может ли скилл сам исправить битые ссылки?

Он дает модель формата и инструменты для структурной правки дерева через scripts/bpt.py, но не вносит правки автоматически без участия человека.

Нужен ли доступ к живому порталу?

Нет, по умолчанию скилл работает с выгруженными bpt-файлами. Прямая работа с порталом возможна только если на нем отдельно установлен модуль-шлюз bizproc-agent.

Обсуждение

Вопросов и отзывов пока нет.

Битрикс24 — все инструменты
Российский стек

CLI, который превращает бинарные .bpt-файлы бизнес-процессов Битрикс24 в читаемый JSON для гита и диффа

CLIРасширенный доступ1
Российский стек

Скилл для администрирования, диагностики и разработки коробочного Битрикс24 и Bitrix Framework по официальной документации

СкиллРасширенный доступ1

Скилл BI-отчетов Битрикс24

Claude Skills для Битрикс24

Российский стек

Скилл по BI-конструктору Битрикс24 на Trino и Superset: датасеты, SQL-паттерны и таблица типичных граблей

СкиллМинимальный доступ1
Российский стек

Консольная утилита на .NET распаковывает, собирает и показывает содержимое файлов *.bpt с шаблонами бизнес-процессов Bitrix

CLIРасширенный доступ1

Коротко о README

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

Бейдж для README

Исходный 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.

Сообщить о проблеме