Was diese Fähigkeit tut
Behandelt eine Präsentation (Deck) als Build, nicht als Dokument:
| Artefakt | Rolle |
|---|---|
template.pptx | Die Werkzeugkette – ihre Folien sind der Archetyp-Katalog. Immer erforderlich. |
deck.mdx | Die Quelle – die einzige Datei, die jemand bearbeitet |
assets/*.svg | Generierte Grafiken, ebenfalls Quelle – nur Inhalt, kein Design |
deck.pptx | Das Build-Artefakt – wird jedes Mal vollständig neu generiert |
deck.pdf + Seitenvorschauen | Das, was eine Person tatsächlich ansieht – der einzige Ort, an dem Layout sichtbar ist |
Jede Ausgabefolie ist ein Klon einer Vorlagenfolie mit ausgetauschtem Inhalt, sodass das Design der Vorlage Byte für Byte erhalten bleibt. Es wird nichts von Grund auf neu angelegt.
Engine: scripts/deck.py (mit absolutem Pfad aufrufen).
Neukolorierung (jede pptx; für ein gebautes Deck template.pptx neu kolorieren und neu bauen): scripts/ppt_keycolor_changer.py, Verfahren und Voreinstellungen in references/recolor.md – entdecken, nach Helligkeit zuordnen, bestätigen, ersetzen, überprüfen.
Ständige Vorgaben
- Niemals ohne Referenzvorlage bauen. Es gibt kein eingebautes Deck-Design und keinen Fallback. Wenn der Benutzer Ihnen keine
.pptxgegeben hat, halten Sie an und fragen Sie danach – stellen Sie keine Folien auf andere Weise zusammen, bieten Sie kein generisches Deck an und erfinden Sie keine Vorlage. Die Engine lehnt dies ebenfalls ab, aber die Aufforderung liegt bei Ihnen, bevor irgendeine Arbeit beginnt. - Die Quelldatei ist
deck.mdx, niemalsdeck.md. Sie wird kompiliert, nicht gelesen. Die Engine lehnt jede andere Erweiterung ab. - Vor dem Schreiben katalogisieren. Verfassen Sie
deck.mdxniemals aufgrund einer Vermutung über die Vorlage. Führen Siecatalogaus und schreiben Sie gegen die Slot-IDs, die es ausgibt. - Die Ausgabe-pptx niemals von Hand bearbeiten. Sie wird beim nächsten Build neu generiert. Korrekturen gehen in
deck.mdx. - Führen Sie
checkvorbuildaus und zeigen Sie dem Benutzer die Warnungen. Überlaufwarnungen sind das, was zwischen überfülltem Text und einer Folie, die niemand lesen kann, steht. - Sichtbarkeit entscheidet, nicht Ordentlichkeit.
| transparentist richtig, wenn der Inhalt des Bildes gegen die Folie lesbar bleibt;checksagt, wann dies nicht der Fall ist, und ein Panel hinter dem Bild ist dort die bessere Antwort. Greifen Sie nicht zu Transparenz, weil es sauberer klingt. - Niemals Inhalte wegschneiden, ohne es zu sagen.
checkmeldet den Prozentsatz; wiederholen Sie ihn dem Benutzer und bieten Sie| fitan. Ein Bild, das die Hälfte von sich selbst verliert, ist derselbe Fehler wie eine Tabellenzeile, die von der Folie fällt. - Niemals die Grafik eines Bild-Slots von Hand als Binärdatei erstellen. Schreiben Sie das SVG, damit das Deck aus Text reproduzierbar bleibt. Ein PNG, das jemand eingefügt hat, kann nicht neu generiert, neu koloriert oder in einem Diff überprüft werden.
- Ein Deck wird von Menschen gelesen, also sehen Sie es sich an. Wenn ein Renderer verfügbar ist, beenden Sie mit
render, nicht mitbuild– das Layout-Audit und die Seitenvorschauen sind der einzige Ort, an dem Textkollisionen sichtbar werden. Wenn kein Renderer verfügbar ist, sagen Sie dies im Bericht klar, anstatt zu implizieren, dass das Layout geprüft wurde. - Niemals einen Archetyp erfinden. Wenn keine Vorlagenfolie zum Inhalt passt, sagen Sie dies und fragen Sie, ob der Inhalt umgeformt oder die Vorlage erweitert werden soll – nähern Sie sich nicht an.
- Melden Sie die Warnungen, die Sie ignoriert haben. Eine Überlaufwarnung, die Sie für in Ordnung hielten, gehört trotzdem in den Abschlussbericht – der Benutzer wird die Folie sehen.
- Diagramme sind schreibgeschützt. Sagen Sie dies laut, wenn der gewählte Archetyp eines hat; die Zahlen der Vorlage werden übernommen, es sei denn, der Benutzer bearbeitet das Diagramm in PowerPoint.
Prozess
Schritt 0 · Referenzvorlage besorgen
Fragen Sie nach der .pptx, bevor Sie irgendetwas anderes tun, wenn Sie keine haben:
"Bitte geben Sie die Referenzvorlage als pptx. Der Deck-Builder funktioniert durch Klonen von Vorlagenfolien; ohne Vorlage gibt es keine Folien, die erstellt werden können."
Fahren Sie nicht mit einer Beschreibung einer Vorlage, einem ähnlich aussehenden Deck oder dem Versprechen, eine später zu liefern, fort.
Schritt 1 · Vorlage katalogisieren
python3 /abs/path/scripts/deck.py catalog \
--template "template.pptx" --output "deck.catalog.md"
Gibt jeden Archetyp als @s1…@sN mit seinen Slots, dem aktuellen Inhalt der Vorlage und einer Kapazitätsschätzung aus. Lesen Sie es vor allem anderen.
Schritt 2 · Inhalt auf Archetypen abbilden
Fragen Sie den Benutzer nach dem Inhalt, wenn Sie ihn nicht haben. Zeigen Sie dann, bevor Sie md schreiben, einen Einzeiler-pro-Folie-Plan:
1. @s1 Deckblatt – Titel + Untertitel
2. @s3 Zusammenfassung – 3 Aufzählungspunkte + einzeiliges Fazit
3. @s7 Zahlen – Tabelle 4 Zeilen
Holen Sie sich Zustimmung zum Plan. Die falsche Archetyp-Wahl ist der teure Fehler, nicht die falsche Formulierung.
Schritt 3 · deck.mdx schreiben
---
template: template.pptx
template_hash: 5f84440a3521 # aus dem Katalog – verknüpft das Deck mit der Vorlagenstruktur
output: deck.pptx
---
## @s3
title: Quartalszusammenfassung
text1:
- Antwortzeit p99 **2,1s → 340ms**
- Bereitstellungsfehlerrate 12% → 0,4%
table1:
| Metrik | Vorher | Nachher |
| p99 | 2,1s | 340ms |
pic1: assets/arch.svg
notes: Zuerst die Quellen der Zahlen nennen
text5: !drop
Bilder benötigen einen Anpassungsmodus – | fit behält das gesamte Bild, der Standard fill beschneidet es – und | transparent entfernt den Hintergrund eines PNG. Ausgelassene Slots behalten den Inhalt der Vorlage.
Die vollständige Syntax – Slot-Formen, !drop, notes:, Inline-Hervorhebung, Gliederungsebenen und wogegen template_hash schützt – befindet sich in references/mdx-syntax.md. Lesen Sie es, bevor Sie die erste Folie schreiben.
Schritt 3b · Erstellen Sie die benötigten Grafiken
Schreiben Sie die Grafik eines Bild-Slots als .svg in den Farben der Vorlage und in der exakten Punktgröße des Rahmens – beide werden von catalog ausgegeben. Es wird wie der Rest des Decks zur Quelle und zur Build-Zeit in PNG gerastert.
Regeln, Begründung und ein durchgearbeitetes Beispiel: references/generated-art.md.
Schritt 4 · Prüfen
python3 /abs/path/scripts/deck.py check --deck deck.mdx
Fehler müssen behoben werden. Warnungen sind Ermessensentscheidungen – zeigen Sie jede einzelne an, einschließlich derer, die Sie zu ignorieren beschließen.
| Was gemessen wird | Gegen |
|---|---|
| Eine Tabelle oder Text läuft von der Folie | dem Folienrand – ein Fehler, der die verlorenen Zeilen benennt |
| Eine Zeile ist zu breit für einen Slot, den die Vorlage einzeilig hält | dem eigenen Rahmen des Slots in em, sodass Hangul nicht wie Latein gezählt wird |
| Ein Slot fasst weit weniger als die Vorlage dort platziert | dem eigenen Volumen der Vorlage – der Rahmen wurde für diese Menge gezeichnet und die Folie öffnet ein Loch |
| Text reicht tiefer als vom Design vorgesehen | der eigenen Zeilenanzahl der Vorlage und dem, was darunter sitzt |
| Beschnittverlust, effektive dpi, Palettenabweichungen, eingefügte Box-Ränder | dem Rahmen, dem Bildschirm und der Palette der Vorlage |
| Text über einem Bild | den Pixeln tatsächlich dahinter: 3:1 für große Schrift, 4,5:1 für Fließtext |
Ein Bild, das nach den Wörtern gezeichnet wird, die es bedeckt, ist ein Fehler – sie landen hinter dem Bild.
Jede Schätzung hier ist an den eigenen Inhalt der Vorlage kalibriert und nicht an einem absoluten Wert, da die meisten Rahmen gezeichnet sind, um Text zu halten, der bereits umbricht. Ränder unter etwa einer Zeile liegen jenseits dessen, was eine statische Schätzung auflösen kann: Nur Schritt 6 klärt diese.
Schritt 5 · Bauen
python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]
Dasselbe deck.mdx erzeugt immer eine byte-identische pptx.
Schritt 6 · Rendern und ansehen
python3 /abs/path/scripts/deck.py render --deck deck.mdx
Baut, konvertiert über LibreOffice, schreibt PNG-Vorschauen jeder Seite und prüft die gerenderte Geometrie – overlap (zwei Textrahmen kollidieren), bunched (Zeilen in einem Rahmen sitzen enger als die Norm dieses Rahmens, sodass der Text seinen Kasten überwachsen hat), off-slide (der Renderer hat ihn abgeschnitten). Sauber bedeutet sauber: Das Audit vergleicht zwischen Rahmen und misst den Zeilenabstand gegen den Median jedes Rahmens, sodass CJK-Schriftarten, deren em-Box eine 100%-Zeile überschreitet, es nicht auslösen.
render sagt zuerst, welche der Schriftarten der Vorlage der Renderer nicht hat. Eine ersetzte Schriftart bricht jede Zeile neu um, sodass die Zeilenumbrüche der Vorschau bis zur Installation dieser Schriftarten die des Ersatzes sind, nicht die des Decks – die Lösung ist, die Schriftart zu installieren, nicht die Wörter zu kürzen. Die pptx selbst benennt immer die richtigen Schriftarten.
Lesen Sie die Vorschauen für das Layout, nicht für den Abstand. LibreOffice entfernt standardmäßig den Abstand zwischen CJK und Latein, sodass 평균 42분 in der Vorschau als 평균 42 분 gerendert wird, während die pptx den ursprünglichen String enthält. Überprüfen Sie <a:t> in der erstellten Datei, bevor Sie Abstand als Fehler behandeln.
Renderer ist soffice im PATH oder DECK_RENDER_DOCKER=<image>. Wenn keines vorhanden ist, verweigert render den Dienst, anstatt so zu tun, als ob das Layout geprüft wurde – sagen Sie dies und fallen Sie auf build zurück.
Ausgabevorlage
Bericht nach einem Build:
Build abgeschlossen – <Ausgabepfad>
Folien <N> · Vorlage <Name> · Bilder <M> eingefügt
Render-Prüfung – Überlappungen 0 (oder: Seite 3 Titel überlappt mit Textkörper)
Verwendete Archetypen
@s1 ×1 Deckblatt
@s3 ×4 Textkörper
Zu prüfen
· Folie 3 title 58 Zeichen (Rahmen ~39 Zeichen/Zeile) – geht auf zwei Zeilen über
· Folie 5 chart1 – Diagrammwerte sind die der Vorlage
Für die nächste Änderung nur deck.mdx bearbeiten und erneut build ausführen. Die Ausgabe-pptx wird bei manueller Bearbeitung überschrieben.
Was Claude tut / Was Sie tun
| Claude | Sie |
|---|---|
| Fragt nach der Referenz-pptx, weigert sich, ohne diese fortzufahren | Stellt die Vorlage – obligatorisch – und den rohen Inhalt bereit |
Führt catalog aus, liest die Slot-Karte | Überprüft die Archetyp-Liste |
| Schlägt den Archetyp-pro-Folie-Plan vor | Genehmigt oder ordnet den Plan neu an |
Schreibt und überarbeitet deck.mdx | Bearbeitet deck.mdx direkt, wann immer Sie bevorzugen |
Führt check aus, meldet jede Warnung | Entscheidet, ob eine Überlaufwarnung relevant ist |
Führt render aus, sieht sich die Vorschauen an, meldet Kollisionen | Öffnet die pptx, bearbeitet Diagramme bei Bedarf |
Einschränkungen
Die sechs, die ändern, was Sie versprechen können:
| Einschränkung | Konsequenz |
|---|---|
| Keine neuen Layouts | Jede Folie ist ein Klon. Inhalt ohne Archetyp erfordert eine Erweiterung der Vorlage in PowerPoint – sagen Sie dies, anstatt zu approximieren. |
| Eine Vorlage ist zwingend | Kein eingebautes Design, kein Fallback. |
| Diagramme sind nicht beschreibbar | build belässt die Zahlen der Vorlage. Verwenden Sie ein SVG in einem Bild-Slot. |
| Rahmen bewegen sich nie | Schreiben Sie kurz und der Abstand bleibt; check meldet es, nur die Vorlage kann ihn schließen. |
| Layout-Wahrheit benötigt einen Renderer | check schätzt und kann Ränder unter einer Zeile nicht auflösen. Nur render sieht, was kollidiert. |
| Lesbarkeit ist nur PNG | Text über einem JPEG- oder SVG-Hintergrund wird nicht bewertet; geerbte Textfarben bleiben unberührt. |
Vollständige Tabelle und welcher Schritt welche Einschränkung abfängt: references/limits.md.
Verwandte Fähigkeiten
write:plans(Dokumentzweck) – Inhalt entwickeln, bevor er auf Folien abgebildet wirdthink:untangle-thoughts– verstreute Notizen in die Folie-für-Folie-Struktur von Schritt 2 verwandeln