Zuerst dieses Skill frisch halten — beim Benutzer bestätigen, bevor es ausgeführt wird:
npx hyperframes skills update slideshow. Eine schnelle No-Operation, wenn alles aktuell ist; andernfalls wird dieses Skill zusammen mit den abhängigen Kern-Skills aktualisiert, bevor Sie sich darauf verlassen.
figma-Quelle: Wenn der Inhalt oder das Storyboard des Decks von einer figma.com-URL stammt, führen Sie zuerst
/figmaaus — Asset-Export, Brand-Token und Storyboard-Rekonstruktion, falls die Quelle ein Streifen von Szenenrahmen ist — und bauen Sie dann aus dessen Ausgabe auf. Verwenden Sie Figma nicht direkt über rohe MCP-Werkzeuge: Das überspringt die SVG-Bereinigung, die.media/manifest.jsonl-Herkunft und dievar()-Bindung von Brand-Token, sodass eine spätere Markenänderung ohne vollständigen Neuimport nicht weitergegeben werden kann.
Vertrag zur Erstellung von Diashows
Eine HyperFrames-Diashow ist eine normale HyperFrames-Komposition — Szenen, Clips, GSAP-Zeitachsen — mit einer zusätzlichen Zutat: einer JSON-Insel, die deklariert, welche Szenen Folien sind und wie sie verbunden sind. Der SlideshowController des Players liest die Insel und verwandelt die kontinuierliche GSAP-Zeitachse in ein diskretes, navigierbares Deck.
Lesen Sie zuerst /hyperframes-core für den grundlegenden Kompositionsvertrag (Clips, Spuren, data-*-Attribute, Determinismusregeln). Dieses Skill behandelt nur das Neue: das Insel-Schema, Schreibregeln für Folien, Fragmente, Verzweigungen, Validierung und die umschließende Komponente.
Ausgabe — ein navigierbares Deck, kein lineares MP4
Die Ausgabe einer Diashow ist das laufende Deck: Dienen Sie es mit hyperframes present <Projekt-Verzeichnis> (oder Studio-Präsentationsmodus) — der SlideshowController des Players liest die Insel und steuert Navigation, Fragmente, Verzweigungen und den Präsentatormodus. Siehe Präsentieren und Übergabe unten.
Führen Sie hyperframes render nicht aus, um eine Diashow in ein einzelnes MP4 zu rendern. Ein Deck wird als mehrere übergeordnete Szenenkompositionen erstellt (eine data-composition-id pro Folie) ohne eine sie umschließende Master-Root-Komposition, daher löst render nur die erste Komposition auf und gibt ein stillschweigend abgeschnittenes MP4 aus (z. B. 6s eines 40-Sekunden-Decks). Ein linearer Hauptlinien-Export (nur Hauptfolien, ohne Verzweigungssequenzen) ist zurückgestellt — bis er verfügbar ist, sind die unterstützten Ausgaben das Live-present-Deck und snapshot-Standbilder pro Folie. Wenn ein Benutzer heute ein lineares MP4 benötigt, zeigen Sie diese Einschränkung auf, anstatt render auf das Deck zu verweisen.
Absichtsbestätigung
Wenn der Benutzer explizit nach einer Diashow, Folienpräsentation oder HyperFrames-Diashow fragt, fahren Sie mit diesem Skill fort. Wenn die Anfrage über /hyperframes eingegangen ist, ist die Absichtsprüfung für diese Bestätigung zuständig — hierher weitergeleitet bedeutet bereits bestätigt, also fragen Sie nicht erneut; die Fragen zum Ausführungsrahmen der Prüfung gelten nicht (das Ergebnis ist ein Deck, kein gerendertes Video). Eine BRIEF.md, sofern vorhanden, enthält die bestätigte Absicht — lesen Sie sie.
Wenn das Skill durch eine verwandte Anfrage wie "Präsentation", "Pitch Deck", "Deck", "interaktives Deck" oder "diese Seite umwandeln" ausgelöst wurde, halten Sie vor dem Erstellen inne und stellen Sie die Wahl dar, bevor Sie um Bestätigung bitten. Erklären Sie kurz, dass eine HyperFrames-Diashow ein ausführbares Deck mit einzelnen Folien, integrierter Navigation und Präsentatormodus, bearbeitbaren Sprechernotizen, gemeinsamer Medienverwaltung und Validierung vor der Übergabe bedeutet. Für die Umwandlung von Quellseiten erwähnen Sie auch, dass das Ziel darin besteht, das ursprüngliche visuelle Design, die Interaktionen, Bewegungen und das Medienverhalten der Quellseite zu bewahren, während die Seitenbewegung in Übergänge zwischen Folien übersetzt wird.
Stellen Sie dann eine kurze Bestätigungsfrage:
Möchten Sie dies als HyperFrames-Diashow?
Verwenden Sie eine Ja/Nein-Auswahloberfläche, wenn die Umgebung eine bietet; andernfalls stellen Sie die Frage als Klartext.
Setzen Sie die Diashow erst um, wenn der Benutzer mit Ja antwortet. Wenn er mit Nein antwortet, verwenden Sie dieses Skill nicht mehr — lesen Sie /hyperframes und lassen Sie die Absichtsprüfung neu leiten. Diese Bestätigung ist eine Routing-Entscheidung, kein Präferenz-Gate — gemäß ../hyperframes/references/brief-contract.md § 1 bleibt sie im automatischen Modus bestehen ("Überraschen Sie mich" überspringt sie nicht): Das Erstellen des falschen Ergebnistyps ist ein Qualitätsfehler, keine kreative Entscheidung.
Die zwei Teile
1. Szenen – auf normale Weise deklariert
Jede Folie basiert auf einer Szene. Deklarieren Sie Szenen mit data-composition-id, data-start, data-duration und data-label:
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="Das Problem"
data-width="1920"
data-height="1080"
>
<!-- Clips kommen hier hin -->
</div>
Verzweigungsfolien (nur über einen Hotspot erreichbar, von der Hauptlinie ausgeschlossen) werden auf genau dieselbe Weise deklariert – sie erscheinen nur in einem slideSequences-Eintrag in der Insel, nicht im Haupt-slides-Array.
2. Die JSON-Insel – ein Script-Block pro Komposition
Fügen Sie genau einen <script type="application/hyperframes-slideshow+json">-Block zum Kompositions-HTML hinzu. Er enthält alle Metadaten der Diashow:
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
Die Insel ist die einzige Quelle der Wahrheit für die Reihenfolge der Folien, Notizen, Fragment-Haltepunkt, Hotspots und Verzweigungssequenzen. Platzieren Sie sie nahe dem Anfang des <body>, vor den Szenen-Divs, damit sie leicht zu finden ist.
Verstecken Sie das Diashow-Manifest nicht hinter einem alternativen <script type="application/json">-Block plus Laufzeitcode, der die Insel erstellt. Der present-Befehl liest das Kompositions-HTML statisch und erwartet die echte application/hyperframes-slideshow+json-Insel bereits vorhanden.
Schema
SlideshowManifest (das Inselobjekt der obersten Ebene)
{
"slides": [
/* SlideRef[] — die Hauptlinie, in Reihenfolge */
],
"slideSequences": [
/* SlideSequence[] — Offline-Verzweigungssequenzen */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "Führen Sie mit dem Schmerz, nicht mit dem Unternehmen.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| Feld | Erforderlich | Anmerkungen |
|---|---|---|
sceneId | ja | Muss exakt mit dem data-composition-id einer Szene übereinstimmen (oder startTime/endTime explizit angeben). Die Lint-Regel löst Szenen anhand der data-composition-id auf. |
notes | nein | Nur für Präsentatoren sichtbarer Text. Wird niemals dem Publikum gezeigt. |
fragments | nein | Array von Zeiten (Sekunden) innerhalb des [start, end]-Bereichs der Folie – siehe Fragmente unten. |
hotspots | nein | Interaktive Overlays, die eine Verzweigung auslösen – siehe Verzweigungen unten. |
startTime | nein | Optional. Überschreibt die Zeitgrenzen der passenden Szene; standardmäßig Start/Ende der Szene. |
endTime | nein | Optional. Überschreibt die Zeitgrenzen der passenden Szene; standardmäßig Start/Ende der Szene. |
ttsScript, ttsAudioUrl, ttsDurationMs | nein | Reserviert. Schemafelder existieren, aber die TTS-Wiedergabe ist noch nicht verdrahtet. Weglassen, es sei denn, Sie füllen für einen zukünftigen Build vor. |
SlideHotspot
{
"id": "h1",
"label": "Wie haben wir das berechnet?",
"target": "markt-tiefgang",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| Feld | Erforderlich | Anmerkungen |
|---|---|---|
id | ja | Eindeutig innerhalb der Folie. |
label | ja | Tooltip- / Schaltflächentext, der dem Publikum angezeigt wird. |
target | ja | Muss mit einer SlideSequence.id in slideSequences übereinstimmen. |
region | nein | Prozentualer Begrenzungsrahmen der Folie: {x, y, w, h} in 0–100. Weglassen, um den Hotspot stattdessen als vollflächige beschriftete Schaltfläche darzustellen. |
SlideSequence
{
"id": "markt-tiefgang",
"label": "Methodik der Marktgrößenbestimmung",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
slides innerhalb einer Sequenz verwenden die gleiche SlideRef-Form wie die Hauptlinie. Fragmente und verschachtelte Hotspots sind erlaubt.
Schreibregeln für Folien
Dies sind harte Einschränkungen, keine Vorschläge. Eine Folie, die dagegen verstößt, wird beim Überprüfen durch einen Reviewer vollständig ersetzt.
- Die Überschrift ist eine Behauptung in einem vollständigen Satz, kein Label. Schreiben Sie "KMU verbringen 14 Stunden/Woche mit manueller Terminplanung", nicht "Planungsproblem". Der Satz sollte für sich allein stehen, wenn das Bild ignoriert wird.
- Eine Idee + ein Bild pro Folie. Wenn Sie versucht sind, einen zweiten Aufzählungspunkt-Cluster oder ein zweites Diagramm hinzuzufügen, teilen Sie die Folie auf.
- Führen Sie mit dem Höhepunkt. Der stärkste Punkt kommt zuerst – auf der Folie und in der Reihenfolge des Decks. Investoren lesen von links nach rechts, von oben nach unten und hören auf.
- Nur Bottom-up-Marktgrößenbestimmung. Schreiben Sie niemals „$50B TAM", ohne die Mathematik zu zeigen. Bauen Sie von den Stückzahlen auf: Konten × ACV oder Transaktionen × take-rate.
- Mindestschriftgröße: Äquivalent zu 30pt. Bei 1920×1080 ist eine Überschrift 72–96px; Fließtext ist 48px. Gehen Sie niemals unter 40px für Text, den das Publikum lesen muss.
- Durchsuchen Sie den Live-Katalog, bevor Sie benannte visuelle Elemente von Hand erstellen. Für jedes Aussehen, jeden Effekt, jedes Diagramm, jede Behandlung oder jeden Übergang, den eine Folie benötigt – "CRT-Scanlines", "Glitch", "Balkendiagramm-Rennen", "Schimmer-Sweep", "Terminalfenster" – führen Sie
npx hyperframes catalog --query "<das visuelle Element, in einfachem Englisch>" --jsonaus und lesen Sie die besten Ergebnisse, bevor Sie die Clips der Folie erstellen. Die Suche benötigt nichts installiert: kein Projekt, kein vorherigesadd, kein Konto. Sie durchsucht das gesamte gehostete Register (~400 Blöcke und Komponenten) von jedem Verzeichnis aus.npx hyperframes add <Name>fügt den Quellcode des Blocks in das Deck ein, wo Sie ihn direkt anpassen können. Dies gilt mit besonderem Nachdruck beim Portieren einer Quellseite: Ein echter Block ist besser als die vereinfachte Annäherung, die die Portierungsregeln unten verbieten.
Portieren von Quellseiten
Wenn eine vorhandene Seite in eine Diashow umgewandelt wird, ist die Quelltreue Teil des Vertrags. Ersetzen Sie quellspezifische Widgets nicht durch vereinfachte Annäherungen, es sei denn, der Benutzer bittet explizit um ein Redesign.
- Bewahren Sie das ursprüngliche visuelle Design, die Bewegungssprache, das interaktive Verhalten, das Medienverhalten und die Präsentationsmöglichkeiten der Quellseite so genau wie praktikabel. Wenn das Diashow-System einen Präsentatormodus unterstützt, fügen Sie Sprechernotizen unter Verwendung des gemeinsamen bearbeitbaren Notizverhaltens hinzu, anstatt einer deckspezifischen Implementierung.
- Portieren Sie mechanische visuelle Elemente aus dem DOM/CSS/JS der Quelle so genau wie praktikabel: Benutzerdefinierte Player, Canvas-Visualisierer, Zeitachsen, Abspielköpfe, Stems, expandierende Kreise, Hover-Zustände und andere interaktive Details sollten die Umwandlung überstehen.
- Behandeln Sie native
<video>-/<audio>-Elemente als Quelle der Wahrheit für jede benutzerdefinierte Medienchrom, Canvas-Visualisierer, Wellenform, Beat-Grid oder Abspielkopf. Verbinden Sie die Medienereignisse der Quelle (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) und leiten Sie den visuellen Zustand vonmedia.currentTimeab; führen Sie keinen separaten Timer aus, der von der tatsächlichen Wiedergabe abweichen kann. - Jedes kopierte
<video>oder<audio>mitsrcmuss vor dem Lint HyperFrames-Timing-Attribute haben:data-startunddata-duration, plusdata-has-audio="true", wenn hörbares natives Audio erhalten bleiben soll. Verwenden Sie den Zeitbereich der Szene für folienspezifische Medien; für benutzergesteuerte Beweisvideos, die von mehreren fokussierten Folien abgespielt werden können, verwenden Sie einen deckweiten Bereich. Lassen Siepreload="none"nicht auf Medien; verwenden Siemetadataoderauto. - Lösen Sie Quellschrift-Token vor der Validierung auf. Wenn Sie benutzerdefinierte Quellschriften beibehalten, fügen Sie
@font-face-Regeln für lokale/erfasste Schriftdateien hinzu. Wenn Sie System-Fallbacks verwenden, ersetzen Sie tokenisierte Deklarationen wiefont-family: var(--f-body)durch konkrete render-sichere Stapel wiesystem-ui, sans-serifoderui-monospace, monospace; lassen Sievar(...)nicht als Schriftartenwert. - Überprüfen Sie die Quelle auf untypische Seitenbewegungen, insbesondere Verhalten, das durch Scrollen, Rad, Berührung, Hash-Zustand, Größenänderung oder eine requestAnimationFrame-Schleife gesteuert wird. Behandeln Sie feste Viewports mit übersetzten/skalierten "Welt"-Ebenen, Parallaxeneffekten, fixierten Bedienfeldern, horizontalen Scrollern, gescrubten Zeitachsen, Abschnitts-Einrasten und Zoom-zu-Element-Kameras als Quellverhalten. Scrollen ist oft der Auslöser für Übergänge in der Quelle, also bewahren Sie den Übergang, indem Sie seine Fortschrittsstopps, Easing und Kamera-/Fokus-Zustände extrahieren und diese Bewegung dann über die Diashow-Navigation durch Timeline-Positionen, Fragmente oder einen wiederverwendbaren Player-/Abschlepp-Haken neu hosten. Eigenständige Wrapper, die zu Folien-Haltepunkt springen, benötigen dennoch einen expliziten Navigations-Kamera-Übergangs-Haken; die Berechnung von Kameratransformationen pro Folie reicht nicht aus. Simulieren Sie keinen literalien Bildlauf-nach-unten-Übergang innerhalb der Folie; der Betrachter sollte Kamera-Reisen/-Zoom von einem Brennpunkt zum anderen spüren, nicht eine gescrollte Webseite sehen. Halten Sie jede Kamerabewegung von Folie zu Folie kontinuierlich: Vermeiden Sie Zwischenrouten-Stopps, die die x/y-Richtung umkehren oder den Zoom aufheben. ...
[gekürzt für die Übersetzung]