diagram-maker

name	diagram-maker
description	Генерация диаграмм из текстового описания: flowchart, sequence, architecture, ER-схемы в синтаксисе Mermaid. Вход — natural language описание, выход — готовый код Mermaid + рекомендация по рендерингу (mermaid.live / mermaid-cli / MCP). Триггеры: 'диаграмма', 'diagram', 'mermaid', 'flowchart', 'блок-схема', 'sequence diagram', 'архитектура', 'ER-схема', 'нарисуй схему', 'draw a diagram', 'схема', 'architecture diagram'.
license	MIT
metadata	{"author":"best","version":"1.1.0"}
compatibility	Requires Python3; optional mermaid-cli for rendering
when_to_use	Use when user wants a diagram from text: 'diagram', 'mermaid', 'flowchart', 'блок-схема', 'sequence diagram', 'architecture diagram', 'ER-схема', 'нарисуй схему', 'draw a diagram', 'схема'. Examples: 'draw a flowchart of the checkout process', 'сделай mermaid-схему архитектуры микросервисов'.

Diagram Maker — генерация диаграмм из текстового описания

Загружай этот скилл когда нужно превратить словесное описание в диаграмму: блок-схему процесса, sequence-диаграмму взаимодействия, схему архитектуры сервисов или ER-схему базы данных. Выход всегда в синтаксисе Mermaid.

When to use

• Нужна блок-схема (flowchart) бизнес-процесса или алгоритма
• Нужна sequence-диаграмма взаимодействия компонентов/пользователей
• Нужна схема архитектуры сервисов и их связей
• Нужна ER-схема (сущности и связи) для базы данных
• Нужно быстро визуализировать описание, чтобы показать команде
• Нужен код Mermaid для вставки в README, docs или issue

Do NOT use to

• Не используй для генерации изображений/картинок (это test-graphics)
• Не используй для презентаций (это presentation-maker)
• Не используй для рисования от руки или векторной графики (SVG/Canvas)
• Не используй для диаграмм Ганта, mindmap или других типов, которые Mermaid не поддерживает нативно — сначала проверь Reference
• Не используй для диаграмм, требующих интерактивности или анимации

What this skill does

Вход: natural language описание (текст на stdin, файл или прямо в чате).

Выход:

1. Код Mermaid нужного типа (flowchart / sequence / architecture / er)
2. Рекомендация, как отрендерить результат:
   • mermaid.live — быстрый онлайн-рендер
   • mmdc (mermaid-cli) — локальный рендер в PNG/SVG/PDF
   • MCP-сервер mermaid — рендер прямо из агента
3. (опционально) markdown-файл с mermaid-блоком через scripts/mermaid_to_markdown.py

How to work

Шаги при генерации диаграммы:

1. Уточни тип диаграммы. Если пользователь не назвал тип — определи по описанию: процесс/алгоритм → flowchart; обмен сообщениями во времени → sequence; сервисы и связи → architecture; сущности и связи БД → er. Если неоднозначно — спроси или предложи наиболее вероятный тип.

2. Составь mermaid-код. Используй шаблоны из templates/ как стартовую точку. Бери узлы и связи ТОЛЬКО из описания пользователя, не выдумывай лишние. Именуй узлы коротко и осмысленно.

3. Проверь синтаксис. Прогони код через scripts/mermaid_to_markdown.py (валидирует кавычки и спецсимволы) или вставь в mermaid.live. Убедись, что все связи замкнуты (каждый упомянутый узел соединён хотя бы одной стрелкой) и нет «висячих» узлов.

4. Отрендерь. Предложи пользователю mermaid.live, mermaid-cli (mmdc) или MCP-рендер. Если нужен файл — сформируй markdown с mermaid-блоком.

Быстрый запуск скрипта

# Из файла с описанием
python3 scripts/mermaid_to_markdown.py --type flowchart input.txt --output out.md

# Из stdin
echo "A -> B -> C" | python3 scripts/mermaid_to_markdown.py --type flowchart

# С заголовком секции
python3 scripts/mermaid_to_markdown.py --type er --title "Схема БД" schema.txt

Examples

1. Flowchart — блок-схема оформления заказа

Описание: «Пользователь добавляет товар в корзину. Если товар в наличии — переходим к оформлению, иначе показываем сообщение о недоступности. После оформления отправляем заказ на склад.»

flowchart TD
    A[Пользователь] --> B{Товар в наличии?}
    B -- Да --> C[Оформление заказа]
    B -- Нет --> D[Сообщение: недоступен]
    C --> E[Отправка на склад]
    D --> A

2. Sequence — оформление подписки

Описание: «Клиент отправляет запрос на подписку. Сервис проверяет платёж, списывает средства и возвращает подтверждение. При ошибке платежа клиент получает сообщение об ошибке.»

sequenceDiagram
    participant C as Клиент
    participant S as Сервис
    participant P as Платёжный шлюз
    C->>S: Запрос на подписку
    S->>P: Проверка платежа
    P-->>S: Успех
    S->>C: Подтверждение
    S-->>C: Ошибка платежа

3. Architecture — микросервисы

flowchart LR
    subgraph Frontend
        Web[Web-клиент]
    end
    subgraph Backend
        API[API Gateway]
        Auth[Auth Service]
        Orders[Orders Service]
    end
    subgraph Data
        DB[(PostgreSQL)]
        Cache[(Redis)]
    end
    Web --> API
    API --> Auth
    API --> Orders
    Orders --> DB
    Orders --> Cache

4. ER — схема базы данных

erDiagram
    CUSTOMER ||--o{ ORDER : places
    ORDER ||--|{ ORDER_ITEM : contains
    PRODUCT ||--o{ ORDER_ITEM : "ordered in"
    CUSTOMER {
        int id PK
        string name
        string email
    }
    ORDER {
        int id PK
        int customer_id FK
        date created_at
    }
    ORDER_ITEM {
        int id PK
        int order_id FK
        int product_id FK
        int quantity
    }
    PRODUCT {
        int id PK
        string title
        decimal price
    }

Constraints & gotchas

• Синтаксис Mermaid строгий. Одна лишняя скобка или кавычка ломает рендер. Всегда проверяй код перед выдачей.
• Не выдумывай узлы. Включай только те сущности и связи, которые есть в описании пользователя. Если чего-то не хватает — уточни.
• Проверь, что связи замкнуты. Каждый узел должен быть соединён хотя бы одной стрелкой. «Висячие» узлы — признак неполного описания.
• Кавычки в label. Если текст узла содержит спецсимволы ([, ], {, }, (, ), :, #) — оборачивай label в одинарные или двойные кавычки: A["Текст: с двоеточием"].
• Не используй эмодзи и не-ASCII спецсимволы в label без необходимости — они могут сломать рендер в старых версиях mermaid.
• Большие диаграммы. Если узлов больше 20 — разбей на подграфы (subgraph) или на несколько диаграмм. Скрипт предупредит об этом.
• ER-схема: связи задаются через ||--o{, }o--|| и т.п. — не путай с flowchart-стрелками.
• Sequence: участники объявляются через participant, сообщения — через ->> (запрос) и -->> (ответ).

Reference

• Официальная документация Mermaid: https://mermaid.js.org
• Онлайн-редактор: https://mermaid.live
• mermaid-cli (локальный рендер): https://github.com/mermaid-js/mermaid-cli
• Синтаксис flowchart: https://mermaid.js.org/syntax/flowchart.html
• Синтаксис sequence: https://mermaid.js.org/syntax/sequenceDiagram.html
• Синтаксис ER: https://mermaid.js.org/syntax/entityRelationshipDiagram.html