xonika9/agent-skills

Diagramme

Entwerfen, erstellen, überprüfen und konvertieren Sie Diagramme, während Sie das visuelle Argument und die native Quelle unabhängig voneinander korrekt halten.

Der maschinenlesbare Onboarding-Vertrag listet externe Voraussetzungen auf.

Zwei Entscheidungen treffen

Wählen Sie zuerst die Ansicht, die die Beziehung ausdrückt: Flussdiagramm, Sequenzdiagramm, Zustandsdiagramm, Architekturdiagramm, Datenmodell, Hierarchie, Zeitstrahl, Vergleich oder eine andere unterstützte Ansicht. Wählen Sie dann das Lieferformat. Lassen Sie nicht zu, dass ein vertrautes Dateiformat den Diagrammtyp bestimmt.

Ein explizites Format gewinnt, wenn es die erforderliche Struktur ausdrücken kann. Wenn es eine wesentliche Einschränkung erzeugt, erklären Sie die Einschränkung und bieten Sie eine Alternative an, ohne das Arbeitsergebnis stillschweigend zu ändern.

Verwenden Sie diese Matrix, wenn das Format offen ist:

Einschränkung	Excalidraw	Mermaid	draw.io
Manuelle Koordinatensteuerung	Stark	Schwach; Layout ist automatisch	Stark
Kollaborative visuelle Bearbeitung	Stark in Excalidraw	Hängt vom Host ab	Stark in diagrams.net
Text-Diff und Code-Review	Schwach	Stark	Mittel mit unkomprimiertem XML
Automatisches Layout	Manuell zuerst	Stark	Verfügbar, aber manuelle Geometrie bleibt explizit
Freie räumliche Komposition	Stark	Eingeschränkt	Stark
Seiten, Ebenen, Container, Formbibliotheken	Eingeschränkt	Eingeschränkt und Renderer-abhängig	Stark
Direktes Markdown/Chat-Rendering	Selten	Stark, wenn unterstützt	Selten
Native Bearbeitbarkeit nach Übergabe	.excalidraw	Mermaid-Quelle in einem kompatiblen Editor	.drawio XML
Zuverlässige Validierung und Rendering	Benötigt Prüfer plus getreuen Renderer	Benötigt Zielparser plus Renderer	Benötigt XML-Prüfungen plus kompatiblen Editor/Exporter

Bevorzugen Sie das Format, dessen nativer Editor, Validator und Renderer in der Auslieferungsumgebung verfügbar sind. Wenn keines einen visuellen Nachweis liefern kann, erstellen Sie die angeforderte native Quelle nur dann, wenn sie noch nützlich ist, und kennzeichnen Sie das Ergebnis als DEGRADED.

Das visuelle Argument besitzen

Legen Sie eine Frage, ein Publikum, einen Auslieferungs-Viewport, einen Einstiegspunkt und eine dominante Leserichtung fest. Bewahren Sie genaue Fakten und Identifikatoren, während Sie erklärende Beschriftungen verkürzen. Modellieren Sie semantische Knoten, Grenzen und Beziehungen vor Syntax oder Koordinaten.

Lesen Sie die gemeinsame Entwurfsmethode, bevor Sie ein Diagramm erstellen oder wesentlich überarbeiten. Sie besitzt Topologie, Hierarchie, Dichte, Gruppierung, Grenzen, Routing, semantische Form-/Farb-/Linienverwendung, Aufteilungskriterien und visuelle Akzeptanz.

Einen Formatadapter verwenden

• Für natives .excalidraw JSON lesen Sie den Excalidraw-Adapter. Führen Sie dessen gebündelten Prüfer aus und inspizieren Sie eine getreue Darstellung.
• Für Mermaid-Quelle oder einen Mermaid-Block im Chat lesen Sie den Mermaid-Adapter. Parsen und rendern Sie mit dem tatsächlichen Ziel oder einem kompatiblen vorhandenen Tool.
• Für natives .drawio XML lesen Sie den draw.io-Adapter. Validieren Sie die XML-Struktur, öffnen oder exportieren Sie sie mit einem kompatiblen diagrams.net-Tool und inspizieren Sie das Ergebnis.

Formatadapter besitzen Serialisierung, Escaping, Identifikatoren, Bindungen, Geometrie, Themes, Seiten, Ebenen und Renderer-spezifische Einschränkungen. Kopieren Sie ihre flüchtige Mechanik nicht in diesen Kern.

Die native Quelle bewahren

Für ein neues Arbeitsergebnis mit benanntem Pfad wird der angeforderte Pfad beim ersten Schreiben kanonisch. Bei einer Überarbeitung bleibt die vorhandene Quelle kanonisch, während Änderungen in einem Kandidaten leben. Editoren und Renderer verbrauchen diese Artefakte; ein Export an anderer Stelle ersetzt niemals implizit die kanonische Quelle.

Ein Revisionskandidat ersetzt die vorhandene Quelle nur dann, wenn er das Abschlusskriterium erfüllt. Andernfalls melden Sie DEGRADED, lassen Sie die vorhandene Quelle unverändert und identifizieren Sie den Kandidaten als unfertig.

Konvertieren und überprüfen

Bewahren Sie bei Konvertierungen die semantische Identität: Knotenbedeutung, Beziehungsrichtung, Reihenfolge, Enthaltensein, Grenzen, Kardinalität und exakte technische Token. Bewahren Sie Seiten, Ebenen und Containeridentität, wenn sowohl Quelle als auch Ziel sie unterstützen. Geben Sie Verluste wie automatische Layoutänderungen, nicht unterstützte Formbibliotheken oder abgeflachte Styling an; versprechen Sie niemals Pixelgleichheit.

Für reine Überprüfungsarbeit inspizieren und berichten Sie ohne Umschreiben. Überprüfen Sie die native Struktur getrennt von der gerenderten Komposition: Ein erfolgreicher Parse beweist keine Lesbarkeit, und ein plausibles Bild beweist keine Bearbeitbarkeit.

Auslösegrenze

Dieses Skill besitzt explizite x9-diagrams-Aufrufe, Formatauswahl, formatübergreifende Konvertierung, die gemeinsame visuelle Methode und kombinierte strukturelle plus visuelle Verifizierung. Eine Anfrage, die auf gewöhnliche Mermaid-Syntax beschränkt ist, kann bei einem installierten spezialisierten mermaid-diagrams-Skill bleiben. Dieses Skill bleibt eigenständig für Benutzer, die diesen Drittanbieter-Skill nicht haben.

Wenn die Auslöserzuständigkeit mehrdeutig ist, verwenden Sie x9-diagrams nur, wenn die Aufgabe dessen breiteren Entscheidungs- oder Verifizierungsvertrag benötigt. Rufen Sie nicht beide Skills auf, nur weil Mermaid in der Anfrage erscheint.

Abschlusskriterium

Ordnen Sie die Abschlussnachweise der angeforderten Aktion zu:

• Formatauswahl: Benennen Sie die Ansicht und das Lieferformat, verbinden Sie die Auswahl mit den Einschränkungen des Benutzers, geben Sie wesentliche Einschränkungen an und identifizieren Sie, ob ein kompatibler Validator, Renderer oder Editor verfügbar ist.
• Erstellung oder wesentliche Überarbeitung: Die gewählte Ansicht beantwortet die gestellte Frage; die native Quelle wird geparst oder geöffnet und bleibt bearbeitbar; der Agent hat keinen nativen Datei- oder Verzeichniswähler ausgelöst, den er nicht selbst abschließen konnte; formatspezifisches Post-Load-Layout ist, wo zutreffend, stabil; ein kompatibler Renderer oder Editor hat die tatsächliche Ansicht aus der endgültigen kanonischen Quelle nach ihrer letzten wesentlichen Änderung erzeugt; und diese Ansicht wurde in ihrem deklarierten Auslieferungsmodus auf Lesbarkeit, Hierarchie, Kreuzungen, Clipping und irreführende Struktur überprüft.
• Konvertierung: Erfüllen Sie die Erstellungsnachweise und bestätigen Sie, dass wichtige Semantiken überlebt haben; geben Sie Verluste in Layout, Styling, Seiten, Ebenen, Containern oder Notation an.
• Nur Überprüfung: Unterscheiden Sie native Strukturergebnisse von gerenderten Kompositionsergebnissen und zitieren Sie die geprüften Nachweise, ohne das Artefakt umzuschreiben.

Wenn Nachweise, die für die aktive Aktion erforderlich sind, nicht eingeholt werden können, melden Sie DEGRADED mit der genauen fehlenden Prüfung, dem fehlenden Validator, Renderer, Editor oder Quellartefakt. Excalidraw-Prüfer-Regressionstests befinden sich in scripts/test_check_scene.py.