Communitygithub.com

Produkt-Promo aus einem Repository

Erstellen Sie einen Produkt-Promo- / Launch-Video (宣传片、产品介绍视频、功能演示片) für ein Softwareprodukt, dessen Quellcode in einem Git-Repo liegt — mit Storylines, einer detaillierten Einstellungsbeschreibung, einem MiniMax-Voiceover (配音), einer programmatisch synthetisierten Originalmusik und den aus dem Frontend- und Backend-Code des Repos in HTML neu gezeichneten Bildschirmen. Verwenden Sie dies immer dann, wenn der Benutzer einen Promo-, Launch- oder Demofilm „für diese App / dieses Projekt / dieses Repo“ wünscht, eine GitHub-URL angibt oder ein lokales Projekt nennt und „做个视频“ sagt.

Was ist Produkt-Promo aus einem Repository?

Dieses Skill ermöglicht die vollständige Erstellung eines 30–45-sekündigen Produkt-Promo-Videos, das direkt aus dem Quellcode eines Git-Repos generiert wird. Es analysiert den Code, um Fakten über Navigation, Hauptaufgabenflüsse, Katalogdaten (z. B. aus Seed-Daten) und echte Grenzwerte zu sammeln – jede Behauptung im Film muss auf diesen Fakten basieren. Der Skill überspringt die Ausführung der App und erstellt stattdessen die Benutzeroberflächen aus den tatsächlichen Komponenten, CSS und Backend-Daten als HTML-Screenshots, sodass keine Mock-Daten oder veraltete Namen verwendet werden. Neben der visuellen Ebene erstellt er drei Storylines zur Auswahl, ein MiniMax-Voiceover mit zeitlich abgestimmten Szenen (ca. 4,5 chinesische Zeichen pro Sekunde), eine synthetisierte Originalmusik (mittels numpy+scipy) mit Betonung auf dem Höhepunkt und der Logo-Einblendung, sowie eine vollständige Spezifikation (SPEC.md) und ein Review (REVIEW.md). Die Plattformunterstützung ist universell für jedes Softwareprojekt mit einem Git-Repo, unabhängig vom verwendeten Framework (z. B. für Tools wie Claude Code, Cursor oder Codex). Der Skill ist besonders nützlich für Entwickler:innen und Produktteams, die schnell hochwertige, datengetreue Promos für ihre Arbeit erstellen möchten, ohne manuelle Screenshot-Feeds oder aufwändige Synthese.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rayest/ai-video-skills/tree/HEAD/skills/product-promo-from-repo

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Produkt-Promo aus einem Repository?

Ein 30–45 s langer Film, der zeigt, wie ein Betrachter eine echte Aufgabe im Produkt ausführt – mit echten Bezeichnungen aus dem Code, einem Voiceover und einer Originalmusik. Dieses Skill umfasst die korrekte Extraktion des Produkts aus seinem Code, der Geschichte, der Stimme, der Musik und den neu gezeichneten Bildschirmen. Es schreibt keine Rendering-Engine vor; wählen Sie eine gemeinsam mit dem Benutzer aus (bevorzugen Sie kostenlose Tools).

1. Den richtigen Code lesen

  • git fetch --all und Branches vergleichen (git log -1 origin/<b> für jeden), bevor Sie etwas anderes lesen. Der Standard-Branch kann veraltet sein – main könnte noch der initiale Commit sein, während das Produkt umbenannt und auf dev neu aufgebaut wurde. Storylines auf dem falschen Branch zu erstellen, verschwendet eine ganze Runde. Wenn der Benutzer sagt, dass der Name oder die Funktionen geändert wurden, glauben Sie ihm und finden Sie den Branch mit den Änderungen (git grep -c <neuer Name> origin/<b>).
  • Sammeln Sie Fakten, nicht Eindrücke: die Navigation (die Produktkarte, die zeigt, was das Produkt tut), die Seitenkomponenten des Hauptaufgabenflusses, Katalognamen in den Seed-Daten des Backends, echte Limits und Zahlen (maximale Längen, Formeln wie „预估秒数 = 字数 ÷ 4.5“). Jede Behauptung im Film muss auf eine dieser Informationen zurückgehen.
  • Kopieren Sie das Logo und die Vorschaubilder/Symbole aus dem Repo in assets/. Überprüfen Sie, ob das Logo keine alten Brandtexte enthält.

2. Storylines, dann stoppen

Schreiben Sie drei Storylines in STORYLINES.md (jeweils: Ein-Satz-Prämisse, Liste der Beats mit Zeitangaben, der Übergang, der jede Naht zusammenhält) und stoppen Sie, damit der Benutzer eine auswählen kann. Die Storyline, die sich bei einem mehrstufigen Produkt am besten bewährt hat: Ein Objekt reist durch die Produktschritte (ein gefundener Beitrag → eine Themenkarte → ein Skript → ein fertiges Video), das durch das Greifen des Cursors eingegeben wird. Setzen Sie Ihre Empfehlung an die erste Stelle.

Geben Sie die Annahmen in einer Zeile an: Länge 30–40 s, 1920×1080, Musik + Effekte, Voiceover ja/nein, Produktdaten auf dem Bildschirm sind Demodaten.

3. Voiceover (MiniMax)

Nur auf Anfrage. Geben Sie den $MINIMAX_API_KEY oder die erste Zeile von ~/.minimax_key ein; geben Sie ihn niemals aus.

  1. Eine kurze Zeile pro Beat in voice/script.json ([{"id", "text"}]), ca. 4,5 chinesische Zeichen pro Sekunde, ca. 120–140 Zeichen für 35–40 s. Die Zeilen sind Ursache und Wirkung, keine Slogans; der Bildschirm zeigt Schlüsselwörter, nie den gesprochenen Satz wörtlich.
  2. Zeigen Sie dem Benutzer die Zeilen, die Voice-ID und das Modell, und holen Sie ein „Ja“ – jeder Aufruf wird abgerechnet. python3 -I scripts/tts_minimax.py voice --dry-run gibt die Zeichenanzahl und die geschätzte Länge aus.
  3. Einmal generieren: python3 -I scripts/tts_minimax.py voice [--voice ID] → vo-<id>.mp3 und durations.json. Regenerieren Sie eine Zeile mit --only id.
  4. Die Stimme ist die Taktgeberin: Legen Sie die Szenen anhand von durations.json an (jede Zeile beginnt ca. 0,15–0,25 s in ihrer Szene; Szene ≈ Zeile + 0,3–0,6 s).

4. Produktbildschirme: aus Code neu zeichnen

Führen Sie die App nicht aus oder simulieren Sie kein Backend für Screenshots; bauen Sie die Bildschirme aus den Komponenten, CSS und Backend-Daten in HTML neu auf. Lesen Sie references/ui-redraw.md vor der ersten Produktszene.

Kennzeichnen Sie Demodaten mit 演示数据 · 虚构. Zeigen Sie niemals einen alten Produktnamen oder ein altes Logo, und erfinden Sie keine Schaltfläche, die der Code nicht hat.

5. Musik und Effekte

  • scripts/score.py synthetisiert einen Originaltrack, dessen Taktraster einen Downbeat auf dem Höhepunkt und den Logo-Hit eine ganze Anzahl von Schlägen später setzt (benötigt numpy + scipy): score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13 Wählen Sie --logo-beats so, dass payoff + beats × 60/bpm an der Stelle der Endkarte landet.
  • Effekte aus freien Quellen (Klick, Wisch, Popp, Tippen, Anstieg, Einschlag, Glitzern). Ein Ton pro sichtbarer Ursache.

6. Spezifikation und Review

  • Schreiben Sie SPEC.md vor den Szenen: GOAL, OUTPUT, TIME, VOICE, DATA, LOOK, OBJECTS, MOTION, SHOTS mit Zeiten, BANNED, QA frames.
  • Überprüfen Sie jeden Beat und jede Naht: Korrigieren Sie Nähte, deren Bewegungsrichtung umschlägt (ein Objekt, das nach rechts verlässt, muss in die nächste Szene von rechts eintreten), Elemente, die verblassen, bevor sie landen, leere Hälften eines Hero-Frames.
  • Schreiben Sie REVIEW.md: kreative Entscheidungen, was gemessen vs. nur angesehen wurde, die schwächste Einstellung.
  • Finale Audio-Pegel: etwa -16 bis -14 LUFS, Spitzenwert ≤ -1 dBTP, keine Übersteuerung. Geben Sie an, dass der Sound gemessen wurde, nicht gehört.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills