CutCraft

Was macht CutCraft?

Rohmaterial und ein Gespräch in ein einziges, offensichtliches Endvideo verwandeln. Jedes Projekt in einem benannten CutCraft-Arbeitsbereich halten, visuelle Untertitel-Auswahlmöglichkeiten vor der Bearbeitung anzeigen, die kreativen Fragen einmal stellen und Transkriptkorrekturen sofort rückgängig machen.

Nicht verhandelbare Bedingungen

1. Zuerst das Readiness-Gate ausführen. Beim ersten Gebrauch und nach Umgebungsänderungen python3 helpers/check_environment.py ausführen. Wenn eine erforderliche oder angeforderte optionale Abhängigkeit fehlt, die Bearbeitung pausieren, dem Benutzer die offizielle URL des Skripts und die genauen Einrichtungsanweisungen zeigen und nur nach der fehlenden Genehmigung oder Anmeldeinformation fragen. references/onboarding.md für Schlüsselverwaltung und Plattformhinweise lesen.
2. Geheimnisse niemals in diesem Paket oder einem Projekt speichern. ElevenLabs-Schlüssel in ~/.config/cutcraft/.env mit Modus 600 speichern oder lokales Whisper verwenden, damit kein Schlüssel oder Transkript hochgeladen werden muss. Niemals einen Schlüssel in einem Befehlsargument, Protokoll, Transkript, Screenshot, Repository, Plugin-Cache oder Projektordner ablegen.
3. Den Arbeitsbereich erstellen, bevor etwas generiert wird. Aus der Beschreibung des Benutzers und dem inspizierten Filmmaterial einen kurzen Projektnamen ableiten. Nur bestätigen, wenn zwei wesentlich unterschiedliche Namen plausibel sind. helpers/project_workspace.py --name "<name>" ausführen und die zurückgegebenen Pfade verwenden.
4. Zuerst inspizieren, einmal fragen, nach Genehmigung bearbeiten. Quellen inventarisieren und transkribieren, repräsentative Bilder inspizieren, echte Untertitel-Vorschaubilder erstellen, dann alle verbleibenden kreativen Fragen in einem konsolidierten Checkpunkt stellen. Nicht mit dem Schneiden beginnen, bevor der Benutzer die empfohlenen Voreinstellungen ausgewählt oder akzeptiert hat.
5. Auswahlmöglichkeiten visuell zeigen. Drei materialbewusste Untertitel-Vorschaubilder generieren (empfohlen, sauber/erzählerisch und fett/sozial, es sei denn, das Filmmaterial erfordert andere Entscheidungen). Schriftart, Größe, Platzierung, Hintergrund, Sprache und Cue-Rhythmus unter jedem Bild angeben. Der Benutzer kann mit einer Optionsnummer antworten oder mit Anpassungen wie 往下 4% oder 字大 15%.
6. Das Finale offensichtlich halten. Nur Auslieferungsartefakte in 成品/ ablegen. Das primäre Video muss <project>_final.mp4 heißen. Vorschauen, Clips, Transkripte, EDLs, Downloads, generierte Assets und Berichte in 過程/ ablegen.
7. Bearbeitbaren Text mit jeder untertitelten Lieferung exportieren. <project>_逐字稿.md und <project>.srt neben dem endgültigen Video ablegen. Stabile Cue-IDs und Zeitstempel verwenden, damit der Benutzer z. B. 第 18 句改成…… sagen kann.
8. Transkriptkorrekturen sofort anwenden. Die angeforderten Cues auflösen, helpers/apply_transcript_corrections.py gegen 過程/master.srt ausführen, die Validierung erneut ausführen, das endgültige Video mit der korrigierten SRT neu rendern, das Transkript neu generieren und die Lieferartefakte ersetzen. Zeitvorgaben beibehalten, es sei denn, der Benutzer meldet ein Synchronisationsproblem. Unverändertes Quellmaterial nicht erneut transkribieren.
9. Kein Review-Frontend. Keinen Server starten oder Browser-UI-Dateien erstellen. Die gesamte Überprüfung findet über gelieferte Video-/Bilddateien und konversationelle Korrekturen statt.
10. Arbeit fortsetzbar machen. cutcraft.project.json an jedem Checkpunkt aktualisieren. Quellsignaturen, Genehmigungsstatus, Überarbeitungen, Endpfade und Asset-Herkunft beibehalten. Proxys nur zur Inspektion verwenden; immer von den Originalen rendern.
11. Vor der Lieferung verifizieren. Deterministischen Preflight und quality_report.py ausführen, das gerenderte Ergebnis an Schnittgrenzen und repräsentativen Untertitel-Momenten inspizieren, den endgültigen Mix anhören und die Ausgabedauer/-ströme überprüfen. Wenn ein Schnitt ein Stottern oder einen Fehlstart entfernt hat, den gerenderten Abschnitt neu transkribieren, um zu beweisen, dass er weg ist.

Projektlayout

Standard-Root: ~/Documents/Codex/CutCraft/ (im Finder sichtbar; den installierbaren Skill selbst unter ~/.codex behalten).

CutCraft/
└── <project>/
    ├── cutcraft.project.json
    ├── 成品/
    │   ├── <project>_final.mp4
    │   ├── <project>_逐字稿.md
    │   └── <project>.srt
    └── 過程/
        ├── project.md
        ├── creative_brief.json
        ├── inventory.json
        ├── takes_packed.md
        ├── edl.json
        ├── master.srt
        ├── transcript_corrections.json
        ├── asset_registry.json
        ├── transcripts/
        ├── clips/ und clips_*/
        ├── assets/
        ├── animations/
        ├── proxies/
        ├── downloads/
        └── verify/

Benutzer-Quellmaterial niemals in das Projekt duplizieren, es sei denn, der Benutzer bittet darum. Absolute Quellpfade in edl.json aufzeichnen und Originale unberührt lassen.

Ein konsolidierter Checkpoint

Genügend Material inspizieren, um Empfehlungen zu geben, die Untertitel-Vergleichsbilder rendern, dann alle zutreffenden Punkte gemeinsam abfragen:

• Ziel, Zielgruppe, Plattform, Seitenverhältnis, Auflösung, Ziellänge, deadlinesensitives Format.
• Geschichte/Reihenfolge, unverzichtbare Zeilen, unbedingt zu schneidendes Material, Namen/Begriffe, die ASR exakt buchstabieren muss.
• Tempo, Zuschnitt/Reframing, Farbstimmung, Überblendungen, Effekte, Overlays, B-Roll, Zensur/Datenschutzbedürfnisse.
• Untertitel: eingebrannt/Sidecar/beides, Sprache oder zweisprachiger Modus, wörtlich/bereinigt, Schriftart, Größe, Position, Hintergrund, Cue-Rhythmus, Bildschirm-UI-Sicherheitszonen.
• Audio: Bereinigung, Lautstärke, bereitgestellte Musik/SFX/Sprachaufnahme oder gewünschte Stimmung und Intensität.
• Asset-Quelle: benutzerbereitgestellte Dateien, generierte Assets oder bestimmte freie Bibliotheken. Wenn freies Material angefordert wird, die passenden Optionen in references/free-assets.md anbieten, den Benutzer bitten zu wählen, und das Element, den Ersteller, die URL, die Lizenz, die Namensnennung und die Prüfsumme mit asset_registry.py registrieren.
• Transkriptionsprivatsphäre: lokales Whisper empfehlen, wenn Datenschutz wichtig ist; andernfalls ElevenLabs für verwaltete Diarisierung anbieten. Das Uploadverhalten erklären, bevor Medien an einen Cloud-Anbieter gesendet werden.
• Redaktionelle Autonomie und alles, was ausdrücklich verboten ist.

Die Vorschaubilder in diesem Checkpoint anhängen. Für jede Wahl eine empfohlene Standardeinstellung angeben und 全部用建議值 als gültige Antwort einschließen. Die Antwort in 過程/creative_brief.json speichern; einmal geklärte Fragen während des Schnitts nicht wieder aufgreifen.

Arbeitsablauf

1. Readiness-Prüfungen ausführen und nur fehlende Anforderungen lösen.
2. Dateinamen und die Beschreibung des Benutzers inspizieren; einen Projektnamen ableiten und den Arbeitsbereich erstellen.
3. inventory.py --work-dir <過程> <sources_dir> ausführen. Bei langen oder 4K-Quellen zwischengespeicherte Proxys zur Inspektion erstellen. analyze_media.py ausführen, um Szenenwechsel, Stille, Schwarz- und eingefrorene Intervalle zu lokalisieren.
4. Mit dem genehmigten Cloud-/lokalen Anbieter in <過程>/transcripts/ transkribieren, dann die Transkripte packen. Das gepackte Transkript lesen, frühe/mittlere/späte Bilder und mehrdeutige Editierpunkte abtasten und ASR-Rechtschreibrisiken notieren.
5. Drei Untertitel-Stil-Vorschauen aus repräsentativen Bildern generieren. Den konsolidierten Checkpunkt abfragen und das genehmigte Briefing speichern.
6. edl.json bauen, genehmigte Assets beschaffen oder generieren und ohne ständige Nachfragen zu gewöhnlichen Geschmacksfragen editieren.
7. Untertitel erstellen. Für Chinesisch build_cn_subtitles.py verwenden; für andere Sprachen render.py --build-subtitles verwenden. references/subtitles.md befolgen.
8. validate_project.py ausführen, eine bewertbare Vorschau in 過程/verify/ rendern und selbst überprüfen. Korrektur-/Neurender-Durchläufe auf drei begrenzen, bevor ein hartnäckiges Problem gemeldet wird.
9. <成品>/<project>_final.mp4 aus den Originalquellen rendern, die endgültige SRT nach <成品>/<project>.srt kopieren und <成品>/<project>_逐字稿.md mit export_transcript.py generieren.
10. quality_report.py ausführen, jeden Fehler beheben, Warnungen visuell und auditiv überprüfen, dann das Manifest mit project_state.py als geliefert markieren.
11. Die drei expliziten Pfade, den QC-Bericht, eine prägnante Schnittzusammenfassung und die Asset-Herkunft bereitstellen. Den Benutzer niemals zwischen Zwischendateien nach final suchen lassen.

Produktionskorrektheit

• Untertitel zuletzt anwenden, nach jedem Overlay und Zuschnitt.
• Schnittkandidaten aus Wortgrenzen und Stille ableiten; niemals innerhalb eines Wortes schneiden. 30–200 ms Polsterung passend zum Tempo verwenden.
• Kurze Audioüberblendungen an Segmentgrenzen anwenden, um Klickgeräusche zu vermeiden.
• Leinwand, Bildrate, Pixelformat, Farbraum, Abtastrate und Kanallayout vor dem Zusammenfügen von Clips normalisieren.
• Transkripte und Proxys nach Quellpfad, -größe und -änderungszeit zwischenspeichern; nur dann erneut ausführen, wenn sich diese Signatur ändert.
• Untertitel-Zeitstempel auf der Ausgabe-Zeitleiste berechnen, nicht auf der Quell-Zeitleiste.
• Pixelgenaue einzeilige Cues garantieren, wenn einzeilig genehmigt ist; gegen die tatsächliche Schriftart und Leinwand validieren.
• Nur benutzerbereitgestellte, generierte, gemeinfreie oder lizenzkompatible Assets verwenden. Titel, Ersteller, Quell-URL, Lizenz, Download-Datum und erforderliche Namensnennung aufzeichnen.
• Zuerst den Dialog mischen. Musik unter Sprache absenken und zuhören; Lautheitsnormalisierung kann einen schlechten Mix nicht retten.
• Den Hauptagenten als Eigentümer des kreativen Briefings, der EDL, des Untertitel-Timings, der endgültigen Zeitleiste, des Mixes und der Qualitätskontrolle behalten. Nur unveränderliche Arbeiten parallelisieren, die eindeutige Pfade schreiben.

references/editorial-craft.md lesen, wenn das Projekt Mehrtake-Auswahl, Überblendungen, Grading, Animation, Geschwindigkeitsrampen oder musikgeführtes Editieren benötigt. references/edl.md lesen, bevor die EDL erstellt oder erweitert wird.

Helfer

• check_environment.py – erforderliche/optionale Abhängigkeits- und Anmeldeinformations-Bereitschaft mit offiziellen Einrichtungs-URLs.
• project_workspace.py – ein benanntes 成品/ + 過程/ Projekt erstellen oder wiederverwenden.
• project_state.py – fortsetzbare Checkpoints, Genehmigungen, Überarbeitungen und Ausgabepfade atomar aufzeichnen.
• inventory.py – Quellformate und Normalisierungsrisiken untersuchen.
• analyze_media.py – Szenenwechsel, Stille, Schwarz- und eingefrorene Bilder erkennen.
• create_proxy.py – zwischengespeicherte, leichte Inspektionsproxys, die unveränderlichen Originalen zugeordnet sind.
• transcribe.py, transcribe_batch.py – zwischengespeicherte, wortgenaue ElevenLabs- oder lokale Whisper-Transkription.
• pack_transcripts.py – kompakte, phrasenbasierte Bearbeitungsansicht.
• timeline_view.py – Filmstreifen, Wellenform, Wörter und Schnittpunkt-Inspektion.
• subtitle_style_preview.py – exakte libass-Stil-/Platzierungsvorschau auf echten Bildern.
• build_cn_subtitles.py – chinesisch-bewusste Pixelbreiten-Cue-Erstellung.
• render.py – normalisieren, schneiden, zusammenfügen, überlagern, mischen, dann zum Schluss untertiteln.
• validate_project.py – schnell scheiternde EDL-, Asset-, Zeit- und Untertitelprüfungen.
• asset_registry.py – bei Fehler schließendes Asset-Lizenz-, Attributions- und Prüfsummen-Register.
• quality_report.py – abschließender Stream-, Dauer-, Schwarz-/Einfrier-/Stille- und QS-Nachweisbericht.
• build_cut_report.py – kategorisierte Schnittzusammenfassung.
• apply_transcript_corrections.py – bei Fehler schließende Cue-/Textkorrekturen mit Prüfprotokoll und Sicherung.
• export_transcript.py – lesbares, Cue-adressierbares Transkript für die Lieferung.
• cleanup_session.py – optionale Bereinigung nur, nachdem der Benutzer ausdrücklich um das Löschen von Prozessdateien bittet; 完成 niemals als Löschbefehl interpretieren.

Jeden Helfer und jede Referenz relativ zum Verzeichnis auflösen, das dieses SKILL.md enthält.

Überarbeitungsverhalten

Das gelieferte Transkript des Benutzers nach dessen Korrektur als das maßgebliche Wortlautdokument behandeln. Bei reinen Wortlautkorrekturen Cue-Zeitvorgaben und Schnittentscheidungen beibehalten, die SRT patchen, validieren und neu rendern. Bei Synchronisationsmeldungen das betroffene gerenderte Fenster inspizieren und nur diese Cue-Grenzen anpassen. Bei redaktionellen Änderungen die EDL und den Schnittbericht aktualisieren, dann den gesamten betroffenen Render-/QS-Pfad ausführen.

Jede Sitzung an 過程/project.md anhängen, mit Strategie, genehmigten Entscheidungen, Asset-Herkunft, Überarbeitungen, QS-Nachweisen und offenen Punkten. 過程/ standardmäßig erhalten, damit zukünftige Überarbeitungen günstig und nachvollziehbar bleiben.