Make BPMN

make-bpmn - skill для Codex, который помогает создавать BPMN 2.0 диаграммы из текстового описания бизнес-процесса.

Skill ориентирован на реальные .bpmn файлы с BPMN DI разметкой, а не на Mermaid или текстовое описание. В комплекте есть Python-рендерер, который строит SVG и, при наличии cairosvg - PNG, чтобы можно было быстро посмотреть что получилось.

Что умеет

• Превращает описание процесса, пользовательского пути, операционной процедуры или интеграционного сценария в BPMN 2.0.
• Помогает Codex выбрать структуру диаграммы: пул, дорожки, события, задачи, шлюзы, sequence flow и message flow.
• Требует BPMN DI координаты для всех видимых элементов и связей.
• Проверяет читаемость диаграммы через SVG-рендеринг.
• Помогает исправлять типовые проблемы: пересечения стрелок, нечитабельные подписи, элементы вне дорожек, некорректные message flow.

Установка

Установи skill из этого репозитория:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo notime2/make-bpmn \
  --path skills/make-bpmn

После установки перезапусти Codex, чтобы skill появился в списке доступных skills.

Как использовать

Попроси Codex использовать /make-bpmn и передай описание процесса:

Используй /make-bpmn и создай BPMN диаграмму для процесса:

1. Клиент оформляет заказ.
2. Платежный сервис проверяет оплату.
3. Если оплата успешна, склад резервирует товары.
4. Если оплата не прошла, поддержка связывается с клиентом.

Ожидаемый результат:

• .bpmn файл с BPMN 2.0 XML.
• BPMN DI координаты для визуального отображения.
• SVG-рендер диаграммы.
• PNG, если он был запрошен (по умолчанию считается что запрошен).
• Исправленная читаемая раскладка после визуальной проверки.

В полученной схеме будут все основные объекты, шлюзы, действия и потоки описываемого процесса, но возможно не идеально расположено. Полученный .bpmn открываете в любимом редакторе, и расставляете элементы как надо.

До редактирования и после

Требования

• Codex с поддержкой локальных skills.
• Python 3 для SVG-рендеринга.
• Опционально: cairosvg для PNG-экспорта.

Установка PNG-зависимости:

python3 -m pip install cairosvg

Для SVG внешние Python-пакеты не нужны.

Структура репозитория

skills/
  make-bpmn/
    SKILL.md
    agents/
      openai.yaml
    scripts/
      bpmn_visualizer.py

Ограничения

• Рендерер сделан для практичной проверки читаемости, а не для полной замены BPMN-редактора.
• Некоторые продвинутые BPMN-маркеры и стили отображаются упрощенно.
• Если нужен редкий BPMN-элемент, лучше добавить поддерживаемую фигуру и текстовую аннотацию.