Was macht HTML-Ansicht?
node <skill-dir>/scripts/htmlview ist der plattformübergreifende Befehlseinstieg; nachfolgend mit htmlview abgekürzt. Erfordert Node.js 22+; Browserprüfung, Screenshots, Export und eigenständiges Rendern von Grafiken benötigen zusätzlich Chrome oder Chromium. Wird kein Browser gefunden, erfolgt die Behandlung gemäß error.next.
Vorhandenes HTML: Nur das Theme wechseln
- htmlview-Artefakte: Dokumente, Berichte oder einzelne Grafiken werden mit
htmlview style file.html --theme cloudmusicgestylt (htmlview style --listzeigt verfügbare Themes); für UI-Entwürfe werden--schemeoder--brandverwendet.styleaktualisiert direkt, nur das Gerüst und abgeleitete Grafiken werden neu zusammengesetzt. Für eine neue Datei kopiere zuerst eine unbenutzte Datei im selben Ordner, führestyleauf der Kopie aus und vergleiche dann mithtmlview diff. - Normales HTML:
styleakzeptiert kein normales HTML. Wenn eine Skill-Hülle benötigt wird, erstelle ein neues Themendokument (siehe Dokument-Workflow und Dokument-Komponenten) und migriere den vorhandenen Inhalt in die neue Datei; übernimm nicht das CSS und die Skripte der alten Hülle. Wenn nur der Stil geändert wird, behalte die ursprünglichen Ziffern, Zeitgranularität und Schlussfolgerungen bei, berechne Daten nicht neu und entferne keine Details aus der ursprünglichen Grafik, um die Anzeigeprüfung zu bestehen.
Auswahl nach Aufgaben
| Gewünschtes Ergebnis | Vorgehen | Wann erweitern |
|---|---|---|
| Leicht lesbare und annotierbare technische Konzepte, Berichte, Erläuterungen, Protokolle oder einseitige Zusammenfassungen | Bei vorhandenem Markdown: doc build; bei direkter HTML-Bearbeitung: doc new | Zuerst Dokument-Workflow lesen; beim händischen Schreiben von HTML-Komponenten, Hinzufügen von Querverweisen oder Verarbeiten von Kommentaren Dokument-Komponenten lesen |
| Zu prüfende Geschäftszahlen, Kennzahlen und Diagramme als Bericht oder Dashboard | Aus Upstream-Zusammenfassungsdateien ein Datenpaket erstellen; nach data validate data build ausführen | Zuerst Bericht-Workflow lesen; beim Ändern von Feldern, Metriken, Grafiken oder Erläuterungen Datenpaket lesen; beim Erstellen eines Dashboards Dashboard-Design lesen |
| Wireframes, hochauflösende Entwürfe oder Prototypen zur Darstellung von Bildschirmen, Zuständen oder Interaktionsabläufen | ui new ausführen, dann jeden Bildschirm mit echten Steuerelementen ausfüllen | Zuerst UI-Workflow lesen; bei der Auswahl von Komponenten oder dem Schreiben von Interaktionen Komponentenindex lesen; bei der Festlegung von Layout, Farbpalette oder dem händischen Schreiben von Komponenten UI-Design lesen; bei der Erstellung eines Daten-Dashboards Dashboard-Design lesen |
| Einzelnes SVG oder offline-fähige Grafikseite | Untere Tabelle der Diagrammfamilie auswählen, Deklaration schreiben, dann viz render | Bei Datengrafiken zuerst Allgemeine Deklaration lesen, dann die ausgewählte Diagrammfamilie; bei Strukturdiagrammen direkt die entsprechende Diagrammfamilie lesen |
| Lokales HTML lesen, prüfen, screenshoten oder exportieren | read, check, shot, export oder embed verwenden | Parameter und Prüfergebnisse siehe Anzeige und Export |
- Wenn das Ausgangsmaterial keine fertige Seitenstruktur ist (z. B. lose Notizen, Besprechungsmitschriften, JSON, CSV, Logs oder umsortiertes Markdown), lies vor dem Schreiben des Inhalts Vom Material zur Seite.
- HTML-Artefakte sind einzelne, offline-öffnbare Dateien. Beim händischen Schreiben nur den Titel und den Inhalt zwischen
<!-- htmlview:content -->und<!-- /htmlview:content -->ändern; jede der beiden Markierungen bleibt einmal erhalten. Layout, Theme und Laufskripte werden von der CLI zusammengesetzt. - Ändere bei aus Markdown erstellten Dokumenten die Markdown-Quelle; bei Datenberichten das Datenpaket, nicht den generierten Text, die Grafiken oder Zahlen. Fehlt eine Quelle, dürfen keine Daten erfunden werden; Demodaten müssen als fiktive Beispiele gekennzeichnet sein.
- Um bereits vorhandene eigenständige Ergebnisse zu überschreiben, muss
--forcenur nach Bestätigung des Ziels verwendet werden; bei Aktualisierungen desselben Quell-Dokuments ist--forcenicht erforderlich. - Wird
--langnicht übergeben, leiten die Generierungsbefehle die Sprache für Hülsenelemente (Bildnummern, Inhaltsverzeichnis, Legenden) aus Titel und Fließtext ab: Die Sprache ist Englisch, wenn die Anzahl der englischen Wörter mindestens doppelt so hoch ist wie die Anzahl der chinesischen/japanischen/koreanischen Zeichen; andernfalls Chinesisch. Bei anderen Sprachen oder gemischtem Inhalt wird--langexplizit übergeben.
Auswahl des Diagramms nach Leserfrage
Standardmäßig werden statische Diagramme verwendet. Datengrafiken werden mit KChart JSON erstellt; Strukturbeziehungen mit Mermaid oder nativen Deklarationen. Lies zuerst Allgemeine Regeln für Konfiguration, Stil, Links und Diagnose, dann das entsprechende Diagramm; KChart übernimmt nicht das Aussehen von Mermaid. Gib nur Daten, Semantik und Leseabsicht an, keine Koordinaten, Schriftgrößen, Farben oder Zeichnungsskripte. Diagramme können bei Bedarf scrollbar sein; die Seite selbst sollte nicht horizontal überlaufen.
| Leserfrage | Diagrammtyp-Einstieg | Bei Bedarf lesen |
|---|---|---|
| Wie verändert es sich, wann ändert es sich? | line, area, sparkline, small-multiples, stream, combo, bump, candlestick, launch-fan | Trends |
| Welches ist größer, wie groß ist die Differenz, wie weit vom Ziel entfernt? | bar, column, dumbbell, slope, bullet, gauge, interval, split-compare | Vergleich |
| Wie setzt sich die Summe zusammen, wie viel geht in den einzelnen Schritten verloren? | share, pie, donut, radial-share, rose, funnel, waterfall, waffle, tally, treemap, sunburst | Zusammensetzung |
| Wie sind die Werte verteilt, gibt es Ausreißer oder Korrelationen? | histogram, boxplot, violin, strip, scatter | Verteilung |
| Wo gibt es Anomalien in einer mehrdimensionalen Matrix oder im Kalender? | heatmap, bubble-matrix, calendar, radar, parallel | Matrix |
| Wer ist mit wem verbunden, wie fließen die Mengen? | network, sankey, threads | Netzwerk |
| Wo sind sie verteilt? | choropleth, geo-scatter | Karten |
| Wie klassifizieren, wie von einem Thema aus verzweigen? | KChart tree, mindmap; Mermaid mindmap, ishikawa, treeView-beta | Hierarchie und Mindmap |
| Wie ist der Ablauf von wem zu wem, wie wechseln die Zustände? | flowchart, stateDiagram-v2, journey, swimlane-beta, eventmodeling, agentflow-beta, nativ swimlane | Abläufe |
| Wer ruft in welcher Reihenfolge an und wer ist beteiligt? | sequenceDiagram, usecase-beta | Sequenz |
| Wie planen, spalten oder nummerieren? | gantt, timeline, gitGraph, kanban, packet, quadrantChart | Zeit und Raster |
| Wie hängen Entitäten, Klassen oder Anforderungen zusammen? | erDiagram, classDiagram, requirementDiagram | Datenmodell |
| Wie passt eine Syntaxregel zu Symbolen? | railroad-beta, railroad-ebnf-beta, railroad-abnf-beta, railroad-peg-beta | Datenmodell |
| Wie ist das System geschichtet, wo sind Container und Abhängigkeiten? | C4Context, C4Container, C4Component, C4Dynamic, C4Deployment, architecture-beta, block, wardley-beta, nativ layers, blocks | Architektur |
| Einseitige Übersicht: Karten in Gruppen, Hauptablauf und Legende? | Nativ blocks (Karten, Badges, Legenden, Hervorhebungslinien); bei vorhandenen Mermaid-Blockdiagrammen block | Architektur |
| Vorhandene Mermaid-Datendiagramme? | pie, xychart, sankey, radar-beta, treemap | Mermaid-Datendiagramme; für neue Datengrafiken die obigen KChart-Diagrammtypen verwenden |
| Wie überschneiden sich Mengen, wie werden Kontexte kategorisiert? | venn-beta, cynefin-beta | Mengen, Kontexte |
| Aufrufdiagramm mit ZenUML-Syntax? | zenuml (natives KChart-Rendering, kein externes Plugin erforderlich) | ZenUML |
| Nur Rendering-Version prüfen? | Mermaid info (nicht für die Auslieferung) | Mermaid-Allgemeines |
Markdown verwendet kchart, mermaid, layers, blocks, swimlane-Umgebungen; händisches HTML verwendet <pre data-viz="syntax">, wobei HTML-Sonderzeichen escaped werden. Diagrammtitel werden in der Deklaration geschrieben: KChart title, Strukturdiagramm-Prolog title: oder die von der Syntax unterstützte Titelaussage. Diagrammtitel und Text im Diagramm verwenden dieselbe Sprache wie der Fließtext. Wenn integrierte Diagrammfamilien nicht ausreichen oder sich nicht ausdrücken lassen (z. B. zu tiefe Verschachtelung, zu viele Beziehungen oder Mechanismus-Skizzen), zerlege zuerst in Gesamt- und Teildiagramme; wenn noch Handzeichnung erforderlich, lies Handgeschriebenes SVG.
Kurzbefehle
| Was tun | Befehl |
|---|---|
| Dokument entwerfen/aus Quelle generieren | htmlview doc new plan.html --type plan --title 'Kapazitätsplan' oder htmlview doc build spec.md --out spec.html --type tech-spec |
| Datenpaket und Bericht | htmlview data init example → htmlview data validate example/report.json → htmlview data build example/report.json --out report.html |
| UI-Entwurf-Grundgerüst | htmlview ui new prototype.html --title 'Antragsbearbeitung' --device mobile --screens 'Liste,Details' |
| Statische Prüfung, Inhaltsvergleich | htmlview audit file.html; htmlview diff old.html new.html |
| Grafikmodule für Dokument oder UI-Entwurf neu laden | htmlview style file.html (behält vorhandenes Theme und Inhalt) |
| Anzeigeprüfung, Screenshot, Export | htmlview check file.html; htmlview shot file.html --select 'figure'; htmlview export file.html --format pdf; ganzseitiges Langbild htmlview export file.html --format png |
| Fließtext lesen, lokale Ressourcen einbetten | htmlview read file.html [--outline oder --section id]; htmlview embed file.html |
| Eigenständige Grafik, Feld-Einschränkungen, Theme-Farben, handgezeichnetes Diagramm-Maß | htmlview viz render spec.json --out chart.svg; htmlview viz schema bar; htmlview viz palette --theme paper; htmlview viz measure 'Auftragsservice' --size 13 |
Wenn der Benutzer eigene Farben mitbringt, verwende --theme-file <JSON>; Felder und Beispiele siehe Themendatei. Das Theme wird in HTML eingebettet; UI-Entwürfe verwenden eigenständige Markenfarben.
htmlview <Unterbefehl> --help gibt die genauen Parameter aus. pass:false bei Prüfbefehlen bedeutet, dass die Prüfung abgeschlossen wurde, aber Probleme festgestellt wurden; behebe sie gemäß failures[].fix. ok:false bedeutet, dass der Befehl nicht abgeschlossen werden konnte; behandele gemäß error.next.
Validieren vor Auslieferung
- Führe nach Erstellung oder Änderung eines Artefakts
auditaus. Fehlt ein Grafikmodul, führestylezur Neuzusammenstellung aus und prüfe erneut; bei Inkonsistenzen im Beleg des Berichts korrigiere im Datenpaket. - Führe bei änderungsrelevanten Anzeigeänderungen
checkund dannshotaus, um den tatsächlichen Screenshot zu öffnen. Prüfe Titel-Hierarchie, Text-Zuordnung, Leerraum und den ersten Bildschirm auf Mobilgeräten; öffne bei breiten Grafiken das vollständige SVG zur Überprüfung. Klicke bei Prototypen mit Interaktion tatsächlich die kritischen Pfade durch. - Öffne bei PDF-Auslieferung das tatsächliche PDF und überprüfe, ob Bildtitel und Bild auf derselben Seite sind und die Ränder vollständig sind. Bei Druckhinweisen wähle ein geeignetes Papierformat oder passe das Layout an, behalte eine lesbare Schriftgröße bei; wenn ein vollständiger Druck nicht möglich ist, dokumentiere die Einschränkung.