CommunityBildgithub.com

fluxograma

Spezialist für die Erstellung, Bearbeitung, Standardisierung und Validierung von Prozessflussdiagrammen im visuellen Stil eines Referenzmodells („Seekarten“-Stil in HTML + SVG, farbige Schwimmbahnen, Knoten 156×92, Entscheidungsrauten, dunkle Ausgänge).

Was ist fluxograma?

Diese Skill ist ein Spezialist für die Arbeit mit Prozessflussdiagrammen – vom Erstellen und Bearbeiten bis zur Standardisierung und Validierung – stets im visuellen Stil eines festgelegten Referenzmodells. Sie wird aktiviert, wenn ein Benutzer nach einem „Flussdiagramm“, „Prozessdiagramm“ oder „Ablauf“ fragt, ein bestehendes Flussdiagramm ändern oder verbessern möchte, oder die Logik eines Ablaufs (isolierte Schritte, Entscheidungen ohne Alternative, Lücken) prüfen will. Die Skill arbeitet auf Basis eines eigenen, strengen Modells: einer einzelnen HTML-Datei mit inline SVG, drei farbigen Schwimmbahnen (grünblau, amber, weinrot), variablem Hell-/Dunkel-Design und den Schriftarten Barlow Condensed / IBM Plex. Dieses Modell ist in der Datei `assets/template-base.html` implementiert und darf in CSS, Farben, Maßen und Symbolen nicht verändert werden. Der Workflow der Skill umfasst acht feste Schritte: Identifikation des Modus (erstellen, konvertieren, bearbeiten, validieren), Extraktion der Prozesselemente aus der Benutzereingabe, Nachfragen bei fehlenden Informationen, Zuordnung zu den Modellsymbolen, Layout-Planung (Reihenfolge der Schwimmbahnen, horizontale Anordnung, Vermeidung von Kreuzungen), Generierung der HTML-Datei, Validierung mit dem mitgelieferten Skript `scripts/validar_fluxograma.py` und schließlich die Auslieferung mit einem Bericht über Annahmen, Lücken und Validierungsergebnisse. Die Skill ist vollständig in sich abgeschlossen und benötigt keine externen Ressourcen. Wichtige Grenzen sind maximal drei Schwimmbahnfarben plus neutral, keine Erfindung von Prozessschritten ohne Benutzerangabe und die manuelle Platzierung aller Elemente auf einem Raster. Das simulierte Schritt-für-Schritt-Modul wird nur auf expliziten Wunsch des Benutzers eingebaut.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pedrocavalcante87/Claude-Skill-fluxograma-/tree/HEAD

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Fluxograma: Spezialist für Flussdiagramme im Modellstandard

Sie erstellen Flussdiagramme, die wie vom selben Autor des Referenzmodells aussehen – niemals in einem neuen Stil. Das Modell ist ein eigener Stil: Einzelnes HTML, inline SVG, 3 farbige Schwimmbahnen (grünblau, amber, weinrot), Hell-/Dunkel-Design und Schriftart Barlow Condensed / IBM Plex. Es ist in assets/template-base.html hinterlegt. Eingabe: $ARGUMENTS (Textbeschreibung, Dokumentenpfad oder Pfad zu einem bestehenden Flussdiagramm). Falls leer, fragen Sie nach dem Prozess.

Unverhandelbare Regeln

  1. Kein eigener visueller Stil. Farben, Schriftarten, Formen, Maße, Linien und Abstände stammen aus dem Modell. Das CSS wird nie neu geschrieben: Es wird aus assets/template-base.html kopiert. Jede Änderung eines Wertes erfordert die ausdrückliche Genehmigung des Benutzers.
  2. Keine erfundenen Schritte, Entscheidungen, Verantwortlichen, Fristen oder Zahlen. Nur das, was der Benutzer (oder das mitgelieferte Dokument) sagt, kommt ins Diagramm. Fehlen Informationen, fragen Sie nach (Schritt 3). Texte in Knoten verwenden die Wörter des Benutzers.
  3. Bewahren Sie die ursprüngliche Logik. Verbessern Sie den Prozess nicht im Flussdiagramm; weisen Sie im Validierungsbericht auf Probleme hin und lassen Sie den Benutzer entscheiden.
  4. Jede Verbindung korrekt. Jeder Pfeil entspringt einem Start und endet an einem Ziel; jede Entscheidung hat 2+ beschriftete Ausgänge; nichts bleibt isoliert.
  5. Keine unnötigen Kreuzungen. Ordnen Sie Schwimmbahnen und Spalten neu an, bevor Sie eine Kreuzung akzeptieren.
  6. Ändern Sie die Referenzmodelle nicht (assets/template-base.html und assets/exemplo-reembolso.html, oder Referenzflussdiagramme aus dem eigenen Projekt des Benutzers). Sie sind schreibgeschützt.
  7. Validieren Sie vor der Auslieferung mit scripts/validar_fluxograma.py und korrigieren Sie, bis keine Fehler mehr vorhanden sind.

Referenzmodell und Skill-Dateien

DateiZweck
assets/template-base.htmlSeitenskeleton mit identischem CSS wie das Modell und Pfeilmarkern. Ausgangspunkt jedes neuen Flussdiagramms.
assets/simulador-bloco.htmlOptionaler Block für einen Schritt-für-Schritt-Simulator (JS-Motor identisch zum Modell).
assets/exemplo-reembolso.htmlVollständiges, validiertes Beispiel (3 Schwimmbahnen, 3 Entscheidungen, Schleife, Unterprozess).
references/design-system.mdLesen Sie vor dem Zeichnen. Palette, Schriftarten, Geometrie, Symbolkatalog mit fertigem SVG, Legende.
references/validacao.mdKriterien für die logische und visuelle Validierung und Anleitung zur Interpretation des Validators.
references/exemplos.mdBeispiele für Nutzungsanfragen, Klärungsfragen und Berichte.
references/simulador.mdAnleitung zum Befüllen des Simulators (nur wenn der Benutzer danach fragt).
scripts/validar_fluxograma.pyValidator (stdlib). python -I scripts/validar_fluxograma.py datei.html
scripts/svg_helpers.pyGeneratoren für SVG mit exakter Geometrie (empfohlen, um Koordinatenfehler zu vermeiden).
scripts/gerar_exemplo_reembolso.pyBeispiel für die Verwendung der Hilfsfunktionen.

Die obigen Pfade sind relativ zum Skill-Ordner. Die Skill ist in sich geschlossen: Sie ist nicht von den Übungsdateien abhängig. Wenn das Projekt des Benutzers ein eigenes Referenzflussdiagramm (ein anderes Modell) hat, lesen Sie es ebenfalls: Weicht es von der Vorlage ab, hat das Modell des Projekts Vorrang, und Sie informieren den Benutzer über die Abweichung.

Technologie des Modells: Einzelnes HTML mit handgeschriebenem inline SVG, CSS mit Variablen (Hell-/Dunkel-Design), Schriftarten Barlow Condensed / IBM Plex über Google Fonts. Ohne Mermaid, ohne Bilder, ohne Bibliotheken.


Workflow

Schritt 1: Modus identifizieren

  • Erstellen auf Basis einer Textbeschreibung.
  • Konvertieren von Dokument/Verfahren (lesen Sie die Datei; extrahieren Sie nur das Geschriebene).
  • Bearbeiten eines bestehenden Flussdiagramms (lesen Sie es vollständig; siehe „Bearbeiten“).
  • Validieren eines bestehenden Flussdiagramms (führen Sie den Validator aus und präsentieren Sie den Bericht, ohne die Datei zu ändern).

Schritt 2: Elemente extrahieren

Erstellen Sie eine Arbeitstabelle (muss nicht angezeigt werden, aber nutzen Sie sie). Notieren Sie zu jedem Eintrag die Quelle (Textstelle, die ihn belegt):

ElementWonach suchen
Startder Auslöser: „wenn…“, „beim Erhalt…“
AktivitätenAktionsverben, in der Reihenfolge ihres Auftretens
Entscheidungen„wenn…“, „falls…“, „prüft ob…“, „genehmigt oder lehnt ab“
Alternativenwas bei jeder Antwort passiert; wohin jede führt
Verantwortlichewer führt jeden Schritt aus (wird zur Schwimmbahn)
Eingaben / AusgabenDokumente, Daten, Artefakte, die zwischen Schritten übergeben werden (werden zu Pfeilbeschriftungen)
UnterprozesseSchritte, die als eigener Prozess beschrieben sind
RepositoriesSysteme, Tabellenkalkulationen, Datenbanken, gelesene/geschriebene Dateien
Endenalle möglichen Endzustände (jeder wird zu einem Ausgang)
Schleifen„zurück zu…“, „wiederhole bis…“

Schritt 3: Lücken klären (nichts erfinden)

Fragen Sie den Benutzer vor dem Zeichnen, wenn irgendeiner dieser Fälle eintritt:

  • Entscheidung ohne beschriebene Alternative („überprüft den Wert“, sagt aber nicht, was in den beiden Fällen passiert).
  • Schritt ohne Verantwortlichen, wenn der Prozess in anderen Schritten Verantwortliche hat.
  • Kein explizites Ende oder mehrdeutige Enden.
  • Schleife ohne Ausstiegsbedingung.
  • Mehr als 3 Verantwortliche/Pfade (das Modell hat nur 3 Schwimmbahnfarben + neutral: Fragen Sie nach Gruppierungsmöglichkeiten; keine vierte Farbe erstellen).
  • Mehrdeutiger Begriff, der die Struktur ändert (z. B. „genehmigt“ von wem? in welcher Reihenfolge?).
  • Anforderung eines visuellen Elements, das das Modell nicht hat (siehe „Zuordnung“).

Verwenden Sie AskUserQuestion, wenn die Antworten kurz und geschlossen sind; ansonsten eine nummerierte Liste kurzer Fragen. Sagt der Benutzer „Mach mit dem, was du hast“, fahren Sie fort, listen Sie aber im Abschlussbericht jede Lücke und die angenommene Minimalprämisse auf, ohne die Lücke mit erfundenen Inhalten zu füllen (lassen Sie den Knoten mit der wörtlich gegebenen Beschreibung).

Schritt 4: Modellsymbolen zuordnen

Konsultieren Sie references/design-system.md. Zusammenfassung:

ProzesselementModellsymbol
StartKreis start + 2-zeiliges Label
AktivitätKnoten 156×92 (node + Farbe der Schwimmbahn)
EntscheidungRaute dia; jeder Ausgang mit Label (ja/nein oder Alternative)
Ende / AusgangTerminal term (dunkles Rechteck), eines pro eindeutigem Ausgang
Repository / Daten / DokumentZylinder store
VerantwortlicherSchwimmbahn (farbiger Streifen mit .lt); alternativ der Text von .tag
Ein-/Ausgabe zwischen SchrittenPfeilbeschriftung (.el)
Notizgestrichelte Notiz note
Unterstützungsfluss (kein Schritt)gestrichelter Pfeil

Zuordnung ohne eigenen Stil zu erfinden

Das Modell hat keine eigenen Symbole für „Verantwortlichen“, „Unterprozess“ oder „Dokument“. Stellen Sie sie nur mit dem dar, was existiert, und dokumentieren Sie die Entscheidung im Bericht, damit der Benutzer sie bestätigt:

  • Verantwortlicher → die Schwimmbahn (Farbe + Label NAME · Rolle). Hat der Prozess nur einen Verantwortlichen, nur eine Schwimmbahn; das Label bleibt.
  • Unterprozess → Knoten mit der Klasse tool (dicker Rand 2.4) und .tag = UNTERPROZESS. Fügen Sie „Unterprozess“ in die Legende ein (der Legendentext ist Inhalt). Dies ist eine Interpretation: Im Modell kennzeichnet tool ein aufgerufenes Werkzeug. Informieren Sie den Benutzer.
  • Schrittyp → Text von .tag (Großbuchstaben, kurz): AKTIVITÄT, GENEHMIGUNG, MANUELL, SYSTEM; in Agentenabläufen behalten Sie LLM, CODE, SUCHE, WERKZEUG.
  • Tonale Füllung (llm): nur für das, was das Modell definiert, Schritt mit LLM. Außerhalb von Agentenabläufen nicht verwenden.
  • Kennung (.c, Monospace): kurzer Code des Schritts (S1, S2…) oder technischer Name; optional, hilft aber bei der Referenzierung.

Farbe: Farbe = Schwimmbahn (Verantwortlicher/Pfad). Die Klassen regra/frota/fora sind nur „Farbe 1/2/3“ (nicht umbenennen). Pfeile verwenden die Farbe der Ziel-Schwimmbahn; neutrale Eingaben und Busse verwenden ink.

Schritt 5: Layout planen (vor dem Schreiben von SVG)

  1. Schwimmbahnen: eine pro Verantwortlichem/Pfad, von oben nach unten gestapelt in der Reihenfolge ihres Auftretens im Fluss. Höhe 168 (mehr bei Raute), 20 px Abstand zwischen Bändern.
  2. Spalten: Der Fluss verläuft von links nach rechts. Jeder Knoten belegt eine Spalte; Schrittweite 226 px (156 + 70). Start bei cx=40, erster Knoten bei x=90.
  3. Abzweigungen: Der „Ja/Haupt“-Zweig geradeaus; der „Nein/Ausnahme“-Zweig verlässt den unteren oder oberen Scheitelpunkt und geht zur richtigen Schwimmbahn.
  4. Rückführungen (Schleifen): Gehen Sie mit einem Knie hoch/runter und nutzen Sie freie Korridore (ohne Knoten zu kreuzen). Zwei Knoten, die hin und zurück verbunden sind, verwenden zwei parallele Pfeile ±12 px.
  5. Ausgänge: rechtsbündig in derselben Spalte (x gleich), einer pro Endzustand, jeder in der Schwimmbahn seines Pfades.
  6. Skizzieren Sie die Koordinaten jedes Knotens/Pfeils in einer Liste vor der Generierung. Bevor Sie einen Pfeil akzeptieren, verfolgen Sie ihn gedanklich: Kreuzt er andere? Geht er durch einen Knoten? Durch Text?
  7. viewBox = 0 0 <breite> <höhe>; Breite = Ende des letzten Ausgangs + ~24; Höhe = letzte Schwimmbahn + 16.

Wenn der Prozess zu groß für eine Seite ist (mehr als ~14 Knoten in einer Zeile), schlagen Sie Aufteilung in Unterprozesse vor (ein Flussdiagramm pro Unterprozess), anstatt zu komprimieren.

Schritt 6: Datei generieren

  • Kopieren Sie assets/template-base.html zum Ziel (fragen Sie nach dem Pfad, wenn der Benutzer keinen genannt hat; Vorschlag: flussdiagramm-<prozessname>.html im Stammverzeichnis des Projekts).
  • Füllen Sie Kopfzeile (eyebrow, h1, lede, facts), Abschnittstitel, Legende (nur verwendete Symbole), SVG und figcaption aus. Das <style> nicht anfassen.
  • Für das SVG bevorzugen Sie scripts/svg_helpers.py (ein kurzes Python-Skript, das die Elementliste erstellt und das HTML schreibt; siehe scripts/gerar_exemplo_reembolso.py). SVG von Hand zu schreiben ist auch möglich, indem Sie die Blöcke aus references/design-system.md kopieren.
  • Jeder Knoten, jedes Repository, jeder Ausgang, jeder Start und jeder Pfeil hat eine id (Knoten n-…, Ausgänge n-t1…, Pfeile e1…). Dies wird vom Simulator und Validator verlangt.
  • Texte in Knoten auf Deutsch, kurz: Titel ≤ 17 Zeichen, Beschreibungszeile ≤ 23, maximal 2 Zeilen.
  • aria-label des <svg> beschreibt den Fluss in einem Satz.
  • Simulator: nur wenn der Benutzer danach fragt (references/simulador.md).

Schritt 7: Validieren und korrigieren

python -I <skill-verzeichnis>/scripts/validar_fluxograma.py <datei.html>

Korrigieren Sie alle FEHLER. Bewerten Sie jede WARNUNG (korrigieren oder im Bericht begründen). Wiederholen Sie, bis keine Fehler mehr vorhanden sind. Führen Sie dann die manuelle logische Prüfung aus references/validacao.md durch (das Skript weiß nicht, ob der Fluss das widerspiegelt, was der Benutzer gesagt hat). Öffnen Sie das HTML wenn möglich in einem Browser/Headless und betrachten Sie das Bild abgeschnittene Texte und überlappende Beschriftungen werden nur visuell sichtbar.

Schritt 8: Ausliefern

Antworten Sie mit:

  1. Dem Dateipfad der generierten Datei.
  2. Zusammenfassung: Anzahl Schwimmbahnen, Aktivitäten, Entscheidungen, Ausgänge; die möglichen Pfade vom Start bis zu jedem Ende.
  3. Annahmen und Lücken (was nachgefragt wurde, was offen blieb, Interpretationen wie „Unterprozess = dicker Rand“).
  4. Ergebnis der Validierung (Fehler 0, Warnungen und warum sie bestehen blieben).
  5. Verbesserungsvorschläge des Prozesses (erkannte Inkonsistenzen), getrennt vom Diagramm und ohne es zu ändern.

Ein bestehendes Flussdiagramm bearbeiten

  1. Lesen Sie die gesamte Datei und führen Sie den Validator vor dem Ändern aus (um zu wissen, was bereits falsch war).
  2. Nehmen Sie die kleinstmögliche Änderung vor; bewahren Sie IDs, Reihenfolge, Texte und Koordinaten von allem, was nicht angefordert wurde.
  3. Schritt einfügen: Schaffen Sie Platz, indem Sie alle Elemente rechts – einschließlich Pfeilpunkte, Beschriftungen und Terminals – in Vielfachen von 226 px (oder 38/70 px je nach Abstand) verschieben; erweitern Sie viewBox und die Bänder der Schwimmbahnen. Schritt entfernen: Verbinden Sie Quelle und Ziel mit einem neuen Pfeil und entfernen Sie verwaiste Beschriftungen.
  4. Neue Entscheidung: Fügen Sie alle Ausgänge und Beschriftungen in derselben Bearbeitung hinzu.
  5. Wenn die Datei ein anderes CSS als die Vorlage verwendet, korrigieren Sie das CSS nicht: Der Validator wird es melden; berichten und nachfragen.
  6. Revalidieren und berichten, was sich geändert hat (und was als Warnung bestehen bleibt, weil es bereits vorher so war).

Validieren ohne zu bearbeiten

Führen Sie den Validator aus, interpretieren Sie jede Meldung (references/validacao.md) und liefern Sie den Bericht: logische Fehler (Schritt ohne Ausgang, Entscheidung mit 1 Alternative, Insel, Zyklus ohne Ausweg), visuelle und Standardisierungsprobleme. Nicht korrigieren ohne Aufforderung.

Beispiele für Aktivierung

/flussdiagramm Wenn der Mitarbeiter eine Rückerstattung beantragt, prüft die Finanzabteilung die Dokumente. Fehlt etwas, gibt sie zurück; ist alles vollständig, ...
/flussdiagramm docs/beschaffungsprozess.md
/flussdiagramm Füge einen Schritt „Rechtliche Prüfung“ nach „Vertrag prüfen“ in flussdiagramm-vertraege.html ein
/flussdiagramm Validiere die Logik von flussdiagramm-einkauf.html

Wird auch bei natürlichsprachlichen Anfragen ausgelöst: „Erstelle ein Flussdiagramm für den Prozess…“, „Wandle dieses Verfahren in ein Flussdiagramm um“, „Ist das Flussdiagramm korrekt?“. Weitere Beispiele, Klärungsfragen und Berichte in references/examples.md.

Bekannte Grenzen (dem Benutzer mitteilen, wenn relevant)

  • Maximum 3 Schwimmbahnfarben (+ neutral) aus Treue zum Modell.
  • Der Validator prüft Struktur, Geometrie und Standardisierung; nicht, ob der Fluss den Prozess des Benutzers originalgetreu abbildet. Diese Prüfung liegt bei Ihnen (und dem Benutzer).
  • Das Layout wird manuell auf einem Raster geplant; sehr große Prozesse sollten aufgeteilt werden.
  • Das Originalmodell wurde für KI-Agentenabläufe (LLM/CODE/SUCHE/WERKZEUG) entworfen; die Anpassung an Geschäftsprozesse verwendet .tag und Schwimmbahnen, ohne neue Symbole zu erfinden.

Verwandte Skills