paulmil11/decks

Was macht decks?

Der Benutzer überprüft ein Deck im Browser. Er gibt einen Kommentar unter einer Folie ein (oder bearbeitet den Text direkt auf der Folie) und sagt dann "process changes" oder klickt auf Ask Claude im Deck. Dadurch wird eine Eingabeaufforderung kopiert, die den Deck-Dateinamen und die unten stehenden sb-Schritte angibt; behandeln Sie diese Eingabeaufforderung als "process changes" für dieses Deck. Sie reagieren auf jeden Kommentar, antworten auf der Folie selbst, überprüfen Ihre Arbeit und exportieren. Halten Sie die Chat-Zusammenfassung kurz: Die Antworten auf den Folien tragen die Details.

Wo die Dinge sind

• Der App-Ordner ist das Decks-Repository: der Ordner, in dem diese Fertigkeit enthalten ist (.claude/skills/decks/ darin), oder, bei einer Kopie dieser Fertigkeit in ~/.claude/skills/, dort, wo der Benutzer sie geklont hat. Die Ask-Claude-Eingabeaufforderung gibt ihn an. Er enthält server.py, das sb-Kommandozeilenwerkzeug, die Browser-Shell in static/, Vorlagen in templates/ und kopflose Werkzeuge in tools/. Führen Sie sb von dort aus: ./sb ....
• Der Server: python3 server.py, unter http://localhost:8790/ sofern nicht config.json oder SB_PORT etwas anderes angibt. Wenn sb mitteilt, dass der Server nicht erreichbar ist, starten Sie ihn (im Hintergrund) und versuchen Sie es erneut. sb findet ihn unter SB_URL oder am konfigurierten Port.
• Decks leben im Decks-Ordner (Standard: ~/slide-decks), ein Ordner pro Deck, aufgelistet in decks.json. ./sb decks listet sie mit ihren Adressen auf.
• Öffnen Sie ein Deck unter http://localhost:<port>/d/<slug>/<entry>. #s=<slide-id> springt zu einer Folie, und #v=<version>&s=<id> wählt eine Version aus.
• Der gespeicherte Zustand befindet sich neben jedem Deck in .slidebuilder/:
  • state.json: Die Bearbeitungen, Kommentare und die Folienreihenfolge des Prüfers, gespiegelt von der Seite. Niemals von Hand schreiben.
  • review.json: Ihre Antworten, Runden und geänderte Abzeichen. Schreiben Sie es über sb.
• Jeder Deck-Ordner ist ein Git-Repository. PDFs, Zips und PPTX-Dateien werden ignoriert.

Die Seite

• Vier Ansichten: Fokus (F), Scrollen (S), Sortierer (G) und Prüfungen (C). Die Filmleiste links ordnet per Drag & Drop neu.
  • In Fokus und Scrollen befindet sich das Kommentarfeld unter jeder Folie, mit Ihrer Antwort darunter. Die rechte Leiste enthält die Notizen der Folie und was geändert wurde.
  • Prüfungen hat fünf Prüfungen, Tasten 1 bis 5: den 5-Sekunden-Test (erster Eindruck), den 10-Sekunden-Test (Lesbarkeit; ein Fehlschlag hinterlässt einen Kommentar auf der Folie für die nächste Runde), den horizontalen Fluss (die Titel allein, an Ort und Stelle bearbeitbar), den vertikalen Fluss (zuerst der Titel, der Körper bleibt bis zur Enthüllung verborgen) und Guides.
  • Kommentare können von Prüfungen stammen: "Fünf-Sekunden-Test: …" und "Zehn-Sekunden-Test: …" nach einem nicht bestandenen zeitgesteuerten Test, und "Guides: …" von Ask Claude zur Fehlerbehebung in Prüfungen › Guides, wobei genannt wird, was die Folie nicht einhält. Beheben Sie die Folie, damit sie besteht, wie bei jedem Kommentar.
  • H blendet alles außer den Titeln aus. ? listet alle Tastenkürzel auf.
• Folie hinzufügen (N, "+ Folie" oder das + zwischen Folien) schlägt Layouts vor und kann eine Folie hinzufügen, die das Deck trägt. Der Kopier-Aufforderungstext gibt Ihnen die Deck-Datei, die Position und was die Folie sagen soll. Wenn eine Eingabeaufforderung sagt "Ich habe gerade eine … Folie hinzugefügt (LIBRARY['id'])", füllen Sie diese Folie aus; wenn sie sagt "füge eine neue Folie hinzu …", bauen Sie sie in der Deck-Datei an dieser Position auf.
• Wenn der Prüfer einen Titel in Prüfungen bearbeitet, handelt es sich um eine Inline-Bearbeitung: Führen Sie sie wie jede andere aus.
• Kundenarbeit ausblenden (ein Dashboard-Schalter, settings.json im Decks-Ordner) dient der Aufzeichnung oder Bildschirmfreigabe. Wenn es aktiviert ist, lässt der Server als client markierte Decks und in clientVersions aufgeführte Versionen aus. Zeigen Sie niemals Kundennamen auf dem Bildschirm an, wenn es aktiviert ist.

Eine Runde ("process changes")

1. cd in den App-Ordner.
2. ./sb comments <deck> listet die zu bearbeitenden Kommentare auf, nummeriert wie das Deck. Entwürfe werden übersprungen. ./sb edits <deck> zeigt die Inline-Textänderungen und Folienverschiebungen des Prüfers an. Beide lesen von der Festplatte, daher benötigen Sie nicht dessen Browser-Tab.
3. ./sb status <deck> "Lese Ihre 9 Kommentare" --done 0 --total 9. Der Prüfer sieht dies live in der oberen Leiste. Aktualisieren Sie es während der Arbeit.
4. Für jeden Kommentar:
   • ./sb working <deck> <slide>.
   • Nehmen Sie die Änderung in der Deck-Datei vor.
   • ./sb reply <deck> <slide> done "ein einfacher Satz, was geändert wurde".
   • Wenn Sie die Entscheidung des Prüfers benötigen, verwenden Sie question anstelle von done. Für etwas, das Sie bewusst unverändert gelassen haben, verwenden Sie skipped und begründen Sie es.
   • Ein unvollständig getippter Kommentar erhält eine question-Antwort, keine Vermutung.
5. Führen Sie die Inline-Bearbeitungen des Prüfers in der Deck-Datei ein (seine Bearbeitung gewinnt). Git hat die alte Version.
6. Überprüfen Sie jede von Ihnen berührte Folie:
   • ./sb shot <deck> <ids…>, dann betrachten Sie jedes Bild.
   • ./sb audit <deck> findet Überlauf, überlappende Beschriftungen und alles, was die Guides markieren.
   • ./sb comments <deck> sollte nichts Neues und Unerledigtes zeigen.
7. Abschluss:
   • ./sb export <deck> schreibt das nächste nummerierte PDF aus der Deck-Datei und verschiebt ältere Versionen in _archive/. Wenn der Browser noch nicht eingebundene Bearbeitungen enthält, wird dies gemeldet: Binden Sie sie zuerst ein. --with-edits exportiert stattdessen genau das, was der Browser zeigt.
   • ./sb round <deck> --summary "…" --changed id="was geändert wurde" … --export vN.
   • ./sb commit <deck> "Runde N: …".
   • ./sb idle <deck>.
   • Teilen Sie dem Benutzer mit, wo das PDF ist.
8. Die Seite lädt sich neu, sobald der Prüfer aufhört zu tippen. Laden Sie seinen Tab nicht neu oder löschen Sie ihn nicht. Im Chat: ein paar Zeilen, plus alles, was seine Entscheidung erfordert.

Neue Kommentare können während Ihrer Arbeit eintreffen. Führen Sie ./sb comments erneut aus, bevor Sie abschließen.

Der Prüfer löscht behandelte Kommentare mit "Looks good". Fügen Sie sie nicht zu DONE_FB hinzu; diese Liste ist nur für Kopien, die außerhalb von Decks geöffnet wurden, z. B. eine an jemand anderen gesendete Datei.

Die Deck-Datei

• Eine eigenständige HTML-Datei pro Deck, mit drei von Ihnen bearbeitbaren Teilen:
  • Inhalt: LIBRARY-Einträge ('id': { cat, layout, title, …, notes }), gruppiert in Teile nach cat (die Teile sind CATS, benannt in CAT_LABELS)
  • Abbildungen: FIGS-Funktionen, die Inline-SVGs zurückgeben
  • Versionen: PITCHES (jeweils ein Name und eine Liste von Folien-IDs)
• Die Standardversion ist die LIBRARY-Reihenfolge innerhalb jedes Teils. Zum Neuordnen verschieben Sie LIBRARY-Einträge. Eine gespeicherte Reihenfolge, die einer alten Standardreihenfolge entspricht, folgt der Datei.
• Ersetzen Sie eine Folie durch alt:true (sie geht ins Regal des Sortierers) und setzen Sie ihren Ersatz direkt davor. Löschen Sie die Folien des Benutzers nicht. Eine alternative Version einer Folie erhält prop:true, replaces:'…' (gekennzeichnet als "Vorgeschlagen").
• Eine Quellenzeile steht in der Fußzeile über src:'Source: …', nicht als Untertitel.
• Farben, Schriftart des Titels und Logo: ein <style id="deck-theme">-Block in der Deck-Datei und LOGO für das Logo des Decks in img/. Ändern Sie das Design durch Bearbeiten dieses Blocks, nicht einzelner Folien. Ohne LOGO haben Folien kein Logo.
• Große visuelle Änderungen (ein neues Layout, ein Redesign): Zeigen Sie dem Benutzer zuerst einen Mockup oder zwei Optionen, dann bauen Sie es.
• Wenn der Benutzer eine Datei zum Senden an jemanden wünscht, ist dies die Client-Kopie des ⋯-Menüs: die Version auf dem Bildschirm nur als Folien (keine Notizen, Kommentare, Moderatorfolien, andere Versionen oder Bearbeitungen), Bilder darin, mit einem Präsentieren-Button. Bearbeitbare Kopie ist das gesamte Deck mit Notizen und Kommentaren: Senden Sie diese niemals an einen Kunden.
• Decks werden vom Dashboard mit ./sb hide <deck> entfernt (zurück mit ./sb show). ./sb delete <deck> --yes verschiebt ein von dieser App erstelltes Deck in den Papierkorb und deregistriert nur ein Deck in einem Ordner des Benutzers. Löschen Sie nur, wenn der Benutzer darum bittet.
• Das Herunterladen von Bildern oder Logos erfordert jedes Mal die Zustimmung des Benutzers. Nennen Sie ihm den Dateinamen, die Quelle, die Größe und die Lizenz und setzen Sie die Quellenangabe in die Fußzeile.

Die Methode

Decks basiert auf der Methode, die Paul Millerd bei StrategyU lehrt. Wenden Sie sie auf jede Folie an, die Sie schreiben oder korrigieren. Wenn die Fertigkeit strategy-slides installiert ist, enthält sie die vollständige Version: Nutzen Sie sie für Handlungsstränge, Titel und Feedback.

Antwort zuerst. Beginnen Sie mit der Empfehlung, dann dem Kontext, dann den Beweisen. Bauen Sie zur Empfehlung hin auf (Situation und Komplikation, dann die Kernideen) nur für ein skeptisches Publikum.

Geister-Deck zuerst. Bevor Sie einen Folienkörper erstellen, schreiben Sie jeden Handlungstitel in der Reihenfolge und lesen Sie sie als einen Absatz. Wenn der Absatz das Argument nicht vermittelt, korrigieren Sie die Titel oder die Reihenfolge jetzt; es ist der günstigste Punkt, um die Geschichte zu korrigieren. Notieren Sie, was jeder Körper zeigen muss, um seinen Titel zu beweisen.

Vertikaler Fluss: Der Titel ist die Kernaussage, und der Körper beweist sie.

• Jeder Titel ist ein Handlungstitel: ein vollständiger Satz, der den Punkt nennt. "Q3-Umsatz stieg um 22 %, angetrieben durch Unternehmensexpansion", niemals "Q3-Umsatz".
• Gehen Sie über vage Titel hinaus. "Das Unternehmen verbessert sich" ist Schritt eins; "Die Rentabilität stieg zum ersten Mal seit 5 Jahren aufgrund von Investitionen in die Lieferkette" ist das Ziel.
• Keine "Wichtige Erkenntnisse"-Boxen oder Zusammenfassungsstreifen am unteren Rand. Die Erkenntnis führt die Seite an.
• Verwenden Sie einfache Verben mit ihren natürlichen Objekten. Personifizieren Sie Daten nicht und erzwingen Sie keine Metaphern für Zahlen. Keine Komma-Dreh-Fragmente ("Eine Denkweise, wenn die Arbeit zwei braucht"). Höchstens zwei Zeilen. Lesen Sie es laut vor: Es sollte sich anhören, wie etwas, das eine Person zu einem Kollegen sagen würde.
• Nur-Zahlen-Titel sind leer. "Drei Risiken und wie wir sie abdecken" wird zur Erkenntnis: "Das wahre Risiko ist der Westküstendienst, nicht die Lagerkapazität."
• Deckblätter, Abschnittstrenner und der Appendix-Trenner sind ausgenommen. Die Abschlussfolie ist es nicht: "Bis zum 14. März genehmigen und wir verlassen beide Mietverträge vor Verlängerung", nicht "Nächste Schritte".

Horizontaler Fluss: Die Titel allein erzählen die Geschichte. Lesen Sie sie in der Reihenfolge (Prüfungen › Horizontaler Fluss). Wenn sie ohne die Folienkörper keinen Sinn ergeben, korrigieren Sie die Titel oder die Reihenfolge.

Eine Idee pro Folie. Wenn eine Folie "und auch" braucht, braucht es zwei Folien.

Die Fünf- und Zehn-Sekunden-Tests dienen der Lesbarkeit. Eine präsentierte Folie vermittelt ihre eine Aussage in fünf Sekunden. Eine Folie, die Leute lesen, kann innerhalb von zehn Sekunden erfasst werden: ein Hauptpunkt, eine lesbare Hierarchie, ein Diagramm, dessen Form sich ohne Studium erschließt. Textwüsten, eine wichtige Zahl, die in einer dichten Tabelle vergraben ist, und mehrere nicht zusammenhängende Ideen auf einer Folie bestehen alle nicht.

"Na und?" ist ein separater Test. Drei ordentliche Boxen mit Aufschrift Innovation, Exzellenz, Wachstum bestehen den Zehn-Sekunden-Test und fallen bei "Na und?" durch (hübsches-Folien-Syndrom). Jede Folie sagt dem Publikum, was es denken soll. Halten Sie die beiden Erkenntnisse getrennt, wenn Sie Feedback geben.

Diagramme beweisen den Titel. Schreiben Sie die Botschaft, bevor Sie das Diagramm zeichnen. Balken, Säulen und Linien decken fast alles ab; verwenden Sie niemals ein Kreisdiagramm. Die Zahl, die zählt, ist die auffälligste Markierung; alles, was der Titel nennt (eine Rezession, ein Wendepunkt), ist im Diagramm markiert, und alles, was den Titel nicht stützt, wird entfernt. Unsichere Daten erhalten ein "Illustrativ"-Label und einen Hinweis auf die Annahmen.

Die Zusammenfassung ist die wichtigste Folie: die Empfehlung als Titel und drei Erkenntnisse mit je einer Beweiszeile. Verwenden Sie Abschnittstrenner nur in langen Decks (20+ Folien) mit unterschiedlichen Abschnitten.

Präsentiert oder gelesen. Präsentiert: unter 20 Wörtern im Körper, eine Idee, große Bilder. Gelesen: mehr Text ist in Ordnung, mit fetten Leitwörtern, und jede Folie steht für sich allein, weil sie weitergeleitet wird.

Feedback zu einem Deck geben. Lesen Sie zuerst das gesamte Deck. Geben Sie dann in dieser Reihenfolge: die Geschichte (die Titel in der Reihenfolge, was sie sagen, und was fehlt oder falsch angeordnet ist); die Folien, die ein Problem haben, mit der Lösung (schreiben Sie den neuen Titel, wenn der Titel das Problem ist); und die drei wichtigsten Änderungen, mit dem Argument und der Reihenfolge vor Schriftarten und Farben. Wenn das Argument nicht hält, sagen Sie das zuerst. Überprüfen Sie jede Foliennummer, bevor Sie sie zitieren.

Schreiben. Aktive Verben, Kontraktionen und Zahlen anstelle von Adjektiven. Niemals: eintauchen, Landschaft, nutzen (im Sinne von 'verwenden'), entscheidend, zentral, robust, nahtlos, transformativ, unterstreichen, zusätzlich, darüber hinaus, ferner. Höchstens ein Gedankenstrich pro Folie.

Folien-Stilregeln

Zusätzlich zur Methode:

• Keine kleinen, gedimmten oder kursiven Zeilen am unteren Rand von Karten oder Boxen. Fassen Sie alles Wichtige in das Element ein, zu dem es gehört.
• Keine Raster identischer Karten. Zeichnen Sie stattdessen die Beziehung: einen Prozess, ein Spektrum, eine Leiter, ein Diagramm oder eine Karte.
• Anleitungen sind ein einfacher Satz. Reflexionsfragen sind einfach und handeln von der eigenen Arbeit des Publikums.
• Agenda-Zeiten in Blöcken von 5 Minuten.
• Verwenden Sie das eigene Material, die Diagramme und die Wortwahl des Benutzers, bevor Sie Frameworks erfinden. Beim Kürzen schneiden Sie zuerst erfundene Folien und behalten Sie Aufbauten und Setup/Payoff-Paare ganz.
• Markieren Sie von Ihnen verfassten Text in den Notizen, damit der Benutzer ihn ersetzen kann.
• Zitate und Zahlen stammen nur aus Quellen, die Sie in der Sitzung geöffnet haben, genau zitiert und der tatsächlichen Person zugeschrieben.
• Alles besteht die Prüfungen › Guides: der geschützte Rand, zweizeilige Titel, nichts unter 12 px, höchstens vier Textgrößen auf einer Folie. Dies sind Richtlinien, keine Regeln; beheben Sie, was sb audit auflistet, oder begründen Sie, warum eine Folie eine Ausnahme darstellt.

Ein neues Deck starten

Der Benutzer startet Decks über das Neues Deck-Formular des Dashboards, in zwei Schritten. Schritt 1: Ein Name, was er baut (eine Präsentation, ein Training, ein Vortrag, ein Vorschlag oder ein leeres Deck) und die Elemente, die damit erstellt werden sollen. Schritt 2: Für wen es ist, was sie wissen und was ihnen wichtig ist, der eine Punkt, und optionale Länge, Art des Publikums, Struktur, Dichte, Farben, Schriftart des Titels, Logo und Notizen. "Deck erstellen" erstellt den Ordner, vergibt ein eigenes Speicherpräfix, fügt es zu decks.json hinzu, startet die Git-Historie, schreibt das Briefing in BRIEF.md, kopiert eine Eingabeaufforderung in die Zwischenablage und öffnet das Deck. Wenn der Benutzer diese Eingabeaufforderung einfügt:

1. Lesen Sie BRIEF.md im Deck-Ordner und passen Sie die Vorlage daran an, bevor Sie Folien schreiben. Die Vorlage ist ein Ausgangspunkt, keine feste Form:
   • Wie es verwendet wird. Präsentiert: eine Idee pro Folie, große Schrift, wenig Text; es muss den 5-Sekunden-Test bestehen. Zum Lesen gesendet: jede Folie steht mit einem vollständigeren Körper für sich; es muss den 10-Sekunden-Test bestehen. Präsentiert, dann gesendet: präsentierbare Folien, mit den Details in den Notizen oder einem Anhang.
   • Publikum und was sie wissen. Passen Sie den Wortschatz, die Beispiele und das Erklärungsniveau an; Führungskräfte erhalten zuerst die Antwort.
   • Struktur. Antwort zuerst: die Empfehlung, dann die Gründe. Situation, Komplikation, Lösung: in dieser Reihenfolge. Eine Geschichte in einigen Teilen: Abschnitte mit Trennern. Lehren, üben, reflektieren: Module mit Übungen und Reflexionsfragen.
   • Dichte. Spärlich, ausgewogen oder detailliert, wie die Worte es sagen.
   • Alles, was leer gelassen wird, ist Ihre Entscheidung.
2. Schreiben Sie die Folien in einer einzigen Sitzung. Keine leeren Folien, keine Platzhalter. Jede Folie überprüft und fertig, bevor Sie fortfahren. Wenn die Länge festgelegt ist, bleiben Sie im Rahmen; halten Sie inne, wenn die Geschichte erzählt ist.
3. Wenden Sie das vollständige Briefing als letzte Prüfung an: Keine Folie widerspricht nicht, was sie wissen müssen, was sie interessiert, oder dem einen Punkt.

Letzte Hinweise

• Wenn Sie den Browser aktualisieren oder die Seite neu laden müssen, um nach dem Export eine bestimmte Folie zu überprüfen, verwenden Sie einen OpenAI/Claude-Bildschirmlese-Host-Befehl. Führen Sie zuerst einen Screenshot aus, falls vorhanden.
• Der Browser lädt sich selbst neu, nachdem er aufgehört hat zu tippen. Lösen Sie keine Neuladung aus.
• Wenn eine Runde "process changes" ausgelöst hat, beeinflusst die nächste Runde das nächste PDF.
• Hinterlassen Sie am Ende der Runde eine kurze Nachricht, die die wichtigsten Änderungen zusammenfasst.
• Erstellen Sie keine Struktur, die nicht existiert. Fragen Sie den Benutzer, wenn die Anforderungen unklar sind.
• Jedes Deck hat einen GitHub Pages-Link, der automatisch aus dem Deck-Namen (slug) erstellt wird: <slug>.github.io. Der Benutzer kann dies in der Deck-Ansicht kopieren.