Communitygithub.com

kuankuan-kkk/reference-video-replication-3.1

Analysiere, passe streng an oder fusioniere Referenzvideos in nachvollziehbare UGC-Storyboards und freigegebene Video-Prompts. Steuere Schnittgrenzen, Identität, Produkt, Aktion und Kontinuität mit persistenten Nachweisen und expliziten Kamera-, Seitenverhältnis- und Dauer-Verträgen. Standardmäßig 9:16 Vier-Sekunden-Festansicht-Prompts, wenn kompatibel.

Was ist reference-video-replication-3.1?

Dieses Skill ist ein selbststartendes System zur Replikation von Referenzvideos für KI-Agenten in Entwicklungsumgebungen wie Claude Code, Cursor oder Codex. Es ermöglicht die Analyse, strenge Adaption oder kontrollierte Fusion von Quellvideos, um nachvollziehbare UGC-Storyboards (User Generated Content) und freigegebene Video-Prompts zu erstellen. Dabei werden eindeutige Verträge zu Kameraeinstellungen, Seitenverhältnis und Dauer geschlossen, wobei Standardeinstellungen wie 9:16 und vier Sekunden Festansicht verwendet werden, wenn sie kompatibel sind. Die Besonderheit liegt in der strengen Nachvollziehbarkeit: Jede Änderung muss durch Quellnachweise abgesichert sein, und nicht autorisierte Abweichungen (z. B. Gesichter, Kamerapositionen) werden blockiert. Der Skill bootstrapet jedes Projekt durch das Einlesen von Referenzdokumenten, die Ausführung von Preflight-Skripten und die Erstellung eines persistenten Projektmanifests (project.json). Er unterstützt verschiedene Routen (Analyse, Bild-Prompts, Storyboard, Video-Prompts, End-to-End) und Modi (strenge lokale Neuanfertigung, Multi-Video-Fusion, Szenentransplantation). Praktisch bedeutet das: Ein Entwickler lädt ein Referenzvideo hoch, der Agent analysiert es, erstellt ein strukturiertes Storyboard mit Zeitcodes und Shot-IDs, prüft die Qualität und liefert ein freigebefähiges Ergebnis. Nach expliziter Freigabe können daraus eigenständig kopierbare Video-Prompts generiert werden. Fehlerhafte Entwürfe bleiben intern, und Konflikte (z. B. unterschiedliche Seitenverhältnisse) werden über eine strukturierte Eskalationsstrategie gelöst.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kuankuan-kkk/replicate-videos-with-references-skill/tree/HEAD/replicate-videos-with-references-v3

In Ihrer bevorzugten KI fragen

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

Dokumentation

Referenz-Video-Replikation v3.1

Ergebnis

Rekonstruiere die quellgestützte Handlung und führe die vollständigen Aktionen aus, wobei nur das geändert wird, was der Benutzer autorisiert hat. Behandle die vollständigen Quellvideos und zugeordneten Referenzdateien als Beweismaterial. Leite niemals eine Sequenz aus einem Cover-Bild ab, wenn ein abspielbares Video existiert.

Dieses Skill ist selbststartend: Überprüfe zugängliche Anhänge, erkenne verfügbare Fähigkeiten, erstelle oder aktualisiere ein Projektmanifest, frage einmal nach materiellen Hindernissen und fahre vom gespeicherten Zustand fort. Verlasse dich nicht auf gespeicherte Präferenzen oder vorherige Unterhaltungen.

Jedes Projekt bootstrappen

  1. Lese references/default-profile.md.
  2. Lese references/input-contract.md, überprüfe zugängliche Dateien und frage einmal nach allen materiellen Hindernissen.
  3. Lese references/capability-and-fallback.md. Führe scripts/preflight.py aus, wenn lokale Ausführung verfügbar ist. Versprich niemals eine Detailtreue, die die Umgebung nicht überprüfen kann.
  4. Lese references/structured-state-and-gates.md. Erstelle kanonisches project.json mit scripts/init_project.py; JSON in einer .yaml-Datei wird ebenfalls unterstützt. Validiere tatsächliche Struktur und Beweise mit scripts/validate_project.py. Gewöhnliches Legacy-YAML benötigt PyYAML. Das Manifest – nicht der Chat-Speicher – ist die persistente Quelle des Projektzustands. Bewahre Legacydrafts mit scripts/migrate_project.py, ohne ungebundene Legacy-Freigaben nach vorne zu tragen.
  5. Klassifiziere die Route und den Modus unten. Lade nur die für diese Route erforderlichen Referenzen.

Benutzeranweisungen überschreiben Standardeinstellungen. Priorität ist: letzte explizite Korrektur > explizite Sperren und autorisierte Änderungen > zugeordnete Benutzerreferenzen > beobachtbare Quellbeweise > dokumentierte Standardeinstellungen > notwendige bezeichnete Inferenz.

Routen

  • Analyse: Überprüfe Videos und gebe zeitcodierte Fakten oder einen Replikationsplan zurück. Lese references/workflow-and-state.md und references/segmentation-and-fusion.md.
  • Bild-Prompts: Analysiere und gebe eigenständige Basis-Bild-Prompts ohne Generierung zurück. Lese auch references/image-production-and-qa.md.
  • Storyboard: Analysiere, generiere, QA, repariere, liefere aus und stoppe zur Freigabe. Lese alle Referenzen außer dem Video-Prompt-Format bis zur Freigabe.
  • Video-Prompts: Verwende vom Benutzer freigegebene Bilder und Quellaktionslogik. Lese references/video-prompt-format.md.
  • Ende-zu-Ende: Schließe ab und liefere das Storyboard aus, dann stoppe. Fahre mit Video-Prompts nur nach expliziter Freigabe in einem späteren Schritt fort.

Modi

  • Strenge lokale Neuanfertigung: Standard für „复刻“, „照搬“, „其他不变“ oder Äquivalente. Quellgeometrie, Kamera, Performance, Architektur, feste Möbel, Objektpositionen und Licht sind außerhalb autorisierter Masken gesperrt. Beklage Pixeltreue nur auf Fähigkeitsstufe A.
  • Multi-Video-Fusion: Nur auf Anfrage. Jede verwendbare Quelle muss einen identifizierbaren Beitrag leisten. Bewahre die interne Chronologie jeder entliehenen Aktion und ordne jeden finalen Frame Quellbeweisen zu.
  • Szenentransplantation/Licht-Textur-Anpassung: Nur auf Anfrage. Die Zielszene kontrolliert das Layout; Quellvideos kontrollieren die Aktionsgrammatik und beobachtbare UGC-Lichttextur. Bezeichne dies niemals als Pixel-Level-Replikation.

Unverhandelbare Invarianten

  • Überprüfe vollständig zugängliche Videos; weise chronologische S01...-Shot-IDs und B01...-Komplettaktions-IDs zu.
  • Ein B repräsentiert eine physisch vollständige Aktion von einem erreichbaren Startzustand zu einem sichtbaren Ergebnis. Angeforderte Anzahlen werden durch die dokumentierte Zählrichtlinie behandelt, niemals durch bedeutungslose Duplikate.
  • Charakterreferenzen kontrollieren Identität und explizit angeforderte Eigenschaften, nicht Quellpose, Ausdruck, Blickrichtung, Ausschnitt oder Licht. Zeige niemals ein Gesicht, das in der Quellkomposition nicht vorhanden ist.
  • Nicht aufgeführte sichtbare Eigenschaften sind im strengen Modus gesperrt. Große Dekoränderungen betreffen bewegliches Dekor und benannte Oberflächen, nicht den stillen Wiederaufbau des Raums.
  • Palettenänderungen betreffen autorisierte Objektoberflächen, nicht Haut, Beleuchtung, Schatten, neutrale Glanzlichter oder globale Gradierung.
  • Präsentiere die Entfernung von Untertiteln, Benutzernamen, Plattform-UI und Wasserzeichen als explizite Standardbearbeitungen und protokolliere die Zustimmung des Benutzers sowie die anwendbare Quellnutzungserlaubnis, bevor du sie durchführst. Diese Bereiche werden nicht stillschweigend aus der Bearbeitungsgrenze ausgeschlossen.
  • Bewahre Handbesitz, Objektanzahl und -zustand, räumliche Richtung, Kleidungszustand, Raumzustand, Produktautorität und Kausalität zwischen benachbarten Shots.
  • Behalte fehlgeschlagene Entwürfe intern. Repariere die kleinste freigegebene Vereinigung von Haupt- und notwendigen assoziierten Bereichen und überprüfe erneut gegen die ursprüngliche extrahierte Basislinie. Stelle versehentlich geänderte gesperrte Bereiche aus dieser Basislinie wieder her oder mache sie rückgängig; erweitere niemals eine Maske, um einen Fehler zu verbergen. Bewahre fehlgeschlagene Versionen intern für nachvollziehbare Überprüfungen auf.

Konflikte bei Seitenverhältnis, Kamera oder Dauer sind ein Planungsblocker. Bewahre die Quelle und vollständige kausale Aktion, bis der Benutzer eine aufgezeichnete Alternative akzeptiert. Erzwinge nicht 9:16, vier Sekunden oder eine feste Kamera durch Beschneiden, Auslassen von Ergebnissen oder stilles Umstellen. Wende die strukturierte Auflösungsrichtlinie an.

Verwende scripts/manage_project.py für durchsetzbare lokale Zustands-/Freigabe-/Versionsänderungen. Freigabe bindet exakte B-IDs, Ausgabe-Hashes und Constraint-Fingerabdrücke. Geänderte Abhängigkeiten oder widerrufene Downgrade-Akzeptanz machen aktuelle Freigaben ungültig. Wiederholungshistorie überlebt Regeneration; zwei Fehler bei einem B+Problem erfordern einen aufgezeichneten, von Menschen überprüften neuen Plan. Ein fehlender Frontend-Button ersetzt diese Validierung nicht.

Ausführung und Lieferung

Folge references/workflow-and-state.md, references/segmentation-and-fusion.md und references/image-production-and-qa.md. Verwende references/error-and-recovery.md bei Blockern oder widersprüchlichen Anfragen.

Liefere bestandene Storyboard-Bilder in aufsteigender B-Reihenfolge mit Quell-IDs/Zeitcodes, vollständiger Aktion, Fähigkeitsstufe und einer kurzen QA-Zusammenfassung. Frage dann den Benutzer, ob er „生成视频提示词“ antworten soll. Stille und eine ursprüngliche Ende-zu-Ende-Anfrage sind keine Freigabe.

Nach Freigabe und einer expliziten Video-Prompt-Anfrage erstelle einen eigenständig kopierbaren Prompt pro freigegebenem Bild in identischer Reihenfolge, unter Verwendung von references/video-prompt-format.md. Verwende standardmäßig Vier-Sekunden-Festansicht nur, wenn kompatibel; andernfalls verwende den explizit freigegebenen Kamera-/Dauervertrag und lege die Anpassung offen.

Verwandte Skills