Codot Runtime Anpassung
- Stitch MCP: Wird zentral über Codot Einstellungen → MCP bereitgestellt (suchen Sie nach Tools mit dem Präfix
stitch:odermcp__stitch__). Konfigurieren Sie MCP-Dateien nicht pro Agent neu.- Browser & Visuelle Überprüfung: Bevorzugen Sie Codots integrierte
browser_*-Tools (browser_navigate,browser_snapshot,browser_screenshot,browser_console) gegenüber externen Chrome DevTools MCP, wenn Sie lokale Entwicklungsserver oder gerenderte Seiten überprüfen.- Visuelle Bereitstellung:
show_previewist offline und hat keinen Netzwerkzugriff; exportiertes Stitch-HTML ist auf CDN-Tailwind/Schriftarten angewiesen und rendert leer, wenn es direkt übergeben wird. Verwenden Sie die Fähigkeitstitch-preview(lokaler statischer Server +browser_*für volle Wiedergabetreue/Interaktion, oderstitch-offline.mjs+show_previewfür In-Chat-HTML-Vorschau, odershow_previewdirekt auf.png-Screenshots).- Asset-Download: Verwenden Sie immer Stitch MCP
download_file(mithtmlCode.name/screenshot.name), niemalscurlgegendownloadUrl(das Anmeldeinformationen erfordert und einen JSON-Wrapper zurückgibt). Wenn diedownload_file-Ausgabe auf eine temporäre Datei gekürzt wird, decodieren Sie sie mitstitch-preview/scripts/save-stitch-file.mjs.- Objektparameter: Wenn ein MCP-Tool mit
expected object, got stringfehlschlägt (einige Agent-Laufzeiten serialisieren Objektargumente als Zeichenfolgen), wechseln Sie zum reinen Zeichenfolgen-Fallback-Workflow institch-manage-design-system, anstatt denselben fehlschlagenden Aufruf zu wiederholen.- Langlaufende Aufrufe: Wenn
generate_screen_from_textoderedit_screenseine Zeitüberschreitung verursacht, fragen Sielist_screensalle 60 Sekunden für bis zu ~5 Minuten ab (5 Abfragen); wenn kein neuer Bildschirm erscheint, wiederholen Sie den Aufruf einmal, anstatt unbegrenzt zu warten.- Tool-Zuordnung: Ordnen Sie generische Toolnamen (
Read,Write,Edit,Bash) den aktiven Codot-Harness-Tools (read,write,edit,bash) zu.
Stitch to Remotion Walkthrough-Videos
Sie sind ein Videoproduktionsspezialist, der ansprechende Walkthrough-Videos aus App-Designs erstellt. Sie kombinieren Stitchs Bildschirmerfassungsfähigkeiten mit Remotions programmatischer Videogenerierung, um flüssige, professionelle Präsentationen zu produzieren.
Übersicht
Diese Fähigkeit ermöglicht es Ihnen, Walkthrough-Videos zu erstellen, die App-Bildschirme mit professionellen Übergängen, Zoomeffekten und kontextuellen Texteinblendungen präsentieren. Der Arbeitsablauf ruft Bildschirme aus Stitch-Projekten ab und orchestriert sie zu einer Remotion-Videokomposition.
Voraussetzungen
Erforderlich:
- Zugriff auf den Stitch MCP Server
- Zugriff auf den Remotion MCP Server (oder die Remotion CLI)
- Node.js und npm installiert
- Ein Stitch-Projekt mit entworfenen Bildschirmen
Empfohlen:
- Vertrautheit mit Remotions Videofunktionen
- Verständnis von React-Komponenten (Remotion verwendet React)
Abruf und Vernetzung
Schritt 1: Verfügbare MCP-Server entdecken
Führen Sie list_tools aus, um verfügbare MCP-Server und deren Präfixe zu identifizieren:
- Stitch MCP: Suchen Sie nach
stitch:odermcp_stitch:Präfix - Remotion MCP: Suchen Sie nach
remotion:odermcp_remotion:Präfix
Schritt 2: Stitch-Projektinformationen abrufen
-
Projektsuche (falls keine Projekt-ID angegeben):
- Rufen Sie
[stitch_prefix]:list_projectsmitfilter: "view=owned"auf - Identifizieren Sie das Zielprojekt anhand des Titels (z.B. "Rechner-App")
- Extrahieren Sie die Projekt-ID aus dem Feld
name(z.B.projects/13534454087919359824)
- Rufen Sie
-
Bildschirmabruf:
- Rufen Sie
[stitch_prefix]:list_screensmit der Projekt-ID (nur numerisch) auf - Überprüfen Sie die Bildschirmtitel, um alle Bildschirme für das Walkthrough zu identifizieren
- Extrahieren Sie die Bildschirm-IDs aus dem Feld
namejedes Bildschirms
- Rufen Sie
-
Bildschirmmetadaten abrufen: Für jeden Bildschirm:
- Rufen Sie
[stitch_prefix]:get_screenmit dem Bildschirm-Ressourcen-name(projects/{project}/screens/{screen}) auf - Rufen Sie ab:
screenshot.name(projects/{project}/files/{file}) — Visuelles Asset für das VideohtmlCode.name(projects/{project}/files/{file}) — Optional: zum Extrahieren von Text/Inhaltenwidth,height— Bildschirmabmessungen für korrekte Skalierung- Bildschirmtitel und -beschreibung für Texteinblendungen
- Rufen Sie
-
Asset-Download:
- Rufen Sie Stitch MCP
[stitch_prefix]:download_filemitscreenshot.nameauf (verwenden Sie keincurloderweb_fetchfürdownloadUrl, das Anmeldeinformationen erfordert und einen JSON-Wrapper zurückgibt) - Wenn die
download_file-Ausgabe auf eine temporäre Datei gekürzt wird, decodieren Sie sie mit:node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png - Organisieren Sie die Assets in der Reihenfolge des vorgesehenen Walkthrough-Ablaufs
- Rufen Sie Stitch MCP
Schritt 3: Remotion-Projekt einrichten
-
Auf bestehendes Remotion-Projekt prüfen:
- Suchen Sie nach
remotion.config.tsoderpackage.jsonmit Remotion-Abhängigkeiten - Wenn vorhanden, verwenden Sie die bestehende Projektstruktur
- Suchen Sie nach
-
Neues Remotion-Projekt erstellen (falls erforderlich):
npm create video@latest -- --blank- Wählen Sie TypeScript-Vorlage
- Richten Sie es in einem dedizierten
video/-Verzeichnis ein
-
Abhängigkeiten installieren:
cd video npm install @remotion/transitions @remotion/animated-emoji
Videokompositionsstrategie
Architektur
Erstellen Sie eine modulare Remotion-Komposition mit diesen Komponenten:
-
ScreenSlide.tsx— Einzelne Bildschirmanzeigekomponente- Props:
imageSrc,title,description,width,height - Funktionen: Zoom-In-Animation, Fade-Übergänge
- Dauer: Konfigurierbar (Standard 3-5 Sekunden pro Bildschirm)
- Props:
-
WalkthroughComposition.tsx— Hauptvideokomposition- Sequenziert mehrere
ScreenSlide-Komponenten - Behandelt Übergänge zwischen Bildschirmen
- Fügt Texteinblendungen und Anmerkungen hinzu
- Sequenziert mehrere
-
config.ts— Videokonfiguration- Bildrate (Standard: 30 fps)
- Videoabmessungen (entsprechen Stitch-Bildschirmabmessungen oder angemessen skalieren)
- Gesamtdauerberechnung
Übergangseffekte
Verwenden Sie Remotions @remotion/transitions für professionelle Effekte:
-
Fade: Sanfter Überblendung zwischen Bildschirmen
import {fade} from '@remotion/transitions/fade'; -
Slide: Richtungsabhängige Folienübergänge
import {slide} from '@remotion/transitions/slide'; -
Zoom: Hinein-/Herauszoomen für Betonung
- Verwenden Sie die
spring()-Animation für sanftes Zoomen - Anwenden auf wichtige UI-Elemente
- Verwenden Sie die
Texteinblendungen
Fügen Sie kontextuelle Informationen mit Remotions Textdarstellung hinzu:
- Bildschirmtitel: Anzeige oben oder unten in jedem Frame
- Feature-Callouts: Heben Sie bestimmte UI-Elemente mit animierten Zeigern hervor
- Beschreibungen: Blendet beschreibenden Text für jeden Bildschirm ein
- Fortschrittsanzeige: Zeigt die aktuelle Bildschirmposition im Walkthrough an
Ausführungsschritte
Schritt 1: Bildschirm-Assets sammeln
- Ziel-Stitch-Projekt identifizieren
- Alle Bildschirme im Projekt auflisten
- Screenshots für jeden Bildschirm herunterladen
- In der Reihenfolge des Walkthrough-Ablaufs organisieren
- Eine Manifestdatei (
screens.json) erstellen:
{
"projectName": "Rechner-App",
"screens": [
{
"id": "1",
"title": "Startbildschirm",
"description": "Hauptrechnerschnittstelle mit Ziffernblock",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Verlaufsansicht",
"description": "Anzeige bisheriger Berechnungen",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Schritt 2: Remotion-Komponenten generieren
Erstellen Sie die Videokomponenten gemäß den Remotion-Best Practices:
-
Erstellen Sie
ScreenSlide.tsx:- Verwenden Sie
useCurrentFrame()undspring()für Animationen - Implementieren Sie Zoom- und Fade-Effekte
- Fügen Sie Texteinblendungen mit korrektem Timing hinzu
- Verwenden Sie
-
Erstellen Sie
WalkthroughComposition.tsx:- Importieren Sie das Bildschirmmanifest
- Sequenzieren Sie Bildschirme mit
<Sequence>-Komponenten - Wenden Sie Übergänge zwischen Bildschirmen an
- Berechnen Sie korrektes Timing und Offsets
-
Aktualisieren Sie
remotion.config.ts:- Setzen Sie die Kompositions-ID
- Konfigurieren Sie die Videoabmessungen
- Stellen Sie Bildrate und Dauer ein
Referenzressourcen:
- Verwenden Sie
resources/screen-slide-template.tsxals Ausgangspunkt - Folgen Sie
resources/composition-checklist.mdfür Vollständigkeit - Überprüfen Sie Beispiele im Verzeichnis
examples/
Schritt 3: Vorschau und Verfeinerung
-
Remotion Studio starten:
npm run dev- Öffnet eine browserbasierte Vorschau
- Ermöglicht Echtzeitbearbeitung und -verfeinerung
-
Timing anpassen:
- Stellen Sie sicher, dass jeder Bildschirm eine angemessene Anzeigedauer hat
- Überprüfen Sie, ob die Übergänge flüssig sind
- Überprüfen Sie das Timing der Texteinblendungen
-
Animationen verfeinern:
- Passen Sie die Federkonfigurationen für Zoomeffekte an
- Ändern Sie die Beschleunigungsfunktionen für Übergänge
- Stellen Sie sicher, dass Text jederzeit lesbar ist
Schritt 4: Video rendern
-
Mit Remotion CLI rendern:
npx remotion render WalkthroughComposition output.mp4 -
Alternative: Remotion MCP verwenden (falls verfügbar):
- Rufen Sie
[remotion_prefix]:rendermit Kompositionsdetails auf - Geben Sie das Ausgabeformat an (MP4, WebM usw.)
- Rufen Sie
-
Optimierungsoptionen:
- Qualitätsstufe einstellen (
--quality) - Codec konfigurieren (
--codec h264oderh265) - Paralleles Rendern aktivieren (
--concurrency)
- Qualitätsstufe einstellen (
Erweiterte Funktionen
Interaktive Hotspots
Heben Sie klickbare Elemente oder wichtige Funktionen hervor:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
Sprachintegration
Fügen Sie dem Walkthrough eine Erzählung hinzu:
- Generieren Sie ein Sprachskript aus Bildschirmbeschreibungen
- Verwenden Sie Text-to-Speech oder nehmen Sie Audio auf
- Importieren Sie Audio in Remotion mit der
<Audio>-Komponente - Synchronisieren Sie das Bildschirm-Timing mit dem Sprach-Pacing
Dynamische Textextraktion
Extrahieren Sie Text aus Stitch-HTML-Code für automatische Anmerkungen:
- Rufen Sie
[stitch_prefix]:download_filemithtmlCode.namefür jeden Bildschirm auf (decodieren Sie abgeschnittene Ausgabe mitsave-stitch-file.mjs) - Parsen Sie HTML, um wichtige Textelemente (Überschriften, Schaltflächen, Labels) zu extrahieren
- Generieren Sie automatische Callouts für wichtige UI-Elemente
- Fügen Sie der Komposition als zeitgesteuerte Texteinblendungen hinzu
Dateistruktur
project/
├── video/ # Remotion-Projektverzeichnis
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Heruntergeladene Stitch-Screenshots
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Bildschirmmanifest
└── output.mp4 # Gerendertes Video
Integration mit Remotion-Fähigkeiten
Remotion pflegt eigene Agent-Fähigkeiten, die Best Practices definieren. Überprüfen Sie diese für fortgeschrittene Techniken:
- Repository: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Installation:
npx skills add remotion-dev/skills
Wichtige Remotion-Fähigkeiten, die genutzt werden sollten:
- Animationstiming und Beschleunigung
- Kompositionsarchitekturmuster
- Leistungsoptimierung
- Audiosynchronisation
Allgemeine Muster
Muster 1: Einfache Diashow
Einfaches Walkthrough mit Fade-Übergängen:
- 3-5 Sekunden pro Bildschirm
- Überblendungsübergänge
- Untere Texteinblendung mit Bildschirmtitel
- Fortschrittsbalken oben
Muster 2: Feature-Hervorhebung
Fokus auf bestimmte UI-Elemente:
- In bestimmte Bereiche zoomen
- Animierte Kreise/Pfeile, die auf Funktionen zeigen
- Zeitlupenbetonung bei Schlüsselinteraktionen
- Vorher-Nachher-Vergleiche nebeneinander
Muster 3: Benutzerablauf
Schritt-für-Schritt-Benutzerreise zeigen:
- Sequenzieller Bildschirmablauf mit gerichteten Folien
- Nummerierte Schritt-Einblendungen
- Benutzeraktionen hervorheben (Klicks, Taps)
- Bildschirme mit animierten Pfaden verbinden
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Verschwommene Screenshots | Stellen Sie sicher, dass heruntergeladene Bilder in voller Auflösung über download_file (screenshot.name) anstatt als komprimierte Miniaturbilder vorliegen |
| Falsch ausgerichteter Text | Überprüfen Sie, ob die Bildschirmabmessungen mit der Kompositionsgröße übereinstimmen; passen Sie die Textpositionierung basierend auf der tatsächlichen Bildschirmgröße an |
| Ruckelige Animationen | Erhöhen Sie die Bildrate auf 60 fps; verwenden Sie korrekte Federkonfigurationen mit angemessener Dämpfung |
| Remotion-Build fehlschlag | Überprüfen Sie die Node-Versionskompatibilität; stellen Sie sicher, dass alle Abhängigkeiten installiert sind; überprüfen Sie die Remotion-Dokumentation |
| Timing wirkt falsch | Passen Sie die Dauer pro Bildschirm im Manifest an; Vorschau in Remotion Studio; testen Sie mit echten Benutzern |
Best Practices
- Seitenverhältnis beibehalten: Verwenden Sie die tatsächlichen Stitch-Bildschirmabmessungen oder skalieren Sie proportional
- Konsistentes Timing: Behalten Sie eine konsistente Bildschirmanzeigedauer bei, es sei denn, Sie heben bestimmte Bildschirme hervor
- Lesbarer Text: Sorgen Sie für ausreichenden Kontrast; verwenden Sie angemessene Schriftgrößen; vermeiden Sie überladene Einblendungen
- Sanfte Übergänge: Verwenden Sie Federanimationen für natürliche Bewegungen; vermeiden Sie ruckartige Schnitte
- Gründliche Vorschau: Zeigen Sie immer eine Vorschau in Remotion Studio vor dem endgültigen Rendern an
- Assets optimieren: Komprimieren Sie Bilder angemessen; verwenden Sie effiziente Formate (PNG für UI, JPG für Fotos)
Beispiele für die Verwendung
Benutzeranfrage:
Schlagen Sie die Bildschirme in meinem Stitch-Projekt "Rechner-App" nach und erstellen Sie ein Remotion-Video,
das ein Walkthrough der Bildschirme zeigt.
Agenten-Workflow:
- Stitch-Projekte auflisten → "Rechner-App" finden → Projekt-ID extrahieren
- Bildschirme im Projekt auflisten → Alle Bildschirme identifizieren (Start, Verlauf, Einstellungen)
- Screenshots für jeden Bildschirm herunterladen → In
assets/screens/speichern screens.json-Manifest mit Bildschirmmetadaten erstellen- Remotion-Komponenten generieren (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Vorschau in Remotion Studio → Timing und Übergänge verfeinern
- Finales Video rendern →
rechner-walkthrough.mp4 - Abschluss mit Videovorschau-Link melden
Tipps für den Erfolg
- Einfach anfangen: Beginnen Sie mit
…
[für die Übersetzung gekürzt]