wliafe/drawio-skill

Draw.io MCP Operations-Skill

Nutzt den Next AI Draw.io MCP Server (@next-ai-drawio/mcp-server), um bereits festgelegte Zeichenaufgaben auszuführen. Dieser Skill ist für die Werkzeugnutzung und zuverlässige Ausführung zuständig, nicht für Layout, Farben, Schriftarten oder Darstellungsmethoden. Der Kernprozess gilt für verschiedene KI-Clients; Werkzeugerkennung, -aufruf und Skill-Ladung werden vom aktuellen Host bestimmt.

Aufgabe und Dienst bestimmen

1. Aus Benutzeranfrage und aktuellem Kontext ermitteln: Neu erstellen, vorhandene Datei ändern, aktuelle Leinwand fortsetzen oder manuelle Änderungen des Benutzers speichern. Bevorzugt explizit angegebene Materialien, Zielverzeichnisse und vorhandene Versionen verwenden.
2. Aktuell verfügbare MCP-Werkzeuge einsehen, die nachfolgenden Dienstwerkzeugnamen gemäß den tatsächlichen Werkzeugbeschreibungen zuordnen, z. B. get_diagram, edit_diagram, export_diagram. Keine Client-Namensräume, Dienstaliase oder Aufrufsyntax fest codieren.
3. Wenn das Zielwerkzeug verfügbar ist und der aktuelle Client den Aufruf erlaubt, mit dem schreibgeschützten get_drawing_guide die Antwort validieren. Bestehende Deaktivierungs- und Ablehnungsentscheidungen beibehalten. Wenn verfügbar, fortfahren, nicht erneut hinzufügen. Ein nicht verfügbares Werkzeug bedeutet nicht, dass es nicht installiert ist. Bei Bedarf an Konfigurationsprüfung, Installation, Neuladen oder Diagnose die Anleitung MCP-Check und Installation lesen.
4. Dieser Prozess gilt für das genannte Paket. Wenn der Benutzer explizit einen anderen Zeichendienst angibt, dessen Wahl respektieren, die Anpassungsgrenzen erläutern und nicht eigenmächtig ersetzen.

Bereits vorhandene Dienste werden anhand der Paketidentität erkannt; der Dienstname muss nicht drawio sein. Nur wenn die Konfiguration sichtbar ist, aber noch nicht reagiert hat, melden: "Konfiguriert, aber noch nicht verifiziert". Wenn kein Zugriff auf Werkzeuge, Terminal oder Konfiguration besteht, aktuell ausführbare Methoden angeben, ohne eine fehlende Überprüfung als Nichtexistenz des Dienstes darzustellen.

Ablageort und Version bestimmen

Standardmäßig werden im Verzeichnis Projektdokumentation/Themenname/v1/ vier gleichnamige Dateien gespeichert: Themenname.drawio, Themenname.png, Themenname.svg, Themenname.drawio.svg. Der Name kann chinesisch oder englisch sein, die Version steht nur im Verzeichnis. Neue Themen beginnen mit v1; vorhandene Diagramme behalten ihre aktuelle Version, nur bei explizitem Benutzerwunsch wird ein neues vN erstellt.

Vorhandene Dateien behalten ihren bisherigen Pfad und Namen; es erfolgt keine automatische Umbenennung, Migration oder Versionserhöhung. Vom Benutzer angegebene Verzeichnisse, Formate und Bearbeitungsgrenzen haben Vorrang. Bei Namensgebung, neuen Versionen, mehreren Seiten oder Diagrammaufteilung die Anleitung Zeichnungs- und Dateikonventionen lesen.

Sitzungs- und Objektoperationen

• MCP-Operationen basierend auf dem Inhalt und Design der aktuellen Aufgabe ausführen. Wenn erforderliche Eingaben nicht abgeleitet werden können, nur diejenigen fehlenden Angaben bestätigen, die das Operationsobjekt oder -ergebnis verändern würden.
• Bevorzugt bereits bestätigte Zielsitzungen wiederverwenden. Wenn wirklich eine neue Sitzung erstellt oder wiederhergestellt werden muss, start_session aufrufen, um die Werkzeugformate und Operationsbeschränkungen auszulesen. Fehlen diese Informationen, get_drawing_guide verwenden. Eine Verbindungsprüfung erfordert keine neue Sitzung.
• Bei vorhandenen Dateien nach load_diagram zuerst get_diagram ausführen, um Objekt-IDs zu lesen, dann über edit_diagram nach ID ändern. Bei bekannter und noch gültiger aktueller Leinwand können lokale Änderungen direkt vorgenommen werden. Bei Konflikten durch gleichzeitige Änderungen die Bearbeitung basierend auf den neuesten vom Dienst zurückgegebenen Inhalten neu organisieren, ohne die neuen Änderungen des Benutzers zu überschreiben.
• load_diagram und create_new_diagram ersetzen das aktuelle Dokument. Vor dem Wechsel prüfen, ob die aktuelle Leinwand das Ziel ist und ob manuelle Änderungen erhalten werden sollen. Wenn der Benutzer das Speichern aktueller Änderungen anfordert, direkt die aktuelle Leinwand lesen und exportieren, ohne vorher die alte Datei von der Festplatte zu laden.
• create_new_diagram nur für neue Diagramme oder bei explizitem Ersatzwunsch des Benutzers verwenden. Alle .drawio / .drawio.svg Schreib- und Änderungsvorgänge erfolgen über MCP; das Diagramm-XML nicht mit Dateiwerkzeugen oder Skripten direkt überschreiben. Das Erstellen von XML-Parametern gemäß Werkzeuganforderungen ist normaler Aufruf.
• Text, Knoten, Beziehungen und Gruppierungen bleiben editierbar; Materialien können eingebettet werden, aber das gesamte Diagramm darf nicht durch ein flaches Bild ersetzt werden, das die editierbare Quelldatei ersetzt.
• Vor der Verwendung von Symbolen wie Cloud-Diensten oder Netzwerkgeräten get_shape_library aufrufen und die zurückgegebenen echten Stilnamen verwenden; Symbolnamen nicht erraten.
• Bei mehrseitigen Diagrammen zuerst list_pages aufrufen, um das Ziel zu bestimmen, und explizit den Seitenauswahlparameter verwenden, nicht auf die Standard-Startseite verlassen. Wenn der Benutzer "diesen Rahmen" oder "den ausgewählten Pfeil" sagt, kann get_selection verwendet werden. Wenn die Auswahl nicht verfügbar ist, die Leinwand lesen und nach Seite, Beschriftung und Position lokalisieren. Erst bei mehreren Kandidaten konkret nachfragen, den Dienst nicht neu laden oder wiederholt zur Neuselektion auffordern.

Bilder und Größenbeschränkungen

Vor dem Einfügen von Bildern die Anleitung Bildvorverarbeitung und Größenbeschränkungen lesen. Zuerst das Material und die voraussichtliche Einbettungsgröße prüfen, ggf. eine Kopie komprimieren: Fotos erlauben moderate Skalierung und verlustbehaftete Kompression, Text, feine Linien und transparente Materialien bevorzugt verlustfrei. Originalmaterial nicht überschreiben, keine Vorverarbeitungssoftware automatisch installieren.

Das Budget muss echtes Base64, vollständiges Diagramm-XML, serialisierte Anfragen und Export-Rückübertragung abdecken. get_diagram kann Bilddaten reduzieren; die Länge des zurückgegebenen Textes beweist nicht, dass das Diagramm die Grenze nicht überschritten hat. Nach dem Einfügen großer Materialien frühzeitig über MCP einen Probeexport durchführen; Erstellung, Änderung und Export der vier Formate nur über MCP, nicht mit anderen Werkzeugen ergänzen und keine nicht verfügbaren Parameter wie width, height, scale erfinden.

Wenn nach Komprimierung auf akzeptable Klarheit immer noch Hindernisse bestehen, erfolgreiche Ergebnisse erhalten bleiben, den Engpass erläutern, und der Benutzer entscheidet über weitere Komprimierung, Materialentfernung oder Diagrammaufteilung; Inhalte oder Seiten nicht automatisch ändern.

Speichern und Exportieren

1. Vor dem Speichern mit get_diagram die aktuelle Leinwand lesen, die entsprechende Datei, Seite und den Ausgabepfad. Zuerst auf Synchronisationswarnungen prüfen; "Aufruf erfolgreich, aber möglicherweise fehlen neueste manuelle Änderungen" ist keine Bestätigung des aktuellen Zustands. Zuerst die Synchronisation wiederherstellen, dann formell exportieren. Wenn das Werkzeug die Datei bereits geschrieben hat, klarstellen, dass die Aktualität dieser Datei noch nicht verifiziert ist, und nach der Wiederherstellung erneut exportieren.
2. Über export_diagram die Datei .drawio speichern; vollständige mehrseitige Quelldatei ohne Seitenauswahlparameter. Standardmäßig auch PNG, SVG, editierbare .drawio.svg exportieren; wenn der Benutzer nur bestimmte Formate möchte, dies entsprechend tun. Bilder und editierbare SVGs mit explizit ausgewählter Zielseite exportieren, nicht auf die Browser-Aktivseite verlassen.
3. .drawio.svg tatsächlich im entsprechenden Format exportieren, nicht einfach eine normale SVG umbenennen. Den eingebetteten Diagrammquellinhalt überprüfen; vor sicherem Rücklesen die aktuelle Leinwand speichern. Bei mehreren Seiten die in dieser Kopie enthaltenen Seiten angeben; eine einzelne Seite nicht als vollständige Quelldatei ausgeben.
4. Nach dem Export die beobachtbaren Inhalte erneut lesen und auf Synchronisationswarnungen prüfen. Der Dienst hat keinen generellen Snapshot-Lock; wenn sich der Inhalt währenddessen ändert, erneut synchronisieren und die betroffenen Dateien exportieren, eine einmalige Lektüre nicht als Garantie für die Konsistenz aller vier Dateien betrachten. Bei fortlaufenden Änderungen oder fehlender Bestätigungsmöglichkeit die unvollständige Synchronisationsabnahme deutlich machen, ggf. den Benutzer bitten, manuelle Änderungen vorerst zu unterlassen.
5. Pfade als absolute Pfade in der tatsächlichen MCP-Laufzeitumgebung verwenden. Die Inhaltsintegrität und das Vorhandensein von Materialien in der Dateierstellung und endgültigen Darstellung überprüfen; ein Screenshot, der korrekt aussieht, bedeutet keinen erfolgreichen Export. Nur lesbares XML oder eine erfolgreiche Exportmeldung ersetzt nicht die tatsächliche Darstellungsprüfung.
6. Nach Wiederherstellung der Verbindung kann ein erneuter Versuch unternommen werden; bei eindeutigen Größenproblemen zuerst die Größe korrigieren, dann die betroffenen Schritte einmal wiederholen. Bei keiner Änderung nicht erneut aufrufen, bei weiterem Fehlschlagen den spezifischen Engpass und fehlende Formate erläutern. Detaillierte Speicherregeln in Zeichnungs- und Dateikonventionen.

Ergebnisse zurückmelden

Kurze Angabe von Quelldatei, Bildern, verwendeter Version und durchgeführten Prüfungen. "Konfiguration vorhanden", "Werkzeug antwortet", "Datei gespeichert", "Darstellung geprüft" jeweils wahrheitsgemäß angeben.

Wenn Bildexport oder visuelle Prüfung scheitert, zuerst erfolgreich gespeicherte Quelldatei aufbewahren, die fehlenden Formate und den genauen Grund angeben; keine alten Bilder als aktuellen Export ausgeben und nicht überprüfte Teile als abgeschlossen darstellen.