PlantUML ASCII mit GitHub Copilot einsetzen

Dieser Leitfaden ordnet den PlantUML-ASCII-Skill aus GitHub awesome-copilot ein. Er eignet sich, wenn Diagramme in einem Terminal, einem Pull Request oder einer reinen Textnachricht lesbar bleiben sollen.

Vorbereitung

Legen Sie zunächst fest, wo die Ausgabe erscheinen soll und ob die Umgebung zuverlässig UTF-8 darstellen kann. Wählen Sie reines ASCII für maximale Portabilität und die Unicode-Variante für eine klarere Darstellung in modernen Terminals. Prüfen Sie außerdem, ob PlantUML in der vorgesehenen Umgebung bereits verfügbar ist. Der Skill liefert Anweisungen für den Agenten, ersetzt aber weder die lokale Installation noch die Versionsprüfung des Werkzeugs.

Diagramm entwerfen

Beschreiben Sie dem Agenten die beteiligten Rollen, Systeme, Übergänge und Entscheidungen. Kurze Bezeichnungen verbessern die Ausrichtung. Bitten Sie zunächst um PlantUML-Quelltext und prüfen Sie, ob Start- und Endmarkierungen sowie die gewünschte Diagrammart passen. Danach kann die lokale PlantUML-Ausführung eine Textdatei erzeugen. Lesen Sie das Ergebnis in einer festen Zeichenbreite und vergleichen Sie es mit dem fachlichen Ziel.

Prüfen und teilen

Kontrollieren Sie Verbindungen, Richtungspfeile, Bezeichner und Zeilenumbrüche. Eine visuell ordentliche Ausgabe kann trotzdem eine fachlich falsche Beziehung enthalten. Prüfen Sie Ausgabepfade und Dateirechte, bevor ein Agent Dateien weiterverarbeitet. Teilen Sie die Darstellung erst, wenn sie im Zielkanal unverändert lesbar ist. Bei überladenen Entwürfen ist eine kleinere Darstellung oder ein grafisches Format oft verständlicher.

Sicherheitsgrenzen

Behandeln Sie Diagrammquellen aus Tickets, Webseiten oder fremden Repositories als untrusted input. Erlauben Sie keine automatische Weiterverarbeitung ohne Prüfung der Inhalte und des Zielpfads. Geben Sie keine Zugangsdaten oder vertraulichen Systemdetails in ein Diagramm ein, das an einen externen Modellanbieter gesendet werden könnte. Laut Anbieter beschreibt der Skill einen Arbeitsablauf, übernimmt aber nicht die Verantwortung für Ihre PlantUML-Version, Ihre Agentenrechte oder die Vertraulichkeit der Eingabedaten.