naive-kun/naive-video-skill

Talking-Head-Video-Pipeline

Wandeln Sie rohe oder grob geschnittene Talking-Head-Aufnahmen in einen genehmigten Arbeitsschnitt, bearbeitbare Untertitel, eine motion-gestützte Vorschau und einen verifizierten finalen Export um. Behandeln Sie diese Datei als Router und gemeinsamen Vertrag. Lesen Sie nur den weitergeleiteten internen Workflow und die Referenzen, die für die aktuelle Phase benötigt werden.

Anfängerversprechen

Gehen Sie davon aus, dass der Benutzer noch nie mit Codex bearbeitet hat.

• Stellen Sie immer nur eine kurze Frage, wenn eine Antwort nicht sicher abgeleitet werden kann.
• Bevorzugen Sie einen funktionierenden Standardwert gegenüber vielen technischen Optionen.
• Erklären Sie das nächste sichtbare Ergebnis, nicht die Interna des Renderers.
• Stellen Sie Grobschnitt, Transkriptionsanbieter oder API-Einrichtung nur vor, wenn rohes Material tatsächlich diesen Zweig benötigt.
• Erklären Sie kostenpflichtige und lokale Optionen klar, empfehlen Sie eine, wenn es sinnvoll ist, und erzwingen Sie sie nie.
• Beenden Sie jede Phase mit genauen Ausgabepfaden und dem nächsten Satz, den der Benutzer sagen kann.
• Setzen Sie vorhandene Arbeit fort, anstatt sie neu zu starten.

Nicht verhandelbare Regeln

1. Quelle ist unveränderlich. Überschreiben oder bearbeiten Sie die bereitgestellte Quellmedien nie destruktiv.
2. Hauptaudio ist die Uhr. Nehmen Sie keine Neuskalierung, Neuordnung, Resampling oder Ersetzung der Tonspur vor, es sei denn, der Benutzer stimmt einer Grobschnitt-Strategie ausdrücklich zu. Nach der Genehmigung wird das abgeleitete working_video zur nachgelagerten Uhr, während das Original unveränderlich bleibt.
3. Beweise bleiben lesbar. Decken Sie niemals Screenshot-Text, Produkt-UI, Gesichter oder benutzermarkierte sichere Zonen ab. Verwischen Sie keine Beweis-Assets.
4. Vorschau vor dem Finale. Erstellen Sie eine offizielle Vorschau und warten Sie auf die Genehmigung, es sei denn, der Benutzer fordert ausdrücklich einen direkten Export an.
5. Originalqualität final. Präsentieren Sie eine hochskalierte niedrig aufgelöste Vorschau nicht als echtes hochauflösendes Finale. Verwenden Sie wann immer möglich die Originalquelle als finale Basis.
6. Unterbrechen Sie den Fortschritt nicht. Wenn ein Render läuft, warten Sie und melden Sie den Fortschritt. Wechseln Sie die Pipeline nur nach einem echten Fehler oder einer ausdrücklichen Genehmigung.
7. Keine privaten Daten im Skill. Projektlokale Pfade, Mediennamen, Markenregeln, Screenshots, Kundendetails und API-Schlüssel bleiben im Projekt des Benutzers.
8. Lernen Sie nur aus explizitem Feedback. Leiten Sie keine dauerhaften Stilregeln aus Schweigen oder einem unbestätigten Entwurf ab.
9. Typografie ist Teil der Korrektheit. Deklarieren und überprüfen Sie Schriftfamilie, tatsächliche Stärke, Untertitelzeilenrichtlinie, Grundlinienausrichtung und Passform des längsten Labels vor der Genehmigung.
10. Öffentliche Voreinstellungen bleiben markenneutral. Speichern Sie Creator-Paletten, wiederkehrende Kartensysteme und private visuelle Regeln nur im lokalen Profil.
11. Öffentliche Installation legt einen Skill frei. Halten Sie Stufenmodule unter references/workflows/; fügen Sie keine verschachtelten SKILL.md-Dateien hinzu, die von Paketmanagern separat registriert werden könnten.
12. Installationsvorgänge sind wiederherstellbar. Sichern Sie eine vorhandene Installation vor dem Ersetzen und archivieren Sie Deinstallationsziele, anstatt eine rekursive Löschung durchzuführen.
13. Optionale Anbieter bleiben optional. Das kuratierte Standard-Shot-Pack ist nativ HyperFrames + GSAP. Klonen, installieren, aktualisieren oder verlangen Sie nie ShotCraft, Remotion oder einen anderen Anbieter ohne ausdrückliche Zustimmung des Benutzers. Native Rezepte müssen einen vollständigen Fallback darstellen.

Lesen Sie references/quality-gates.md vor der Vorschau- oder Exportarbeit.

Routentabelle

Benutzerabsicht oder -satz	Route	Typische Ausgabe
初始化视频项目, 第一次用, start a video project	references/workflows/init.md	Zustand, Bearbeitungsplan, Designprofil
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut	references/workflows/rough-cut.md	Genehmigter nicht-destruktiver Grobschnitt und Timing-Übergabe
抽字幕轴, 只做字幕, transcribe, 改字幕	references/workflows/captions.md	SRT, CSV, Transkript-JSON
帮我设计, 换颜色风格, 规划弹窗, design	references/workflows/design.md	DESIGN und vollständiger Bearbeitungsplan
参考这张截图设计, 按这张图的视觉语言, style reference	references/workflows/design.md Referenzzweig	Projektlokale STYLE_REFERENCE
按语义匹配动效, GSAP 动效丰富一点, semantic motion	references/workflows/design.md, dann Vorschau	Validierter MOTION_PLAN und Vorschau
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference	references/workflows/design.md ShotCraft-Zweig	Optionale zugeordnete Shot-Referenzen in MOTION_PLAN
做预览, 加动效, build preview	references/workflows/preview.md	Offizielle Vorschau-URL
出成片, 导出 4K, export final	references/workflows/export.md	Verifiziertes Endvideo
改这个, 恢复上一版, revise	references/workflows/revise.md	Eingeschränkte Überarbeitung und neue Vorschau/Finale
进度, 到哪了, status	references/workflows/status.md	Aktuelle Phase und nächste Aktion
体检, 为什么失败, doctor	references/workflows/doctor.md	Schreibgeschützte Diagnose
以后都这样, 记住这个风格, learn this	references/workflows/learn.md	Bestätigte projektlokale Lektionen
复盘成片, 下次怎么改进, retro	references/workflows/retro.md	Strukturierte Liefer-Retrospektive
升级状态, 迁移, migrate	references/workflows/migrate.md	Zustandsschema-Upgrade

Moduserkennung

Vor dem Routen:

1. Identifizieren Sie das Video-Projektverzeichnis des Benutzers, nicht dieses Skill-Repository.
2. Suchen Sie nach .naive-video-state.json.
3. Wenn nicht vorhanden und die Aufgabe mehr als eine einmalige Untertiteltextbearbeitung ist, laden Sie den Init-Workflow.
4. Wenn vorhanden, lesen Sie es plus EDIT_PLAN.md, DESIGN.md und VIDEO_LESSONS.md nur wenn relevant. Verwenden Sie working_video, wenn vorhanden; andernfalls main_video.
5. Führen Sie python3 tools/video_doctor.py --project <project_dir> aus, wenn Zustand und Dateien nicht übereinstimmen.

Verwenden Sie diese Phasen:

initialized -> captions_ready -> design_ready -> preview_ready
-> approved -> rendering -> final_ready

Markieren Sie eine spätere Phase erst, wenn ihr Qualitätsgate bestanden ist.

Standard-Pipeline

Wenn der Benutzer den gesamten Workflow anfordert:

1. Untersuchen Sie die Quellmedien mit ffprobe.
2. Initialisieren Sie den Projektzustand und sichere Ausgabeverzeichnisse.
3. Fragen Sie nur, ob das Material bereits grob geschnitten ist, wenn dieser Status unklar ist. Wenn es roh ist, laden Sie den optionalen Grobschnitt-Workflow und fordern Sie eine Strategiegenehmigung an.
4. Erstellen oder validieren Sie Untertiteldateien von working_video, falls vorhanden, ansonsten von main_video.
5. Fragen Sie, ob Screenshots, Aufnahmen, Produktbilder, Diagramme oder Demos erscheinen müssen. Lassen Sie den Benutzer zwischen semantischer Platzierung, genauen Sekunden/Gesprochener-Satz-Ankern oder einem Hybrid wählen; erklären Sie, dass genaue Anker präziser sind.
6. Normalisieren Sie Wort-für-Wort-Timing, wenn verfügbar, und teilen Sie die Sprache in betrachterorientierte Logikgruppen auf. Täuschen Sie keine Wortgenauigkeit aus ganzen Untertitelstarts vor.
7. Sammeln oder leiten Sie ein Stilprofil und sichere Zonen ab. Bieten Sie Anfängern optional einen Screenshot-Referenzabgleich an.
8. Schreiben Sie einen Bearbeitungsplan und einen semantischen Bewegungsplan mit jedem angeforderten Einschub, jeder Logikgruppenverknüpfung und jedem Zeitbereich.
9. Für neue Projekte ordnen Sie automatisch einige wenige sichere semantische Knoten dem kuratierten ShotCraft-inspirierten nativen Paket zu, es sei denn, der Benutzer wählt skip. Bewahren Sie bestehende genehmigte Projekte, das native Rezept und den Offline-Fallback auf.
10. Rendern Sie für die erste Nutzung, neue Stile oder reasoning-intensive Arbeiten repräsentative statische Keyframes und lösen Sie Kompositionsprobleme, bevor Sie eine vollständige dynamische Vorschau erstellen.
11. Erstellen Sie eine HyperFrames + GSAP-Vorschau, ggf. mit einem browserfreundlichen Proxy.
12. Führen Sie die Vorschau-Qualitätsgates durch und stellen Sie die offizielle Vorschau-URL bereit.
13. Warten Sie auf die Genehmigung, es sei denn, der Benutzer hat ausdrücklich das Überspringen angefordert.
14. Rendern Sie Overlays oder die finale Komposition mit dem genehmigten Arbeitsvideo und seiner Audio-Uhr.
15. Überprüfen Sie Dateiexistenz, Dauer, Auflösung, Bildrate und Audio.
16. Zeichnen Sie nur bestätigtes Feedback als projektlokale Lektionen auf.
17. Führen Sie nach der Auslieferung eine faktenbasierte Retrospektive durch und übernehmen Sie nur explizite, datenschutzsichere Regeln.

Projektdateien

Der Init-Workflow erstellt diesen minimalen Projektspeicher, ohne die Quellmedien zu berühren:

<project_dir>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json       # Betrachterorientierte Reasoning-Gruppen und getaktete Beats
├── STYLE_REFERENCE.md       # Nur erstellt, wenn ein Referenzbild verwendet wird
├── MOTION_PLAN.json         # Erstellt, wenn semantische Bewegungen geplant werden
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│   ├── rough-cut.mp4            # Optional; Originalmedien werden nie überschrieben
│   ├── rough-cut-edl.json       # Optionaler Entscheidungsdatensatz
│   ├── script-aligned.srt
│   ├── caption-table.csv
│   └── transcripts/
├── preview/
├── final/
└── qa/
    └── KEYFRAME_REVIEW.md   # Überprüfung der statischen Komposition vor der dynamischen Vorschau

Zustand ist operative Metadaten, keine Mediendatenbank. Halten Sie ihn klein und speichern Sie niemals Transkriptkörper, private Screenshots oder Geheimnisse darin. Siehe references/state-management.md.

Stil-Standardeinstellungen

Wenn der Benutzer Geschwindigkeit wünscht und keine Referenz angibt:

• Behalten Sie das Seitenverhältnis der Quelle bei.
• Verwenden Sie ein sauberes, lesbares Kartensystem mit einer konfigurierbaren Akzentfarbe.
• Verwenden Sie fette Untertitel mit zurückhaltender Keyword-Hervorhebung.
• Verwenden Sie GSAP-Transformationen und Deckkraft für Bewegungen.
• Platzieren Sie Karten in verifizierten leeren Bereichen.
• Reduzieren Sie die Bewegungsdichte, während Screenshots oder Demos sichtbar sind.
• Halten Sie die Textebene lesbar und grundlinienausgerichtet; animieren Sie das enthaltende Element, anstatt Labels zu verzerren.
• Wählen Sie eine explizite maximale Untertitelzeilenanzahl und eine Umbruchrichtlinie.

Fragen Sie nur nach einer Akzentfarbe, wenn Markenkonsistenz wichtig ist. Verwenden Sie ansonsten die neutrale Voreinstellung und machen Sie es einfach, sie später zu ändern. Anfänger können optional einen Screenshot bereitstellen und eine niedrige, mittlere oder hohe Referenzstärke wählen; erklären Sie, dass der Skill die visuelle Sprache kopiert, niemals die Marke oder den Inhalt der Quelle. Die Bewegungsdichte ist zurückhaltend, ausgewogen oder energiegeladen. Siehe references/style-onboarding.md.

Detaillierte GSAP-Rezepte und semantische Zuordnungen finden Sie in references/motion-recipes.md. Laufzeit- und Plugin-Auswahl finden Sie in references/gsap-runtime.md. Screenshot-Extraktion und Anti-Kopier-Regeln finden Sie in references/style-reference-workflow.md. Asset-Timing-Optionen finden Sie in references/asset-onboarding.md. Laden Sie diese nur für den passenden Design-Zweig.

ShotCraft-Erkennungs- und Anpassungsregeln finden Sie in references/shotcraft-integration.md; das native Anfängerpaket befindet sich in references/shotcraft-default-pack.md. Laden Sie diese für neue automatische Projekte, benannte Karten oder filmische Shot-Anfragen. Installieren Sie niemals einen Anbieter im Stillen.

Wortgenaues Timing, betrachterorientierte Logikgruppen und Akkumulations-/Exit-Verhalten finden Sie in references/content-logic-workflow.md. Laden Sie es nach den Untertiteln und vor dem semantischen Design.

Typografie, Komponentengeometrie, Glasbenachrichtigungen und suchsichere Fokus-/Typ-/Split-Anpassungen finden Sie in references/visual-quality-rules.md. Laden Sie es für jede Design- oder Vorschauaufgabe.

Selbstiterationsvertrag

Selbstiteration bedeutet, den aktuellen Workflow des Benutzers zu verbessern, ohne ihn in die öffentlichen Standardeinstellungen einfließen zu lassen.

Klassifizieren Sie Feedback in einen Umfang:

• project: gilt nur für dieses Video.
• profile: gilt für zukünftige Videos dieses Benutzers; schreiben Sie es nur nach expliziter Bestätigung.
• product: eine datenschutzsichere, allgemeine Zuverlässigkeitsverbesserung; schlagen Sie es separat dem Skill-Maintainer vor.

Zeichnen Sie Profil-Feedback in VIDEO_LESSONS.md mit den Worten des Benutzers, der bestätigten Regel und der betroffenen Umgebung auf.