Communitygithub.com

chuspeeism/dashiAI-ppt-skill

Ein KI-Agenten-Skill, der browserbearbeitbare Präsentationen aus mehreren visuellen Themen erzeugt und als HTML, PDF und PPTX exportiert.

Was ist dashiAI-ppt-skill?

DashiAI PPT ist ein KI-Agenten-Skill, der aus Benutzereingaben statische, horizontal umblätterbare HTML-Präsentationen generiert. Es unterstützt eine Vielzahl von visuellen Themen (z. B. Code-Stile, gläserne Candy-Designs oder Finanz-Dashboards) und exportiert die Ergebnisse als HTML, PDF oder PPTX. Der Skill fungiert als Vorlagen-Orchestrator: Er analysiert die natürliche Sprache des Benutzers, erstellt einen JSON-Plan und ruft einen lokalen Generator auf, der `index.html` und `assets/` im Arbeitsverzeichnis erzeugt. Er ist für Plattformen wie Claude Code, Cursor und Codex konzipiert und setzt Node.js 18+ und npm voraus. Der Workflow umfasst die Auswahl des passenden Themas (z. B. per `layout:query`), das Befüllen von Text- und Medienfeldern gemäß Vorlagenkontrakt, die Validierung mit `validate:goal-spec`, `validate:swiss` und `validate:goal-copy` sowie die abschließende Auslieferung über einen lokalen HTTP-Preview-Server oder einen Export-Befehl. Der Skill vermeidet unnötige visuelle Nachbearbeitung und Browser-Smoke-Checks, es sei denn, der Benutzer fordert explizit eine Überarbeitung an.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add chuspeeism/dashiAI-ppt-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

DashiAI PPT

DashiAI PPT generiert statische, horizontal umblätterbare HTML-Präsentationen. Bei Verwendung dieses Skills wird der natürliche Sprachbedarf des Benutzers zuerst in einen JSON-Plan umgewandelt, dann wird der lokale Projektgenerator aufgerufen, um index.html und assets/ auszugeben.

Version

Aktuelle Version: 0.1.26

Vor der endgültigen Antwort nach jeder abgeschlossenen Benutzeranfrage ausführen:

node <skill-root>/scripts/check_latest_version.mjs

Wenn das Skript eine Ausgabe hat, diese am Ende der endgültigen Antwort anhängen, um den Benutzer an ein Update zu erinnern; wenn das Skript keine Ausgabe hat oder die Prüfung fehlschlägt, still bleiben und die Versionsprüfung nicht erwähnen.

Skill-Verzeichnis

Das Verzeichnis, in dem sich SKILL.md befindet, ist das Skill-Stammverzeichnis, im Folgenden als <skill-root> bezeichnet.

Verzeichnis des integrierten Generators:

<skill-root>/project

Render-Skript:

<skill-root>/scripts/render_goal_deck.sh

Versionsprüf-Skript:

<skill-root>/scripts/check_latest_version.mjs

Generierungsprinzipien

Dieser Skill ist ein Vorlagen-Orchestrator. Das Standardziel ist es, Benutzeranforderungen schnell und stabil in registrierte Seitenkomponenten einzufügen und eine offline-öffnbare HTML-Präsentation auszugeben.

Der Standardmodus ist „Vorlage sperren, Text befüllen“: Die ursprüngliche Optik, Struktur, Anzahl, Sichtbarkeit, Hervorhebungen, Farbgebung, Diagrammtypen und Bildplätze der ausgewählten Seitenkomponenten werden beibehalten; nur sichtbarer Text wird ersetzt. Ändern Sie keine Nicht-Text-Props, es sei denn, der Benutzer fordert ausdrücklich eine Anpassung der Seitenattribute an.

Standardmäßig wird keine visuelle Verfeinerung vorgenommen, keine Screenshot-Ästhetik beurteilt und wegen gewöhnlicher Zeilenumbrüche oder lokaler Unvollkommenheiten im Layout wird nicht wiederholt nachgearbeitet. Nur wenn der Benutzer ausdrücklich „visuelle Verfeinerung“, „100 % Prüfung“ oder „helfen Sie mir, es zufriedenstellend zu machen“ verlangt, wird in den visuellen QA-Prozess eingestiegen.

Verwendungsregeln

  • Für den Generator wird Node.js 18+ und npm benötigt; bei der ersten Generierung installiert das Render-Skript Abhängigkeiten im Skill-internen project/-Verzeichnis.
  • Stilauswahl-Frage: Die für den Benutzer sichtbare Antwort muss das Markdown-Bild von <skill-root>/assets/skill/theme-style-grid.png einbetten, zuerst den absoluten Pfad angeben; dies ist ein für die Antwortanzeige integriertes Stilbild, das nicht in goal.json oder in ein Medienfeld geschrieben werden darf. Die aktuell verfügbaren Stile und die Kurzbeschreibung „geeignet für/Zielgruppe“ auflisten; das Stilbild nur in der internen Statusmeldung erwähnen.
  • Vor Beginn zwei Dinge klären: Themenstil und ob Bilder/Videos benötigt werden. Wenn der Benutzer sich nicht klar geäußert hat und es sich nicht um eine Gesamtdelegation handelt, zuerst fragen und auf Antwort warten; keine Auswahl im Namen des Benutzers treffen. Nur in Umgebungen, in denen keine Fragen gestellt werden können (Skripte/Stapelverarbeitung), selbst auswählen und in der Lieferbeschreibung die Auswahl und die Begründung auflisten.
  • Delegationsmodus: Nur wenn der Benutzer das Ganze ausdrücklich delegiert („alles von dir entscheiden lassen“, „nicht fragen, leg los“), dann selbst Thema, Standard-HTML und standardmäßig keine Bildgenerierung wählen; in der endgültigen Erklärung die Annahmen nennen. Wenn der Benutzer nur sagt, dass Inhalt/Text „beliebig“ oder „selbst formuliert“ sein soll, nur den Inhalt selbst verfassen; Stil, Seitenanzahl, Medien usw., die bereits angegeben wurden, dürfen nicht eigenmächtig geändert werden; nicht angegebene Punkte gemäß vorheriger Regel zuerst erfragen.
  • Nicht-interaktive/einmalige Ausführung (keine Rückfragen möglich): Wenn kein Stil angegeben ist, selbst ein bereits akzeptiertes Thema basierend auf dem Inhaltsthema auswählen; wenn keine echten Medien vorhanden sind und keine Bildgenerierung möglich ist, vorzugsweise Seiten ohne Medien auswählen; keine Bildgenerierung aufrufen; in der endgültigen Erklärung alle Annahmen nennen.
  • Lieferformat: Standardmäßig HTML; „Präsentation erstellen“, „PPT erstellen“, „eine PPT erstellen“, „PPT machen“ bedeuten eine Präsentationsform. Nur bei ausdrücklicher Angabe PPTX, PowerPoint, „bearbeitbares PPTX“, „PPTX exportieren“, „PPT-Format“ oder „Format/Dateityp PPT/PPTX“ wird eine PPTX-Datei geliefert.
  • PPTX-Dateien: Zuerst wird immer HTML generiert und ein lokaler Vorschaudienst gestartet, dann wird der lokale HTTP-Exportdienst aufgerufen; am Ende wird nur der Dateipfad der PPTX oder das Download-Ergebnis zurückgegeben.
  • Aktuell verfügbare Stile: theme01 Leichtes Neumorphismus-Design, theme02 Leuchtendes Lila-Grün-Design, theme03 Hell-Dunkel-Code-Design, theme04 Glas-Bonbon-Design, theme05 Spektrum-Diagramm-Design, theme06 Dunkles Diagramm-Design, theme07 Kaltweiß-Recherche-Design, theme08 Schwarz-Gold-Experiment-Design, theme09 Dunkelblau-Magazin-Design, theme10 Gold-Index-Design, theme11 Hochenergie-Wachstums-Design, theme12 Schallwelle-Neon-Design.
  • Bei normaler automatischer Auswahl wird theme10 nicht gewählt; nur wenn der Benutzer es ausdrücklich angibt oder der Inhalt stark mit Finanz-/Investitionsindizes zusammenhängt und die Prüfung (inspect) die Befüllbarkeit bestätigt, wird es verwendet.
  • theme01 Leichtes Neumorphismus-Design | Geeignet für: Produktpräsentation / Unternehmensbericht | Zielgruppe: Startup-Teams / Produktmanager
  • theme02 Leuchtendes Lila-Grün-Design | Geeignet für: Tech-Launch-Events / KI/Autonomes-Fahren/Roboter-Themen | Zielgruppe: Tech-Gründer / Technische Leiter
  • theme03 Hell-Dunkel-Code-Design | Geeignet für: Technische Konzepte / Entwicklerkonferenzen | Zielgruppe: Ingenieure / Technische Führungskräfte
  • theme04 Glas-Bonbon-Design | Geeignet für: Junge Marken / Konsumgüter | Zielgruppe: Markenteams / Designer
  • theme05 Spektrum-Diagramm-Design | Geeignet für: Datenberichte / Marktanalysen | Zielgruppe: Datenanalysten / Unternehmensberater
  • theme06 Dunkles Diagramm-Design | Geeignet für: Hochdichte Datenpräsentation / Strategieanalyse | Zielgruppe: Strategieteams / Investoren
  • theme07 Kaltweiß-Recherche-Design | Geeignet für: Forschungsberichte / Whitepaper | Zielgruppe: Forschungseinrichtungen / Beratungsteams
  • theme08 Schwarz-Gold-Experiment-Design | Geeignet für: Hochwertige Releases / Markenvorschläge | Zielgruppe: Premium-Marken / Creative Directors
  • theme09 Dunkelblau-Magazin-Design | Geeignet für: Markengeschichten / Personeninterviews | Zielgruppe: PR-Teams / Medienredakteure
  • theme10 Gold-Index-Design | Geeignet für: Finanzdaten / Investmentberichte | Zielgruppe: Investmentinstitutionen / Finanzanalysten
  • theme11 Hochenergie-Wachstums-Design | Geeignet für: Wachstums-Reviews / Geschäftspläne | Zielgruppe: Unternehmer / Growth-Teams
  • theme12 Schallwelle-Neon-Design | Geeignet für: Musik & Unterhaltung / Trend-Events | Zielgruppe: Entertainment-Marken / Eventplaner
  • Keine alten Tokens, alten Themen, alten Mediensteckplätze, alten Stil-Branches oder alten Eintrittsanimationen verwenden.
  • Seitenauswahl zuerst mit npm --prefix <skill-root>/project run layout:query -- --theme <themePack> --role <role> --limit 8 durchführen; bei Bedarf nach Mediensteckplätzen --needs-media, --planned-images <n>, --provided-images <n> oder --image-gen hinzufügen.
  • Bei unklaren Feldern, Objekten/Arrays/Counts, Bildern/Medien: zuerst npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...> ausführen; zum Schreiben von Objekten, Arrays, Counts oder Bild-Props props:safe verwenden; für die gesamte Zielvorgabe props:safe -- --goal <file> --write.
  • Wenn das JSON von layout:query / inspect:layout zur Programmauswertung verwendet wird, stattdessen node <skill-root>/project/scripts/layout-query.mjs / node <skill-root>/project/scripts/inspect-layout.mjs verwenden: npm run gibt vor stdout einen Lebenszyklus-Banner aus, der das JSON verunreinigt.
  • Lange Decks: Zuerst mit npm --prefix <skill-root>/project run goal:scaffold -- --title <title> --goal <goal> --theme <themePack> --pages <n> --chunk-size 5 --out output/<deck-name>/goal.json ein eindeutiges Layout-Gerüst und goal.fill-plan.json generieren, dann die Props entsprechend der fillPlan-Segmente nach und nach befüllen.
  • Textlängen und Array-Anzahl: Vorrangig nach fillPlan.text[].maxChars, fillPlan.arrays[].visibleCount, fillPlan.arrays[].nestedArrays schreiben; display-/metric-Felder nur mit kurzen Wörtern, kurzen Sätzen oder Zahlen schreiben.
  • Html-Felder (wie headlineHtml / quoteHtml) für Text nur <br> für Zeilenumbrüche und <b> / <em> für Inline-Hervorhebungen verwenden; <span> und andere freie HTML-Elemente sind verboten. Die <span class> im Standardwert des Themas hängen von Theme-CSS ab und sind nur Platzhalter, nicht übernehmen. validate:goal-spec wird freie HTML-Elemente abfangen.
  • Sichtbare Array-Einträge müssen echten Text enthalten; versteckte End-Einträge, die durch Count/Sichtbarkeitssteuerung ausgeblendet werden, können den Platzhalter „Bitte Text eingeben“ behalten.
  • Element-Eintrittsanimationen verwenden die nativen Effekte der Seitenkomponente.
  • Die Seitenwechselanimation kann im Vorschau-Kontrollfeld angepasst werden.
  • Benutzerorientierte Decks zeigen standardmäßig keine Stil-/Themenwechseloptionen an; der Stilwechsel bleibt nur auf internen Debug-Demo-Seiten erhalten. Wenn der Benutzer ausdrücklich die Beibehaltung des Themenwechsels wünscht, preview: {"themeSwitcher": true} im Ziel-JSON der obersten Ebene schreiben.
  • Keine frei geschriebenen HTML-Folien erstellen; für benutzerorientierte Decks muss jede Seite layout + props enthalten. role ist nur während der Entwurfsphase zur Unterstützung der Seitenauswahl erlaubt; vor dem Rendern muss es durch ein spezifisches layout ersetzt werden.
  • Die ersten 5 Seiten themeXX_page001 bis themeXX_page005 jedes Themas sind Titelblattkandidaten. Ein Deck kann nur 1 Titelblatt aus den ersten 5 Seiten auswählen; nicht mehrere Titelblätter gleichzeitig verwenden; Inhaltsseiten werden ab Seite 6 ausgewählt.
  • In derselben Präsentation dürfen keine sich wiederholenden Seitenkomponenten vorkommen: Das endgültige slides[].layout muss eindeutig sein. Bei der Seitenauswahl die bereits verwendeten layouts notieren; für verschiedene Inhaltsseiten andere Kandidaten desselben Themas wählen; nicht dasselbe Layout durch Textänderung wiederverwenden.
  • Benutzerorientierte Decks dürfen nicht nur role schreiben und sich auf den Standardtext der Seite verlassen. Sofern der Benutzer nicht ausdrücklich eine Standard-Demo wünscht, muss jede Seite sichtbaren Inhalt mit props-Text entsprechend dem Benutzerthema enthalten.
  • Vorzugsweise nur die Textfelder schreiben, die von layout:query / inspect:layout offengelegt werden. Wenn Felder Objekte oder Arrays sind, die inneren Keys gemäß fillPlan und propShapes befüllen. copyKeys hat bereits verschachtelte Pfade (z. B. copy.quote, items[].label); direkt entlang der aufgeführten Pfade befüllen.
  • Seiten, die von inspect:layout mit contentLocked: true markiert sind, haben einen festen Textkörper, der nicht über Props befüllt werden kann: Ein Layout wählen, dessen Textkörper befüllt werden kann, oder die Seite nur verwenden, wenn der Benutzer ihren Standardtext akzeptiert. Arrays gemäß fillPlan.arrays[].visibleCount bis zur sichtbaren Anzahl befüllen; decorativeKeys sind Dekorationsplätze, nicht befüllen.
  • Keine Seiten-Metadaten, Komponentenquellcode, className, CSS, Stilfelder oder Standard-Visualstruktur ändern, um Inhalte zu befüllen. Nur innerhalb von props Inhalte und vom Benutzer ausdrücklich angeforderte Seitenattribute eintragen.
  • Es ist erlaubt, mit text auf oberster Ebene sichtbare Textplätze zu überschreiben, aber nur zum Ersetzen von Textinhalten. Nicht bei normaler Generierung einen Browser starten, um alle Seiten-Textplätze in großem Umfang zu extrahieren; nur wenn der Benutzer ausdrücklich verlangt, „alle Standardvorlagentexte vollständig zu entfernen / sichtbare Texte seitenweise zu korrigieren“, wird eine Laufzeitextplatz-Extraktion durchgeführt.
  • Es ist verboten, alte goal.json oder alte HTML aus output/ wiederzuverwenden. Für jede Anfrage ein neues Ausgabeverzeichnis und einen neuen JSON-Plan erstellen.
  • Das Ausgabeverzeichnis wird im aktuellen Arbeitsverzeichnis der Sitzung erstellt, nicht in <skill-root>/project/output schreiben.
  • HTML-Lieferung: Für den Benutzer nur die Vorschau-Adresse http://127.0.0.1:<port>/ angeben (keine https- oder .local-Varianten). Der lokale HTTP-Dienst kann HTML/PDF/PPTX exportieren; lokales HTML oder file:// kann kein bearbeitbares PPTX exportieren. Kein theme-preview zurückgeben. Bei der Generierung in einer Agenten-App mit eigenem Browser (z. B. Codex) den Benutzer daran erinnern, die Adresse vor dem Exportieren von PDF/PPTX im Systembrowser zu öffnen.
  • PPTX-Lieferung: /api/export-editable-pptx aufrufen; am Ende nur den PPTX-Dateipfad oder das Download-Ergebnis zurückgeben.
  • Wenn kein Browser-Sitzung, Skript-Direktaufruf oder der Vorschau-Export-Endpunkt 403/5xx zurückgibt: stattdessen npm run export:pptx -- <deck>/ppt <out.pptx> (für PDF export:pdf) verwenden, um die Datei direkt zu erzeugen; kein vorheriges Starten einer Browser-Sitzung erforderlich.
  • Wenn im ausgegebenen Text Standardtexte erscheinen, die nichts mit dem Benutzerthema zu tun haben, wie z. B. AI Capital / Investitionsfinanzierung / SoundWave / Schallwelle / Key Metrics / Roadmap / End of Report, muss das JSON neu geschrieben und die Ausgabe erneut gerendert werden; nicht ausliefern.

Medien-Workflow

  • Nur Medienfelder schreiben, die mediaSlots[].canPresetMedia: true haben; den Pfad gemäß presetProp / fieldPath dieses Slots schreiben. goal.json referenziert nur relative Medienpfade innerhalb des Decks, keine temporären Verzeichnisse, externen absoluten Pfade, file:// oder Remote-URLs.
  • Bei visuellen Materialaufgaben zuerst die Absicht klären: Wenn keine Bilder vorhanden sind, aber visuelles Material benötigt wird, zuerst fragen, ob Bildplätze reserviert werden sollen. Wenn keine echten Materialien vorhanden sind und keine Bildgenerierung möglich ist, vorzugsweise Seiten ohne Medien auswählen. Wenn der Benutzer einen Materialordner/Pfad bereitstellt, gilt dies als Absicht für Bilder: Mindestens 2 Seiten mit Mediensteckplätzen auswählen und geeignetes Material einfügen. Wenn der Materialpfad nicht zugänglich ist, zu Seiten ohne Medien wechseln und in der Lieferbeschreibung informieren; keine Platzhalterhinweise auf der Seite hinterlassen. Wenn der Benutzer --planned-images <n> / --needs-media zustimmt, Material vom Benutzer mit --provided-images <n> / --provided-media verwenden. Wenn der Benutzer ausdrücklich originelle visuelle Bilder/Bildgenerierung wünscht, in Codex-Umgebung Bilder mit image-gen generieren und --image-gen hinzufügen; wenn keine Bildgenerierung klar angegeben ist, zuerst den Benutzer fragen. plannedImages / needsVisual / imageGen geben nur die Seitenauswahlabsicht an; sofern der Benutzer nicht ausdrücklich die Reservierung leerer Steckplätze wünscht, müssen vor der Lieferung echte Medienpfade geschrieben werden; keine leeren Mediensteckplätze oder gefälschten Pfade ausliefern.
  • Bei lokalen Bildern/Videos des Benutzers zuerst npm --prefix <skill-root>/project run media:stage -- <deck-output-dir-or-ppt-dir> <media-file...> ausführen und den zurückgegebenen relative-Pfad verwenden; AVIF wird in ein browsernutzbares Format konvertiert. Die image-gen-Ausgabe wird ebenfalls zuerst im aktuellen Deck-Verzeichnis abgelegt.
  • Nach dem Rendern überprüfen, ob jedes in der Zielvorgabe referenzierte Bild/Video existiert: ppt/<relative> vorhanden und die Dateinamen im HTML enthalten? Fehlende Dateien nur in das endgültige ppt/assets kopieren und die Prüfung wiederholen. Jedes Bild-/Videomaterial maximal einmal verwenden; nach Verwendung des Materials Mediensteckplätze leer lassen oder zu Seiten ohne Mediensteckplätze wechseln; es sei denn, der Benutzer wünscht ausdrücklich, dass dasselbe Material wiederholt wird.
  • Wenn mehr als 2 unabhängige Bilder mit image-gen generiert werden müssen, mehrere Subagenten parallel verwenden, nicht seriell Bild für Bild warten; jedes Bild unabhängig generieren, nicht ein zusammengesetztes Bild/Materialbrett verwenden und später aufteilen. Subagenten nur für die Bildgenerierung verwenden, nicht für Themenauswahl, Text, Seitenauswahl oder Validierung.

Workflow

  1. Benutzerziel extrahieren: title, goal, audience, owner, Seitenanzahl, inhaltliche Schwerpunkte und endgültiges Produktformat. Wenn der Benutzer keine Seitenanzahl angibt, standardmäßig etwa 10 Seiten, nicht weniger als 8.
  2. themePack bestätigen. Wenn der Benutzer keinen Stil angibt, zuerst nach dem Stil fragen; nach Auswahl durch den Benutzer randomSeed generieren, z. B. <Thema>-<Datum>-<3-stelliges Zufallswort>, um reproduzierbare Seitenauswahl zu gewährleisten.
  3. Bildabsicht beurteilen: Wenn keine Bilder vorhanden sind, aber visuelles Material benötigt wird, zuerst fragen, ob Bildplätze reserviert werden sollen; lokales Material des Benutzers zuerst mit media:stage verarbeiten; bei klarer Bildgenerierung image-gen verwenden.
  4. Mit layout:query Kandidaten auswählen; bei Objekt-/Array/Count/Bild-Props inspect:layout + props:safe verwenden.
  5. Jede Seite trägt nur eine Hauptinformationsrolle. Seiten, die nicht sicher überschrieben werden können, vorzugsweise durch ein anderes Layout ersetzen; keine Stilfelder verbiegen, um sie anzupassen.
  6. Das JSON in output/<deck-name>/goal.json im aktuellen Arbeitsverzeichnis schreiben; vor dem Rendern npm --prefix <skill-root>/project run props:safe -- --goal output/<deck-name>/goal.json --write und die Zielvorgabenspezifikationsprüfung ausführen. Nach --write die ausgegebenen layoutChanges überprüfen; wenn ein Ersatz nicht akzeptabel ist, zurückändern und Seite wechseln.
  7. Nach dem Einfügen eigener Daten in Diagrammseiten müssen die seiteninternen Felder für Einblicke/Interpretation/Schlussfolgerungen entsprechend den neuen Daten umgeschrieben werden; keine Standard-Schlussfolgerungen beibehalten.
  8. Das Render-Skript ausführen, um output/<deck-name>/ppt/index.html zu generieren; das Skript verwendet den integrierten Generator des Skills; nicht zurück in ein externes Projektverzeichnis wechseln.
  9. Nach dem Rendern die Materialpfade überprüfen; fehlende Dateien in das endgültige ppt/assets kopieren.
  10. Sicherstellen, dass das Skript die Prüfungen validate:swiss und validate:goal-copy abgeschlossen hat.
  11. node <skill-root>/scripts/check_latest_version.mjs für eine stille Versionsprüfung ausführen.
  12. Das Render-Skript startet einen lokalen HTTP-Vorschaudienst und gibt http://127.0.0.1:<port>/ aus; wenn ein bestimmter Port erforderlich ist, DASHI_PPT_PREVIEW_PORT vor der Skriptausführung setzen (Ports im Bereich 5200-5999 verwenden; 4178/4300/4400 sind für Benutzer reserviert und nicht verfügbar). Im Vorschaudienst werden Änderungen automatisch im index.html gespeichert; lokal über file:// geöffnete Dateien werden nicht automatisch gespeichert; vor der Lieferung exportieren.
  13. Je nach Lieferformat antworten: HTML nur http://127.0.0.1:<port>/ angeben; PPTX nach Aufruf von /api/export-editable-pptx nur den Dateipfad oder das Download-Ergebnis zurückgeben.

Nacharbeit und Browser-Check

Nur in folgenden Fällen nacharbeiten: Render-Fehler, Fehler bei validate:swiss, Fehler bei validate:goal-copy, Auftreten von Vorlagentexten in der Ausgabe, die offensichtlich nicht zum Benutzerthema gehören, oder der Benutzer weist ausdrücklich auf ein Problem mit einer Seite hin.

Standardmäßig maximal 2 Runden der Nacharbeit. Wenn immer noch Fehler auftreten, die Ursache für die Blockade erläutern; nicht endlos weiter versuchen.

Standardmäßig keinen Browser öffnen, kein Chrome-Profil erstellen, keine Volltext-Extraktion durchführen. Nur wenn der Generator/die Vorschauvorlage/die Exportlogik geändert wurde, der Benutzer ausdrücklich die Überprüfung des Seiteneffekts wünscht oder in der vorherigen Runde ein Problem mit überschriebenen Props durch Standardwerte aufgetreten ist, wird ein einmaliger Browser-Smoke-Check durchgeführt.

Der Browser-Smoke-Check überprüft nur, ob die Seite geöffnet werden kann, die Seitenzahl korrekt ist und die erste/letzte Seite nicht leer ist. Keine standardmäßigen Screenshot-Verfeinerungen vornehmen; nicht wegen gewöhnlicher Zeilenumbruchprobleme wiederholt am Manuskript arbeiten.

Beispielbefehl:

<skill-root>/scripts/render_goal_deck.sh \
  output/client-review/goal.json \
  output/client-review/ppt/index.html

JSON-Struktur

{
  "title": "US-AI-Finanzierungsrecherche",
  "goal": "Präsentation für das Investmentteam über die Struktur großer US-AI-Finanzierungen 2024–2026, Kapitalflüsse und Folgebeurteilungen",
  "audience": "Investmentteam / Industrieforschungsteam",
  "owner": "Forschungsteam",
  "randomSeed": "ai-funding-20260609-a7k",
  "pageCount": 8,
  "themePack": "theme01",
  "slides": [
    {"layout": "theme01_page001", "props": {"kicker": "Finanzierungsrecherche · VOL.01", "titleTop": "US-AI", "titleBottom": "Finanzierungsrecherche", "lead": "Analyse des aktuellen KI-Finanzierungszyklus anhand von Kapitalvolumen, Sektorstruktur und repräsentativen Unternehmen."}},
    {"layout": "theme01_page006", "props": {"kicker": "Kernzahl", "value": "970", "unit": "Milliarden USD", "sub": "Rekordhöhe des US-KI-Risikokapitals 2024."}},
    {"layout": "theme01_page010", "props": {"kicker": "# Forschungsmethode", "title": "Kreuzanalyse-Methode", "cn": "Identifikation von Finanzierungsveränderungen durch Kreuzung von Zeit- und Sektordimensionen."}},
    {"layout": "theme01_page030", "props": {"kicker": "# Typische Fälle", "title": "Meilensteine · Finanzierungsrhythmus führender Unternehmen"}},
    {"layout": "theme01_page084", "props": {"kicker": "# Anhang", "title": "Datenquellen und Forschungshinweise"}}
  ]
}

Wenn slides leer ist, ist pageCount nur für temporäre Entwurfsvorschauen geeignet. Vor der Auslieferung an den Benutzer muss in ein spezifisches layout + entsprechende props geändert werden.

Seitenrollen

role wird nur für die Seitenauswahl im Entwurf verwendet; das endgültige JSON muss in ein spezifisches layout umgewandelt werden. Eine Erklärung der Rollen findet sich in references/layout-roles.md; die tatsächlichen Kandidaten basieren auf der Ausgabe von layout:query.

cover kann nur aus den ersten 5 Seiten des aktuellen Themas ausgewählt werden. image-/media-Kandidaten basieren auf echten mediaSlots, nicht auf Seiten-Titel-Keywords. Dynamische Hintergrundseiten können mit ambient als Atmosphärenseite oder Kapitelseite verwendet werden.

Direkte Seitenangabe:

{"layout": "theme01_page030", "props": {"title": "Typische Fälle"}}

Lieferfähigkeiten

Die generierte Vorschauseite unterstützt Umblättern, Öffnen der Seitenleiste zum Bearbeiten von Text, Anpassen von Seiten-Props, Ersetzen von Bild-/Videomediensteckplätzen der Komponente, Wechseln der Seitenübergangsanimation und Exportieren als HTML/PDF/PPTX. Die Unterseite der benutzerorientierten Seite zeigt keine Seitenzahlen, Blätterhilfen, Punktnavigation oder Indexhinweise an.

Seiten-Eigenschaftsvertrag

Bei normaler Generierung layout-manifest.json nicht lesen. Zuerst die Kandidatenzusammenfassung von layout:query verwenden. Nur wenn ein detaillierterer Vertrag benötigt wird, npm --prefix <skill-root>/project run inspect:layout -- --compact <layout...> für den Seitenvertrag verwenden:

  • copyKeys: Sicher überschreibbare Text-/Datenfelder.
  • copyBudgets: Textlängenbudgets; display/metric werden bei Überlänge von der Zielvorgabenspezifikation abgefangen.
  • propShapes: Innere Form von copyKeys-/Array-Feldern; beim Schreiben von Objektfeldern wie copy, cells, items, rows nur die hier aufgeführten Keys verwenden.
  • mediaSlots: Schreibfelder für Bilder/Videos, Count-Key, Standardanzahl und Maximalanzahl.
  • countBindings: Bindung von Parameteranzahlen an Array-Felder.
  • Zahlreiche Felder in fillPlan gemäß numericBounds befüllen: enforced:false ist ein Hinweis, echte Daten können überschreiten; enforced:true muss eingehalten werden; semantics:'normalized' Werte 0-1 eingeben. Bei Arrays mit fester verschachtelter Länge die fixedLength/fixedLengths-Werte verwenden, nicht durch Versuch und Irrtum.
  • controlKeys: Über das rechte Panel bedienbare Felder, keine Liste für normales Befüllen von Inhalten; nur verwenden, wenn der Benutzer ausdrücklich die Anpassung von Seitenattributen wünscht. Standardmäßig nur copyKeys, sichtbare Arrays und echte Mediensteckplätze befüllen.

Validierung

  • Vor dem Rendern muss validate:goal-spec ausgeführt werden.
  • Nach der Ausgabe muss validate:swiss ausgeführt werden.
  • Nach der Ausgabe muss validate:goal-copy ausgeführt werden.
  • Nach Änderungen an der Demo npm run showcase:update ausführen.

Verwandte Skills