JohnsonZhangCN/music-mv-skill

Music MV

Erstellt aus Benutzermaterialien ein performatives 2D-Handzeichnungs-Musikvideo mit Liedtext-Synchronisation und Übergängen als abspielbare MP4-Datei. Enthält eine integrierte painted-animation-Engine basierend auf p5.js + p5.brush, Beispiele und ein Windows-Paket. Benötigt keine andere installierte Fähigkeit und keine externe Videogenerierungs-API.

Aktuelle Parameter:

$ARGUMENTS

Anfrage analysieren

Akzeptiert natürliche Sprache auf Chinesisch oder key=value. Erforderlich: Charakterbild image, Lied audio, Liedtext lyrics, Start start, Ende end, Stil style. Pfade mit Leerzeichen werden in Anführungszeichen unterstützt. Zeitangaben werden als Sekunden, M:SS oder H:MM:SS akzeptiert. Fehlende Parameter werden aufgelistet; bereits vorhandene werden nicht erneut abgefragt.

Standard: 1920×1080, 24fps, zeilenweise Liedtexte, alle klar erkennbaren Charaktere im Bild, Ausgabe in ein neues Verzeichnis unter outputs/music-mv des aktuellen Projekts. Bei Angabe eines einzelnen Hauptcharakters, ohne Untertitel oder mit anderer Bildrate wird dies berücksichtigt. Bei komplexen Charakterbildern wird zunächst eine Modelltabelle definiert und Testframes gezeichnet; das Bild dient als Identitäts- und Stilreferenz, nicht als reine Texturverschiebung oder statische Diashow.

Für den Stil "小镇姑娘" wird references/styles.md gelesen und assets/painted-animation/docs/xiaozhen-sheet.jpg überprüft. Dieser Stilname zeigt auf Aquarellpapier, Tuschelinien, limitierte Frame-Performance, Liedtextmotive und nahtlose Übergänge, ohne die Handlung des Originalsongs zu kopieren. Andere Stile werden auf realisierbare 2D-Zeichensprache abgebildet. Echte Aufnahmen oder 3D-Anforderungen erhalten zunächst eine Erklärung der Grenzen dieser Engine.

Produktion

1. Überprüfe die drei Eingabedateien und das Charakterbild. Gib zuerst einen kurzen Plan aus: Charaktere, Haupthandlung, visueller Stil, Dateipfade; beachte vorhandene Genehmigungsanforderungen des Projekts. Wenn der Benutzer die vollständige Generierung autorisiert hat, führe diese bis zum fertigen Video durch. Nur wenn "Nur Storyboard anzeigen" gewählt wurde, stoppe nach dem Storyboard.
2. Lese assets/painted-animation/template/ANIMATION_GUIDE.md und references/production.md. Wenn Musikkomposition erforderlich ist, lese references/music-video.md; dessen Vorschläge zur Erweiterung von Fragmenten pro Takt dürfen den genauen Auswahlbereich des Benutzers nicht überschreiben. Wenn der Modus "Nur Storyboard anzeigen" ist, lese nur Bild und Liedtext, messe den Takt und schreibe das Storyboard; überspringe Engine-Installation, Szenenerstellung und Rendering, liefere das Storyboard aus.
3. Schreibe das normalisierte JSON mit Dateiwerkzeugen in .cache/music-mv-request.json des aktuellen Projekts. Weisen Sie einen absoluten Pfad zu, der im aktuellen Projekt noch nicht existiert. Bereiten Sie Materialien und Projekt mit dem Skript vor:

   python "${CLAUDE_SKILL_DIR}/scripts/prepare_mv.py" --request "<absoluter JSON-Pfad>" --install
   

   Windows-Abhängigkeiten, Cache und Browser siehe references/windows.md. Das Hilfsskript bereitet nur das Projekt vor; die Szenen werden von Ihnen erstellt.
4. Lese die generierten Dateien mv-task.json, analysis/lyrics.json; bestätige BPM und beat_offset. Bei Fehlern behebe Abhängigkeiten und messe, oder verwende die vom Benutzer bereitgestellte BPM; verwende keine Schätzungen als Messungen. Behalte den angegebenen Audiobereich bei; füge keine eigenmächtigen Einleitungen, Tempoänderungen oder Ausblendungen hinzu. Normale LRC-Dateien bieten nur zeilenweise Zeitangaben; Liedtextfärbung ist eine Schätzung innerhalb der Zeile und kann nicht als buchstabengetreue Ausrichtung beansprucht werden.
5. Schreibe vollständige STORYBOARD.md: Für jede Einstellung: Zeit, Liedtext, Aktion, Komposition, Übergang. Erstelle Szenendateien in src/scenes, registriere sie in studio.html; entferne Demoszenen. Charaktere sollten Ausdrücke, Vorbereitungsbewegungen, Gewichtsverlagerungen, Folgeaktionen und lesbare Performance haben. Jeder Frame ist eine reine Funktion der Zeit t.
6. Rendere repräsentative Frames, Action Bars und Übergänge jeder Einstellung mit scripts/render_mv.mjs, öffne Bilder zur Überprüfung und korrigiere. Wenn keine Untertitel, entferne das Laden von karaoke.js in studio.html.
7. Rendere das vollständige Video; die Verpackung überprüft Dauer, Abmessungen, Bildrate und Tonspur. Überprüfe Anfang, Ende und alle Übergänge, liefere dann die echten absoluten Pfade von MP4, Storyboard und Vorschaubildern. Nach Änderungen rendere betroffene Frames neu und vermeide die Wiederverwendung alter Frames. Verwende keine ungeöffneten Vorschaubilder oder nicht abgespielte/überprüfte Videos, um die Qualität zu bestätigen.

Standardreihenfolge: Materialprüfung → Storyboard → Szenenerstellung → Vorschaukorrektur → MP4. Fordere keine wiederholte Genehmigung zwischen normalen Schritten an. Verwende Unteragenten nur auf ausdrücklichen Wunsch des Benutzers.

Aufruffbeispiel

/music-mv Charakter="D:/mv/character.png" Lied="D:/mv/song.mp3" Liedtext="D:/mv/song.lrc" Ausschnitt="00:39-01:07" Stil="小镇姑娘"

Optional: Charaktermodus=Nur orangener Hauptcharakter, Untertitel=Keine, Modus=Nur Storyboard anzeigen. Bei mehreren klar erkennbaren Charakteren im Bild werden standardmäßig alle gezeigt und das Video durchgehend erstellt.

Quelle und Lizenz siehe references/credits.md.