Communitygithub.com

HomenShum/NodeKit

Erfasse eine umfangreiche Codeänderung, Architekturmigration, Benchmark, Veröffentlichung oder fertiggestellte Hackathon-Anwendung als bearbeitbare, evidenzgestützte Präsentation. Verwende es, wenn Codex erklären muss, was sich geändert hat, eine Jury- oder Prüfer-Präsentation zusammenstellen soll, Präsentationsmaterial während der Entwicklung aktuell halten oder NodeSlide über sein Paket, CLI, MCP oder Host-Adapter steuern muss.

Was ist NodeKit?

NodeKit Present ist ein KI-unterstütztes Skill für Codex und ähnliche Entwickleragenten, das den Prozess der Erstellung presentationsfähiger Artefakte aus nachweisbaren Entwicklungsereignissen formalisiert. Es zwingt den Agenten, jede Behauptung in der Präsentation mit tatsächlichen Beweisstücken wie Commits, Screenshots, Testergebnissen und Benchmarks zu untermauern, anstatt ungeprüfte Aussagen zu treffen. Der Skill definiert einen strengen Workflow: Klassifiziere die Änderungsstufe (Feature, Release, etc.), erfasse Beweise während der Arbeit, baue einen Beweisindex mit Status und Prüfvermerken auf, plane jede Folie mit spezifischen Zielen und Fragen des Publikums, rendere über den NodeSlide-Transport, überprüfe jede materielle Behauptung gegen den aktuellen Commit und exportiere in das gewünschte Format. Es ist auf Plattformen wie Codex (OpenAI), Claude Code (Anthropic) und Cursor ausgelegt und nutzt NodeSlide als Präsentations-Backend. Der Skill enthält außerdem ein eigenes Video-Beurteilungssystem, das sowohl die handwerkliche Qualität als auch das Verständnis für Laien bewertet, wobei letzteres als harte Barriere für die Veröffentlichung fungiert. Referenzvideos werden über zitationsbasierte Pipelines gewonnen, ohne Urheberrechtsverletzungen. Der Skill enthält auch ein Vertragsmodell für Launch-Filme, das menschliche Genehmigungen vor dem Rendern erzwingt.

Funktioniert mit~Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/HomenShum/NodeKit/tree/HEAD/plugins/nodekit/skills/nodekit-present

In Ihrer bevorzugten KI fragen

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

Dokumentation

NodeKit Präsentieren

Verwandle verifizierte Entwicklungsartefakte in eine lebendige Präsentation. Behandle die Präsentation als Projektion des Änderungsprotokolls, niemals als unabhängige Quelle von Behauptungen.

Lies den Änderungs-Story-Vertrag, bevor du Präsentationsartefakte erstellst oder aktualisierst.

Arbeitsablauf

  1. Klassifiziere die Änderungsebene. Überspringe Präsentationen für triviale Arbeiten; verwende eine Änderungskarte für eine kleine Korrektur, eine Mini-Präsentation mit 3–5 Folien für ein größeres Feature und eine vollständige Präsentation mit Anhang für Veröffentlichungen oder Hackathons.
  2. Erstelle oder aktualisiere changes/<change-id>/change.yaml. Halte fest: Zielgruppe, Problem, vorherigen Zustand, Entscheidung, Alternativen, betroffene Systeme, Benutzerablauf, Nachweis-Anforderungen, Einschränkungen und Präsentationsebene.
  3. Sammle Beweise während der Arbeit: Basis- und Nachher-Screenshots, genaue Commits, Bereitstellungsidentität, Tests, Benchmarks, Traces, Artefakte, Exporte und bekannte Fehlschläge. Bewahre rohe Belege auf.
  4. Erstelle einen Beweisindex. Gib jeder materiellen Behauptung einen Status und Beweis-IDs. Kennzeichne geplante, abgeleitete, benutzerbehauptete und gemessene Behauptungen deutlich.
  5. Plane jede Folie vor dem Rendern. Gib ihren Zweck, die Frage des Publikums, die Kernaussage, die narrative Rolle, die dominante Visualisierung, Beweis-IDs, das Dichtebudget und das Ziel der Sprechernotizen an.
  6. Verwende den installierten NodeSlide-Transport in dieser Reihenfolge: Repository-native Adapter, NodeSlide CLI, NodeSlide MCP oder Paket-API. Überprüfe zuerst die Fähigkeiten und gehe niemals davon aus, dass gehostete Schreibvorgänge, Exporte oder Genehmigungen verfügbar sind.
  7. Schlage Präsentationsänderungen gegen die festgelegte Präsentationsversion vor. Validiere, vergleiche und wende sie gemäß der Host-Richtlinie an; umgehe NodeSlide-Governance nicht aus Bequemlichkeit.
  8. Überprüfe jede materielle Behauptung gegen den aktuellen Commit oder die aktuelle Bereitstellung. Aktualisiere veraltete Screenshots und Metriken. Halte Einschränkungen sichtbar.
  9. Exportiere das angeforderte bearbeitbare Format und öffne es erneut. Überprüfe die gerenderte Präsentation, die Sprechernotizen, die Quellbindungen und etwaige PPTX-Roundtrips.
  10. Leite das Demo-Skript, den README-Abschnitt, die Versionshinweise und den Einreichungstext aus derselben Änderungs-Story und demselben Beweisindex ab.

Ein Demo-Clip ist ein gerenderter Durchlauf, niemals eine Bildschirmaufnahme

Dieser Abschnitt existiert aufgrund eines gemessenen Fehlschlags. Ein Produktions-Deployment wurde am 11.11. mit einem aufgezeichneten Clip verifiziert, und der Clip war eine rohe Playwright-Aufnahme: keine Fokusrahmung, keine Untertitel, keine sichtbaren Streams oder Tool-Aufrufe, keine Folien. Die Werkzeuge für all das existierten bereits, und dieses Skill nannte keines davon, also wurde es stattdessen schlecht von Hand gemacht, anstatt gut gesteuert zu werden.

FeatureClipStudio (feature-walkthrough-gif/) ist die Aufnahme-zu-Rendering-Pipeline und deckt die vier Dinge ab, die eine rohe Aufnahme nie hat:

was einer rohen Aufnahme fehltwas die Pipeline macht
Fokus auf das WesentlicheZoom-zu-Fokus Kamera, animierter Cursor, der zu jedem Klick gleitet, mit einem Welleneffekt
ErklärungSchritt-für-Schritt-Beschriftungen pro Zustand
Sichtbarkeit der ArbeitLaden und Streamen LIVE eingefangen – Spinner dreht sich, Ergebnisse treffen ein
Interna, wenn die Behauptung davon abhängtRohe JSON-/Zustands-Beweisfelder
npm run capture   # Playwright steuert den Live-Ablauf und zeichnet jeden UI-Zustand auf
npm run studio    # Storyboard der aufgezeichneten Zustände
npm run render    # Remotion rendert den Durchlauf
npm run judge     # Gemini sieht sich das RENDER an und bewertet es

judge-video.mjs ist das Tor, und es ist das, was ausgeführt werden muss, bevor ein Clip als fertig bezeichnet wird. Es sieht sich das gerenderte MP4 anhand einer Anti-Helden-Schuss-Bewertungsmatrix an und gibt mit Zeitstempeln versehene Mängel auf P0/P1/P2 zurück – P0 blockiert die Veröffentlichung. Der eigene Header des Programms sagt es deutlich: Der endgültige Schnitt hört auf, die Bühne zu sein, die nur menschliche Augen jemals überprüfen. Bewerte das MP4 und nicht das GIF; GIF ist kein unterstützter Video-MIME-Typ.

Betrete keine erneute Rendering-Polish-Schleife über P2s, die der Richter bereits bestanden hat.

Zwei Achsen, und die zweite ist diejenige, die versagt

judge-video.mjs bewertet CRAFT – Cursor-Wahrheit, Tempo, Lesbarkeit, Bewegung – und separat COMPREHENSION, die zehn Dinge, die ein Betrachter tatsächlich mitnehmen muss:

Persona · Zweck · Anwendungsfall · Feature-Klarheit · vollständige Interaktion
Reaktionsfähigkeit · Ablauf · Ergebnis · Laienverständnis · Transfer

Sie sind orthogonal, und ein Schnitt kann gut gemacht und unverständlich sein. Gemessen an einem echten Render: Craft bestanden mit einem Urteil von publish, und Verständnis erzielte bei allen zehn eine 1 – nichts fehlend, nichts explizit, alles nur impliziert – wobei der Richter 0:06 als den Zeitpunkt nannte, an dem ein Laie verloren war („Schichtenarchitektur-Konzepte und Terminal-Log-Ausgaben“).

non_expert_sense ist der Mama-Test und BLOCKIERT für sich allein, unabhängig von den Gesamtergebnissen. Ein Tor, das ein Video passieren lässt, von dem sein eigener Richter sagt, dass niemand außerhalb des Fachgebiets es verstehen könnte, ist kein Tor. Einheitliche Bewertungen über alle zehn hinweg werden eher markiert als gemittelt, weil „alle 1er“ bedeutet, dass alles impliziert und nichts ausgesagt wurde, was ein Befund ist und keine mittelmäßige bestandene Leistung.

DIE SCHLEIFE IST DER STANDARD, keine Endkontrolle: rendern, bewerten, lesen, was laut Richter fehlt, neu schneiden, erneut bewerten. Drei Schnitte an einem Film brachten ihn von 10/20 auf 13/20 und, was noch nützlicher ist, verrieten dem Ersteller, dass die Geschichte um den falschen Moment herum aufgebaut worden war – etwas, das keine noch so große Selbstüberprüfung aufgedeckt hatte. Höre auf, wenn die Verständlichkeit klar ist und die verbleibenden Mängel P2 sind.

NodeSlide für die Präsentation, NodeVideo für Beweise auf Frame-Ebene – ein Frame, der als das laufende Produkt präsentiert wird, muss an die Bereitstellung gebunden sein, von der er stammt, und presentedAs macht das überprüfbar.

Wo Referenzvideos herkommen

Mobbin funktioniert für UI, weil es ein Korpus ist, den man BEOBACHTET und ZITIERT, niemals kopiert. Video braucht die gleiche Disziplin und teilt sich in zwei Arten, die nicht austauschbar sind:

ABLAUF-Referenzen – was ein echtes Produkt tatsächlich tut, Schritt für Schritt. Page Flows ist das direkte Analogon: aufgezeichnete Benutzerreisen statt Screenshots, 20.000+ Apps, organisiert nach Aufgaben – anmelden, upgraden, kündigen – inklusive des Zustimmungsdialogs, der Feldvalidierung, des leeren Zustands und des Erfolgsbildschirms. Seine eigene Rahmung ist die Anti-Helden-Schuss-Regel, die von der anderen Seite her formuliert ist: Mobbin zeigt dir das Ziel, Page Flows zeigt dir die Reise. ScreensDesign deckt Onboarding und Paywalls mit angeschlossenen Umsatzsignalen ab. Verwende diese, um zu beantworten: „Welche Zustände enthält ein echter Ablauf dieser Art, und welche überspringe ich?“

HANDWERK-Referenzen – wie ein Launch-Film aufgebaut ist. Beginne mit YouTube. Der Richter liest direkt eine YouTube-URL – verifiziert: Gemini hat eine angesehen und ihre ersten Sekunden und Laufzeit allein aus der URL beschrieben, ohne Download. Eine Referenz wird also ZITIERT, niemals kopiert, was die Lizenzfrage komplett auflöst und den Locator zu einer URL plus einem Zeitstempel macht:

Der Agent baut sein eigenes Korpus auf, anstatt darauf zu warten, dass ihm eines übergeben wird. yt-dlp DURCHSUCHT YouTube und liest Metadaten; nichts wird heruntergeladen, und Gemini sieht sich die URL an:

node find-references.mjs "Raycast Produkt-Demo" "Linear Produkt-Demo"   # suchen, priorisieren, beobachten
node judge-video.mjs out/demo.mp4                                       # Korpus automatisch verwendet
node judge-video.mjs out/demo.mp4 --no-reference                        # Opt-out

find-references.mjs priorisiert, BEVOR Token ausgegeben werden: Alles über 180s wird standardmäßig abgelehnt, weil es die falsche Form und die falschen Kosten für einen kurzen Durchlauf hat, mit Angabe des Grundes. Gemessen an einem echten Durchlauf – eine 39s First-Party-Demo kostete 3,9k Prompt-Token, eine 18-minütige 102k. Es schreibt dann references/video/<id>.json: mit Zeitstempel versehene atomare Fakten (0:07 Bewegung – Tasten werden bei Tastendruck grün), hookSeconds, gezeigte Zustände, was zu stehlen und was nicht zu stehlen ist, plus eine notRun-Liste für alles, was es nicht ermitteln konnte. Fakten, niemals Adjektive – ein Fakt bewertet einen Kandidaten, ein Adjektiv kann das nicht.

Das Urteil erhält einen reference-Block – singleMoment, statePacing, motionPurpose, whatToSteal und whatNotToSteal – mit einem erforderlichen Zeitstempel für jede Behauptung über die Referenz. Jeder sehenswerte Produkt-Launch-Film ist bereits auf YouTube und ist die Primärquelle; die unten aufgeführten kuratierten Bibliotheken sind eine Entdeckungsschicht darüber, nützlich zum FINDEN von Kandidaten, nicht zum Ansehen.

Kosten sind real: Eine 18-minütige Referenz maß 102k Prompt-Token. Bevorzuge einen 30–90-Sekunden-Schnitt und übergib höchstens zwei oder drei Referenzen.

FlowJam ist handkuratierte SaaS- und Produkt-Launch-Videos; Tella's Bibliothek und Vidico's Analysen veröffentlichen Beispiele mit der dazugehörigen Begründung. Verwende diese für Tempo, den einzelnen Moment und dafür, wo Bewegung Arbeit leistet versus dekoriert.

Füge keine der beiden Arten als Prosa in die Bewertungsmatrix ein. Zeichne sie so auf, wie eine Mobbin-Beobachtung aufgezeichnet wird: ein atomarer Fakt, mit einem locatorDescription, der für Video ein ZEITSTEMPEL ist, zitiert zur Quell-URL. Die Behauptung lautet „bei 0:12 wird der Ladezustand 1,4 s lang gehalten, bevor das Ergebnis erscheint“, nicht „ihr Tempo ist gut“. Eine Regel, die aus einer zeitgestempelten Beobachtung abgeleitet wurde, kann bewertet werden; ein Adjektiv kann das nicht.

Lizenz: beobachten und zuordnen, niemals neu hosten. licenceMode im Beobachtungsschema ist absichtlich ein einzelner aufgezählter Wert – die Erweiterung auf eine neue Quellklasse ist eine Lizenzprüfung und eine bewusste Schema-Änderung, kein eingegebener String.

Ein Launch-Film wird inszeniert, dann gerendert – der Launch-Video-Vertrag

Alles oben Bewertet schneidet einen bereits existierenden Schnitt. Ein LAUNCH-Film scheitert früher: Er ist um den falschen Moment herum gebaut oder wird nach dem Launch ausgeliefert, und keine Richterschleife kann beides wieder gutmachen. Studiert live bei Motion Studio (Launch-Filme für YC-taugliche Startups): Ihr Prozess ist Regie → Erster Entwurf → Überarbeitungen → Auslieferung, und „ein menschlicher Regisseur trifft jede Geschmacksentscheidung“. Diese Reihenfolge ist das Produkt. nodekit launch-video trägt es als ablehnbaren Vertrag, sodass ein gesteuerter Codierungs-Agent die Phasen durchläuft, anstatt direkt zu npm run render zu springen:

nodekit launch-video declare --application <slug> --out launch-video.json
# 1 BRIEF      Produkt, Geschichte (in den Worten des Stakeholders), Zielgruppe, Launch-Datum, Kanäle ausfüllen
# 2 REGIE      singleMoment, geordnete Beats, Referenzen via find-references.mjs (zeitgestempelte
#              Fakten, niemals Adjektive), durationTargetSeconds ≤ 180 – dann genehmigt ein MENSCH
# 3 ENTWÜRFE   capture → studio → render (FeatureClipStudio oder NodeVideo), judge-video.mjs auf
#              dem MP4, den Zyklus aufzeichnen: Schnitt, Richter-Bewertung, menschliche Notizen, Verfügung
# 4 AUSLIEFERUNG finalCut + judgeReceipt + menschliche Genehmigung, deliveredAt VOR launchDate
nodekit launch-video check --contract launch-video.json   # verweigert an jedem Phasenausgang

Was der Check verweigert, und warum jede Verweigerung existiert:

  • Entwürfe vor einer genehmigten Regie – der erste Schnitt stimmt sich auf eine Regie ab, er entdeckt sie nicht; ein Render, der vor dem Zurückkommen der Regie erstellt wurde, ist die Revisionsrechnung.
  • Eine Referenzbehauptung ohne Zeitstempel – „ihr Tempo ist gut“ kann nicht bewertet werden; „bei 0:12 hält der Ladezustand 1,4s“ schon.
  • Ein letzter Zyklus, der non_expert_sense nicht besteht – der Mama-Test blockiert die Auslieferung allein, dieselbe Regel wie oben bei der Richterschleife; der Vertrag macht es zu einem Phasenausgang statt zu einem Ratschlag.
  • deliveredAt nach launchDate – ein Launch-Film, der nach dem Launch ausgeliefert wird, ist ein Rückblick.
  • Auslieferung ohne menschliche Genehmigung – der Richter ist beratend; die Geschmacksentscheidung trifft eine Person.

Die Richterschleife bleibt die innere Schleife von Phase 3, genau wie oben beschrieben. Der Vertrag fügt hinzu, was die Schleife allein nie hatte: die Phasen in der richtigen Reihenfolge, den Menschen an den beiden Geschmackstoren und das Datum.

Parallele Spur

Für eine große Implementierung führe die Präsentationsarbeit als leselastige Spur neben dem Bauen und der Qualitätssicherung aus. Skizziere das Problem und die Architektur früh; ersetze Platzhalter nur mit verifizierten Beweisen aus späteren Toren. Blockiere die Veröffentlichung nur bei nicht belegten Behauptungen, fehlenden erforderlichen Nachweisen, veralteten Beweisen oder einem defekten Export.

Abschlusssprache

  • Sage entworfen, wenn Folienpläne existieren.
  • Sage beweisfundiert, wenn sich jede materielle Behauptung auf aktuelle Beweise bezieht.
  • Sage export-verifiziert erst, nachdem die angeforderte Ausgabe erfolgreich wieder geöffnet wurde.
  • Sage release-bereit erst, wenn sowohl der Anwendungsnachweis als auch der Präsentationsnachweis bestanden sind.

Verwandle einen grünen Unit-Test nicht in eine Produktionsbehauptung, einen HTTP 200 nicht in einen Browser-Beweis oder eine beratende Modellbewertung nicht in ein autoritatives Urteil.

Verwandte Skills