yokingma/flow-diagram

Flussdiagramm (Flow Diagram)

Flow Diagram ist der Autoren-Skill für ausführbare System- und Prozessdiagramme: einmal autorisieren, dann abspielen, einbetten, inspizieren und exportieren.

Verwandeln Sie Beschreibungen und Quellmaterial in visuelle Erklärungen: statische oder animierte Diagramme, die Strukturen, Beziehungen und Abläufe klar machen. Ziel ist es, die Bedeutung der Quelle zu bewahren und dem Leser zu helfen zu verstehen, wie Dinge organisiert, miteinander verbunden sind und sich im Laufe der Zeit verändern.

Aufgabe auswählen

Dieser Skill erzeugt Diagramm-Assets; PPTX-Dateien und native PowerPoint-Formen liegen außerhalb seines Aufgabenbereichs.

Identifizieren Sie den Aufgabentyp, die zu verwendende Eingabe und den Einstiegspunkt in den Prozess.

Anfrage	Ausgangspunkt
Neues Diagramm oder JSON-Import, das erstellt oder überarbeitet wird	Präferenz-Check (Preflight) vollständig durchführen, dann alle fünf Schritte befolgen. Unveränderte importierte Bytes bei Bedarf beibehalten.
Unveränderter JSON-Import für Export oder Inspektion	Export- oder Diagnose-Einstiegspunkt verwenden; Präferenz-Check überspringen und das eingegebene Design beibehalten.
Überarbeitung eines finalisierten Diagramms	Bestehendes Diagramm und Abschlussbericht lesen. Geforderte Änderungen und Umfang festlegen, Präferenz-Check vollständig durchführen, dann den fünfstufigen Prozess befolgen, dabei weiterhin gültige Designentscheidungen wiederverwenden. Angeforderte Formate weitertragen, sofern der Benutzer sie nicht ändert.
Nur Exportformate hinzufügen	In Schritt 3 mit dem bestehenden, unveränderten Diagramm einsteigen. Entwurf, Styling, Messung und Layoutänderungen überspringen, dann die angeforderten Dateien inspizieren und finalisieren.
Unerledigte Aufgabe fortsetzen	Aufgabenaufzeichnungen lesen und die gespeicherte Revision zum Fortsetzen auswählen. An den noch nicht abgeschlossenen oder von Änderungen betroffenen Schritten wieder aufnehmen.
Nur Validierung oder Diagnose	validate für strukturelle Prüfungen verwenden. Falls eine visuelle Diagnose gewünscht ist, die entsprechenden Inspektions-Workflows in Schritt 4 befolgen. Über die durchgeführten Prüfungen, deren Grenzen und gefundene Probleme berichten, dann anhalten.

Für eigenständige Speicher-, Änderungs- oder Zurücksetzungsanfragen Projektpräferenzen befolgen und den Vorgang melden, ohne ein Diagramm zu erstellen.

Für Importe, Überarbeitungen oder Exporte aus bestehenden Diagrammen Eingabe- und Elternauswahl lesen. Vor dem Erstellen von Aufgabendateien Aufgaben-Workspace-Anforderungen lesen; für Validierungsbefehle und Berichtsstatus Laufzeit- und Ergebniskontrakte lesen.

Fortfahren, wenn die Eingabe, die autorisierten Änderungen und der Prozesseinstiegspunkt klar sind.

Prozess

0. Designpräferenzen initialisieren

Für neue und überarbeitete Entwürfe Projektpräferenzen vor Schritt 1 befolgen. Dessen Preflight (Check) durchführen, indem relevante visuelle Entscheidungen getroffen und ihre Quellen dokumentiert werden; jegliche angeforderte Speicherung abschließen oder deren Fehlschlag offenlegen. Eigenständige Präferenzverwaltungsanfragen verwenden diese Referenz und enden nach der Meldung des Vorgangs. Reine Export-, Validierungs- und Diagnoseaufgaben behalten ihre bestehenden Einstiegspunkte bei. Unerledigte Aufgaben mit ihren aufgezeichneten Entscheidungen fortsetzen, den Preflight nur wiederholen, wenn sich eine relevante Wahl ändert.

1. Das Erklärungsziel definieren

Beginnen Sie mit der Frage des Lesers: Was soll der Leser nach dem Betrachten des Diagramms verstehen? Verwenden Sie diese Frage, um spätere Entscheidungen zu Inhalt, Layout und Animation zu leiten.

• Die Frage definieren. Subjekt identifizieren und was der Leser aus der Anfrage des Benutzers verstehen soll.

• Die Fakten ermitteln. Die vom Benutzer bestimmten Quellen oder das bestehende Diagramm innerhalb des autorisierten Umfangs lesen. Relevante Objekte, Beziehungen, Prozesse und Zustandsänderungen identifizieren. Bekannte Fakten von Informationen unterscheiden, die geklärt werden müssen, und Quellen durch Quellmetadaten dokumentieren.

  Für umfassende Untersuchungen, wie das Erkunden eines Code-Repositorys, einen Unter-Agenten (Sub-Agent) starten, um die für die Leserfrage relevanten Teile zu untersuchen. Dem Unter-Agenten die Frage und den autorisierten Quellumfang geben. Nach relevanten Objekten, Beziehungen, Prozessen und Zustandsänderungen mit Quellenorten und ungelösten Fragen fragen. Diese Ergebnisse verwenden, um die für die Erklärung benötigten Fakten zu ermitteln.

  Für einige wenige Artikel, eine kleine Menge Referenzmaterial oder eine kurze Anfrage wie „Erkläre den RAG-Workflow mit einem Flussdiagramm“ die Fakten in der aktuellen Sitzung ermitteln.

• Die Anforderungen aufzeichnen. Das Publikum, den Nutzungskontext und die vom Benutzer bereits spezifizierten Lieferanforderungen erfassen. Fehlender Lieferkontext befolgen, um bekannte Entscheidungen wiederzuverwenden, relevante Lücken einmalig zu sammeln und übernommene Annahmen vor der Wahl der Geometrie zu dokumentieren.

Fortfahren, wenn Sie die Leserfrage in einem Satz formulieren können und die Fakten identifiziert haben, die ihre Antwort stützen. Informationslücken klären, die die Bedeutung des Diagramms ändern würden, bevor mit dem Entwurf begonnen wird. Wenn das SDK die Anfrage nicht getreu abbilden kann, die Einschränkung erklären und auf die Wahl des Benutzers warten.

2. Die visuelle Erklärung entwerfen

Wählen Sie, wie das Subjekt präsentiert werden soll, sodass der Leser die in Schritt 1 definierte Frage beantworten kann.

Für neue oder überarbeitete Entwürfe Lieferkontexte vor der Wahl der Leinwand und Dichte lesen, auch wenn der Zweck unbekannt ist. Die Auswahltabelle nach Leserfrage für Fähigkeitsinventare, Verantwortlichkeiten, Ressourcenstatus, Anfragen und Antworten, Zustandsübergänge, Datenverarbeitung oder Architektur verwenden.

• Den Inhalt auswählen. Die für die Erklärung benötigten Objekte, Beziehungen, Prozesse und Zustände auswählen. Vor dem Weglassen oder Zusammenfassen von Inhalten oder der Entscheidung, wie unbekannte Quellinformationen dargestellt werden sollen, Quellentreue und Informationsentscheidungen lesen. Die Bedeutung der Quelle in diesen Entscheidungen bewahren.
• Inhalt seiner Oberfläche zuweisen. Vor der Diagrammgeometrie Inhaltsplatzierung befolgen, um Seitenüberschriften, diagrammgebundene Beschriftungen, Legenden und unterstützende Prosa zuzuweisen. Die Zuordnung und den für jedes angeforderte Format erforderlichen Kontext dokumentieren.
• Die Struktur organisieren. Gruppen, Hierarchie und Lesereihenfolge definieren, damit der Leser die Hauptpunkte identifizieren und ihren Beziehungen folgen kann.
• Die visuelle Richtung festlegen. Visuelles Design befolgen, um eine Richtung für den Nutzungskontext auszuwählen. Für geschichtete Strukturen mit Seitenleiste, Prozesse mit Verzweigungen oder Rückführungen oder wiederholte Karten mit längeren Inhalten ein passendes Kompositionsrezept auswählen. Die konkreten, für die Produktion erforderlichen Entscheidungen dokumentieren.
• Statische Diagramme oder Animation wählen. Statisches Layout verwenden, um Strukturen und Beziehungen zu erklären. Für Animation Persistente Beziehungsflüsse, Aufmerksamkeit und gestufte Änderung unterscheiden; eine Anfrage nach fließenden Linien kann das gesamte Diagramm sichtbar halten.
• Die Animationserzählung planen. Bei Verwendung von Animation Animationsrhythmus und visuelle Kontinuität befolgen, um das Erklärungsziel, die Zustandsänderungen, Übergänge und Lesepausen jeder Stufe zu definieren.

Fortfahren, wenn der Plan den ausgewählten Inhalt, seine tragenden Oberflächen, Gruppen, Lesereihenfolge, visuelle Entscheidungen und die statische oder animierte Darstellung dokumentiert. Für Animation den Stufenplan einschließen.

3. Das Diagramm erstellen

Setzen Sie den Entwurf aus Schritt 2 um und generieren Sie die für die Inspektion in Schritt 4 benötigten Artefakte.

Verwenden Sie Node 20+ und npm. Führen Sie node <skill-directory>/scripts/flowsvg.mjs aus dem vom Benutzer gewählten Arbeitsverzeichnis aus, bei Bedarf mit in Anführungszeichen gesetzten Pfaden. Tools und Aufgabenressourcen innerhalb dieses installierten Skills auflösen. Die CLI bereitet ihre eigene festgelegte SDK-Laufzeit vor, ohne Anwendungsabhängigkeiten zu ändern.

• Die relevante Autorenanleitung lesen. Für neue oder überarbeitete Entwürfe das Dokumentenmodell und Layout-Anleitung lesen und die ausgewählten Designrezepte implementieren. Vor der Anordnung der Geometrie Rendering-Fallstricke für kurze Pfade mit langen Beschriftungen, Seitenleisten, randlosen Texten, schmalen Karten oder Umbruchrisiken in jeder Sprache, optische Ausrichtung bei kurzen Beschriftungen, gemeinsam genutzte Lesekanten oder geänderte Inhaltsgrößen prüfen. Für Animation auch Szenen, vererbter Zustand und Timing lesen. Für angeforderte SVG-, PNG- oder GIF-Dateien Exportoptionen und -grenzen lesen.
• Das Diagrammdokument erstellen. Für neue oder überarbeitete Entwürfe die geplanten Objekte, Gruppen, Verbindungen, Texte und Animationsstufen implementieren. Die Quellsprache und die ausgewählte visuelle Richtung beibehalten. Für ein neues Diagramm ohne angegebene Richtung mit einem hellen Thema und abgerundeten Gruppen beginnen. Text im vollständigen Entwurf messen und dem Layoutplan-Workflow folgen, wenn wiederholte Geometrie einen Plan erfordert. Jedes Objekt, jede Beziehungsrichtung, jeden Eltern-Grenzbereich und jede Zustandsänderung mit den Quellen vergleichen. Autorisierte Änderungen in einem neuen Workspace-Entwurf speichern; für einen unveränderten Import oder Export die ausgewählten Eingabebytes direkt verwenden.
• Validieren und korrigieren. Schreibgeschütztes validate während der Iteration verwenden und jede Diagnose lesen. Es gibt exakte Eingabeidentität und endliche Prüfungen zurück, ohne eine Diagrammrevision zu erstellen; den Arbeitsentwurf behalten. Korrekturen innerhalb der aktuellen Autorisierung anwenden, dabei Diagnose- und Revisionsentscheidungen befolgen. Korrekturen, die die Bedeutung der Erklärung ändern würden, mit dem Benutzer klären.
• Die HTML-Seite zusammenstellen. Für neue oder überarbeitete HTML-Erklärungen Seiten-HTML/CSS für den außerhalb des Diagramms zugewiesenen Inhalt schreiben und über bearbeitbare HTML-Seiten einreichen. Für ein bestehendes Ergebnis Seitenfortsetzung befolgen, um sein Design zu bewahren und beabsichtigte Diagrammänderungen explizit zu synchronisieren. Den installierten Starter für neue Seiten verwenden, wenn nützlich; die verwaltete Player-Region intakt lassen und die vollständige Seite im Aufgaben-Workspace behalten.
• Inspektionsartefakte generieren. Vor der Browser-Aufnahme oder der Auswahl einer Vorschau-Stichprobenanzahl Browser-Vorbereitung und Sampling lesen. author verwenden, um das erforderliche Offline-HTML, benötigte Vorschauen und angeforderte Exportdateien zu erzeugen. author --browser none verwenden, wenn nur zwischenzeitliches HTML benötigt wird. Für mehrere benannte statische Zustände benannte Batch-Exporte befolgen; ausgewählte Zeitpunkte anhand tatsächlicher kompilierter Beats (Beats) mit dem Benutzer bestätigen, bevor das Manifest gebunden wird. Den Laufzeit- und Ergebniskontrakten für Einrichtung, SDK-Kompatibilität und Berichtsfelder folgen; CLI --help für Befehlsoptionen verwenden.

Fortfahren, wenn der Entwurf den Plan implementiert, ein unveränderter Input erhalten bleibt, blockierende Fehler behoben sind, verbleibende Diagnosen dokumentierte Bearbeitungsentscheidungen haben und alle für die Inspektion erforderlichen Dateien vollständig sind. Bei Exportfehlern die folgenden Wiederherstellungsregeln befolgen und abgeschlossene und unvollständige Dateien getrennt melden.

4. Das Ergebnis inspizieren

Für geliefertes SVG/PNG Bedarfsorientierten Artefaktnachweis befolgen: evidence gegen das explizit gespeicherte Subjekt ausführen, dann die Bilder anzeigen und unabhängig überprüfen. Vorhandene gültige Bedingungen werden wiederverwendet; neue Bedingungen bleiben ungesichtet, bis sie inspiziert wurden.

Das generierte Diagramm anzeigen und bestätigen, dass es das Subjekt genau und klar erklärt.

• Semantische Genauigkeit prüfen. Objekte, Beziehungsrichtungen, Gruppen-Grenzen und Zustandsänderungen mit den Quellen vergleichen. Bestätigen, dass Auslassungen und Zusammenfassungen die Quellenbedeutung bewahren.
• Visuelle Lesbarkeit prüfen. Tatsächlich gerenderte Bilder in der beabsichtigten Anzeigegröße anzeigen. Text, Abstände, Überlagerungen und Lesereihenfolge inspizieren. Jede relevante Verbindung von ihrer Quelle durch Kurven und Kreuzungen bis zu ihrer Pfeilspitze verfolgen; Anschlüsse, Beschriftungen und Abstand zu nicht verwandten Knoten prüfen.
• Visuelles Design bewerten. Visuelle Design-Inspektion befolgen, um sichtbare Mängel zu identifizieren und Beobachtungen für das endgültige Design-Urteil des Benutzers aufzuzeichnen.
• Die Animationserklärung prüfen. Für Animation Ausgangszustand, Schlüsseländerungen und Endzustand mit dem Stufenplan vergleichen. Vorschau-Inspektion für abgetastete Zustände befolgen. Tatsächliche Wiedergabe bei der Bewertung des Timings verwenden; eine reine Stichprobeninspektion als auf die betrachteten Zustände beschränkt melden.
• Die gelieferten Dateien prüfen. Das Tool das tatsächliche gespeicherte Offline-HTML öffnen lassen und seinen anfänglichen Pausenzustand, Steuerelemente, Offline-Anfragen und relevante Wiedergabezustände prüfen. Seine aufgenommenen Bilder durch den HTML-Inspektions-Workflow anzeigen. Angeforderte Exportdateien wie geliefert inspizieren; Zielgrößen-Artefakt-Inspektion für endgültige SVG/PNG-Dateien verwenden.

Vor dem Einreichen von Überprüfungen die vollständigen Überprüfungseingabekontrakte und den Vorlagen-Workflow lesen. Ein ungesichtetes Formular mit review-template aus dem expliziten Diagrammsubjekt und, für separaten formalen Nachweis, --evidence-from generieren, dann unabhängiges review für HTML, Vorschau und formale SVG/PNG-Beobachtungen verwenden und die IDs, Hashes, Beobachtungen und Probleme nur für tatsächlich betrachtete Bilder aufzeichnen. Die wiederholte Übermittlung einer Überprüfung erfordert keine weitere Diagrammversion. Wenn kein Browser oder Bildbetrachter verfügbar ist, die nicht durchgeführten Prüfungen und deren Auswirkungen explizit aufzeichnen.

Bei gefundenen Problemen zu Schritt 3 zurückkehren, um autorisierte Korrekturen anzuwenden, die Artefakte neu zu generieren und die betroffenen Dateien und Zustände erneut zu inspizieren. Diagnose- und Revisionsentscheidungen befolgen, wenn Probleme aufgezeichnet oder Änderungen mit dem Benutzer geklärt werden.

5. Finalisieren

Wenn das Ergebnis die Anforderungen erfüllt: das Diagramm einfrieren (freeze), Versions-Tags vergeben und den Abschlussbericht für das Diagramm und die Begleitseite generieren.

• Das Diagramm einfrieren. Das unveränderliche Diagrammdokument in den Ordner des Abschlussberichts kopieren, ID, Diagramm- und Seiten-Hashes im Bericht aufzeichnen. Für ein vorhandenes unverändertes Diagramm bestätigen, dass seine gespeicherte Version im Bericht aufgezeichnet ist.
• Ausgabedateien sichern. Angeforderte Exportformate generieren und im Abschlussbericht mit den entsprechenden Hashes auflisten. Für vorhandene unveränderte Exporte bestätigen, dass ihre Hashes im Bericht aufgezeichnet sind.
• Den Abschlussbericht generieren. Das Berichts-HTML schreiben; das Diagramm und die Seite enthalten zum Zeitpunkt des Einfrierens, generierte Exporte, Sitzungsentscheidungen und zulässige Wiederverwendungsformate. Den Bericht im Aufgaben-Workspace speichern.
• Den Vorgang bestätigen. Den Abschlussbericht überprüfen, die Aufgabe als erledigt melden und dem Benutzer die Ergebnisse mitteilen, einschließlich einer Zusammenfassung der wichtigsten Entscheidungen, Exportpfade und Wiederverwendungsmöglichkeiten.

Hinweise

1. Quellentreue: Jede Darstellung muss die Bedeutung der Quelle bewahren. Bei Klärungsbedarf zuerst mit dem Benutzer abklären, nicht raten. Wenn das SDK die Anfrage nicht getreu abbilden kann, melden und auf Benutzereingabe warten.
2. Dokumentierte Autorität: Alle Änderungen am Diagramm, an der Seite oder an den Exporten müssen autorisiert sein. Unautorisierte Änderungen oder solche außerhalb des Aufgabenbereichs nicht vornehmen (keine PPTX-Erstellung, keine native PowerPoint-Formen).
3. Fehlerbehandlung bei Export: Wenn ein Export fehlschlägt, auf einer minimalen Arbeitskopie erneut versuchen. Wenn es immer noch fehlschlägt, die Ausgabe vom fehlgeschlagenen Befehl (stdout/stderr) und die letzte bekannte gültige Diagrammrevision dem Benutzer melden, damit Fehler behoben werden können.
4. Keine Designauswahl durch den Benutzer ersetzen: Wenn der Benutzer Designentscheidungen (Farben, Layout, Animation) spezifiziert hat, diese respektieren, es sei denn, sie verletzen die Quellentreue oder sind technisch undurchführbar – in diesem Fall dies erklären.
5. Wiederverwendung des Abschlussberichts: Der Abschlussbericht dient als autoritativer Datensatz für die zukünftige Wiederverwendung, einschließlich JSON-Import/Export, Offline-HTML-Wiedergabe und SDK-Einbettung.