Communitygithub.com

ChatCut-Inc/agent-plugin

Verwenden Sie diesen Skill, wenn Codex das ChatCut-Plugin (ChatCut MCP-Server) nutzt, um Motion-Graphic-JSX-Assets hinzuzufügen, zu erstellen, manuell zu schreiben, zu patchen oder zu platzieren. Er umfasst Referenzdurchsicht, direkte Inline-JSX-Erstellung, bearbeitbare Eigenschaften, Asset-Bindung, Timeline-Platzierung und zusammengesetzte Verifikation.

Was ist agent-plugin?

Dieser Skill befähigt KI-Agenten wie Codex, Motion Graphics direkt als Inline-JSX-Code über das ChatCut-Plugin zu erstellen und zu bearbeiten. Er ist für die Nutzung mit dem Web-Editor (einschließlich lokaler Entwicklungsumgebungen) konzipiert und sollte nicht für die ChatCut-Desktop-Anwendung verwendet werden. Der Skill führt den Agenten durch einen strukturierten Workflow: Zunächst werden visuelle Referenzen durchsucht und eine Designrichtung festgelegt, wobei eine visuelle Bibliothek für die Auswahl und vorhandene Design-Stile oder benutzerdefinierte Vorgaben für die Anwendung genutzt werden. Anschließend werden passende Instanzen für die benötigten MG-Formen ausgewählt, basierend auf dem gesprochenen Inhalt und den Zielframes des Videos. Der Agent erstellt oder bearbeitet dann das JSX direkt über die MCP-Tools von ChatCut, wobei er die bestätigte Designsprache (Farben, Schriften) und die Referenzstrukturen beibehält. Der Skill legt großen Wert auf die Inspektion des aktuellen Projektzustands (Auflösung, FPS, vorhandene Assets), die Angabe von bearbeitbaren Eigenschaften und die Verifikation des Endergebnisses durch eine erneute Überprüfung der sichtbaren Frames. Er setzt strikt auf die direkte Autoren-API von ChatCut und verbietet ausdrücklich den Umweg über andere Workflows wie den nativen ChatCut-Agenten oder die Erstellung von Gemini-Prompts.

Funktioniert mit~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ChatCut-Inc/agent-plugin/tree/HEAD/claude/skills/create-motion-graphics

In Ihrer bevorzugten KI fragen

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

Dokumentation

Motion Graphics erstellen

Plugin-Host und Projekt

Verwenden Sie den chatcut MCP-Server und die Projekt-ID aus der Editor-URL des Benutzers oder dem Projektergebnis des Plugins. Dieses Plugin funktioniert mit dem Web-Editor, einschließlich lokaler Entwicklungs-URLs. Öffnen Sie nicht ChatCut Desktop oder verwenden Sie chatcut_desktop für ein Web-Projekt. Wenn chatcut-Tools nicht verfügbar sind, melden Sie den Verbindungsfehler; reichen Sie die Aufgabe nicht beim nativen Agenten des Editors als Ersatz ein.

MG-Referenzen vor dem Design finden

Eine visuelle Richtung durchsuchen und bestätigen

Für die Produktion verwenden Sie einen akzeptierten Projektstil oder eine vom Benutzer bereitgestellte Marke/Referenz wieder. Verwenden Sie manage_design_style get, wenn die vollständige Spezifikation noch nicht bekannt ist. Routinemäßige Text-/Platzierungsänderungen benötigen keine neue Stilauswahl oder erneutes Scannen des Katalogs.

Wenn eine neue Richtung benötigt wird oder der Benutzer nach Alternativen fragt, beginnen Sie mit browse_library references: {view: "style-overview"}. Lesen Sie ALLE nummerierten Kontaktbögen, folgen Sie nextOffset bis complete. Sie enthalten veröffentlichte, agentenfähige Stilrepräsentanten, einschließlich verknüpfter bestehender Design-Stile. list_presets ist nur das Legacy-Katalog-Subset; es kann diese visuelle Übersicht nicht ersetzen. Wiederholen Sie eine fehlgeschlagene Seite; melden Sie eine unvollständige Übersicht, anstatt sie stillschweigend zu überspringen.

Für sprachgeführte Videos verstehen Sie den gesprochenen Inhalt und inspizieren Sie repräsentative Videoframes, bevor Sie Stile in die engere Wahl nehmen. Verwenden Sie Transkript- und Framebeweise, die bereits im Kontext vorhanden sind, wieder. Berücksichtigen Sie das Thema, den Vortragston, die Bildschirmsprache sowie die Farbe, den Betreffrahmen und den Hintergrund des Filmmaterials zusammen mit den Stilvorschauen.

Wenn die visuelle Richtung noch nicht festgelegt ist, wählen Sie bis zu 6 passende Optionen für den aktuellen Inhalt und das Filmmaterial aus und lesen Sie deren hero-Teile. Laden Sie den widget-forms-Skill des Hosts und zeigen Sie tatsächliche heroPreview.url-Bilder mit kurzen Namen an. Von Tools zurückgegebene Bilder sind Beweise für den Agenten, keine benutzergerichtete Auswahl; rein textuelle Auswahlmöglichkeiten zeigen die visuellen Unterschiede nicht. Halten Sie jede Auswahl auf ihre Referenz-ID abgebildet; nutzen Sie den Sonstiges-Zweig des Formulars für Präferenzen oder eine weitere Charge, ohne Auswahlmöglichkeiten zu wiederholen oder eine separate Option "Mehr anzeigen" hinzuzufügen. Warten Sie auf die Auswahl, bevor Sie einen neuen Stil anwenden und das MG erstellen, es sei denn, der Benutzer hat bereits eine Richtung gewählt oder die Stilwahl explizit delegiert. Eine Sonstiges-Antwort ist keine Annahme.

Den ausgewählten Stil anwenden

Lesen Sie die summary, den hero und die members des ausgewählten Repräsentanten. Folgen Sie dessen designStyleAction mit manage_design_style:

  • apply_preset: Verwenden Sie die zurückgegebene presetId direkt; klonen oder aktualisieren Sie das Preset nicht nur, um Referenzmetadaten zu speichern.
  • apply: Verwenden Sie die zurückgegebene designStyleId für einen vorhandenen, gespeicherten Benutzerstil wieder.
  • create: Nur eine unabhängige Referenz benötigt einen neuen, benutzereigenen Stil. Definieren und speichern Sie dessen Palette, Schriftarten und wiederverwendbare visuelle Regeln aus der ausgewählten Referenz. Verwenden Sie die dokumentierte Palette der Referenz wieder; falls nicht vorhanden, leiten Sie eine kohärente Palette aus ihrem repräsentativen Bild ab. Speichern Sie designSpec.referenceSources: [{id: "<Referenz-ID>"}] und die individuelle heroPreview.url sowohl in thumbnailUrl als auch in designSpec.images: [{role: "style reference", url: "<heroPreview.url>"}]. Verwenden Sie applyToProject: true; bewahren Sie vorhandene Bilder, wenn Sie ein Array patchen.

Nach dem Anwenden rufen Sie get für die aktuelle vollständige Spezifikation und Quell-IDs auf; übernehmen Sie nicht die zwischengespeicherten Regeln des vorherigen Stils. Überprüfen Sie bei einem neuen Stil, ob dessen Palette, Schriftarten, Quelle, Cover und Referenzbild gespeichert wurden. Eine Quell-ID allein speichert kein Bild. Referenzbilder sind visuelle Beweise, keine Filmbilder/Hintergründe zum Einbetten oder Beispielkopien zum Reproduzieren.

Verwenden Sie fontRecommendations["zh-Hans"] / .en gemäß dem tatsächlichen Bildschirmtext, einschließlich zweisprachigem Text und lateinischen Ziffern. Verwenden Sie einen akzeptierten Schriftplan wieder; eine leere Sprachgruppe ist ungelöst. Passen Sie den typografischen Charakter und die Überschrift-/Körperhierarchie der Referenz an und überprüfen Sie die Glyphenabdeckung und Laufzeitverfügbarkeit. Speichern Sie ausgewählte Familien/Rollen in designSpec.fonts und Sprache, Gewicht, Kursiv und erforderliche Achsen im styleGuide. Ein sprachübergreifendes Formularbeispiel kann diesen Plan nicht ersetzen. Nur wenn Sie fehlende Schriftarten kuratieren oder die Typografie explizit anpassen, lesen Sie Schriftabgleich; der chinesische Abgleich beginnt mit einem generierten chinesischen Effektbild, nicht mit englischen Buchstabenformen.

Instanzen den benötigten MG-Formen zuordnen

Verwenden Sie den gesprochenen Inhalt und die Zielframes, um zu entscheiden, welche MG-Formen nützlich sind; lassen Sie die Referenzvorschauen diese Entscheidungen verfeinern. Bewahren Sie die bestätigte visuelle Sprache über das gesamte Video hinweg und finden Sie geeignete Instanzen für jede benötigte Form. Wählen Sie Instanzen selbst aus, es sei denn, der Benutzer bittet um einen Vergleich. Verschiedene Formen können unterschiedliche Instanzen verwenden; wiederkehrende Komponenten können eine bereits untersuchte wiederverwenden. Folgen Sie nextReferenceSearch, wenn zurückgegeben:

  • Mit verwandten Mitgliedern durchsuchen Sie kind: "instance", styleId: "<Repräsentanten-UUID>" oder lesen Sie relevante Mitglieds-IDs.
  • Wenn eine benötigte Form kein passendes Mitglied hat, durchsuchen Sie die GESAMTE Instanzenbibliothek nach Inhalt/Form query oder facets.form, wobei Sie styleId, facets.style und stilnamenbezogene Begriffe weglassen, auch wenn andere Formen bereits Übereinstimmungen desselben Stils haben.
  • Vergleichen Sie die Cover-Collage, lesen Sie dann ausgewählte IDs mit parts: ["summary", "hero"]. Fügen Sie motion für Animation und code für die Implementierung hinzu. Wenn eine codegestützte Referenz templateInspection zurückgibt, verwenden Sie deren schreibgeschützten Aufruf für gespeicherte Eigenschaftsschemata/Standards; JSX kann Props lesen, ohne deren Werte zu deklarieren. legacyTemplateRefs sind Vorlagen-IDs: manage_template get liest Metadaten und list_assets liest MG-Eigenschaften. Weder wendet noch kopiert manage_template eine Vorlage. inspect_asset ist für aktuelle Projektmedien/MGs, nicht für Katalogquell-IDs.

Passen Sie die Komposition, Hierarchie, Abstände und Aufbaustruktur der Instanz an die festgelegten Projektfonts, die Palette, die Materialien und die tatsächliche Aufnahme an. Wenn die breitere Formsuchen ebenfalls keine passende findet, erweitern Sie das Stilboard und geben Sie diese Einschränkung an. Fassen Sie relevante Detailablesungen zusammen; das Finden einer Instanz deckt nicht verwandte Formen nicht ab. Folgen Sie pendingIds für geteilte Antworten; known kann nur zurückgegebene Versionen und Teile enthalten, die noch im Kontext sind. Jedes Bewegungsblatt ist EIN Design zu realen Zeitstempeln; eine Montage ist kein Layout, und ein statisches Bild begründet keine Animation.

Für ein neues / wesentlich neu gestaltetes Overlay mit sprechender Person lesen Sie Overlay-Komposition. Importieren Sie nur Produktionsdateien aus materials, die im Ergebnis erscheinen werden; verwenden Sie deren Projekt-Asset-IDs. Überprüfen Sie das MG, komponiert mit dem Zielmaterial.

Die Referenzen beim Authoring verwenden

Lesen Sie den code der ausgewählten Instanz, wenn Sie deren Implementierung übernehmen möchten, oder lesen Sie verknüpfte Vorlageneigenschaften mit manage_template list_assets. Verwenden Sie sie als Referenz im folgenden Code-Workflow, während Sie den Projektstil beibehalten.

Inspizieren Sie auch ausgewählte Bilder: Eine URL, ID oder ein Suchergebnis allein ist keine betrachtete Referenz. Bewahren Sie STIL-Beweise für das Aussehen und formübergreifende FORM-Beweise für die Struktur. Wenn eine ausgewählte Referenz fehlschlägt, wiederholen Sie den Vorgang oder melden Sie die fehlenden Beweise, anstatt zu behaupten, sie sei inspiziert worden.

Verwenden Sie diesen Skill, wenn eine ChatCut-Plugin-Aufgabe ein Motion-Graphic-Asset erfordert, das als Inline-JSX erstellt oder gepatcht wird. Der integrierte ChatCut-Agent hat seinen eigenen motion-graphic-gen-Workflow; wechseln Sie nicht von dieser Plugin-Aufgabe dorthin.

Codex-Plugin-Motion-Graphics werden direkt erstellt. Verwenden Sie create_motion_graphic_from_code für neue JSX-Assets und edit_asset für bestehende MG-JSX. Diese Oberfläche bietet kein submit_motion_graphic; übersetzen Sie die Anfrage nicht in einen Gemini-Prompt oder eine Generierungsanweisung. Wenn die direkten Authoring-Tools fehlen, stoppen Sie und melden Sie die nicht verfügbaren ChatCut-Plugin-Tools.

Übergeben Sie Motion-Graphic-Quellcode inline über die chatcut-MCP-Tools. Stufen Sie Code nicht im ChatCut-Repository, in ai-working/, in /tmp, auf einem lokalen HTTP-Server, als generierte Codedateien oder in vermuteten Anwendungspfaden zwischen, wenn das Tool Inline-JSX direkt akzeptiert.

Kernprinzipien

  • Inspizieren Sie den Projektstatus, wenn Leinwandgröße, fps, vorhandene visuelle Sprache, Platzierung oder Timeline-Konflikte noch nicht bekannt sind.
  • Identifizieren Sie die erforderlichen Eingaben in Bevor Sie codieren, bevor Sie JSX schreiben.
  • Erstellen oder aktualisieren Sie Motion-Graphic-Assets über den verfügbaren Inline-Code-Asset-Workflow; verwenden Sie aktuelle Tool-Schemas für exakte Payload-Formen.
  • Platzieren oder verschieben Sie Assets über den Timeline-Bearbeitungs-Workflow, wenn die Bearbeitung eine Timeline-Platzierung erfordert.
  • Lesen Sie den Projektstatus erneut und überprüfen Sie den sichtbaren Frame nach strukturellen oder visuellen Änderungen.

Bevor Sie codieren

Bevor Sie JSX schreiben, identifizieren Sie nur die Informationen, die für diese Bearbeitung benötigt werden:

  • Platzierung: Startzeit, Dauer, Ziellayer, falls bekannt, und der Zielframe, mit dem sich das Graphic zusammensetzen muss.
  • Rolle in der Bearbeitung: Welche Aufgabe dieses Motion Graphic im Video übernimmt.
  • Inhalt: Genauer Text, Zahlen, Medien oder visuelle Fakten, die erscheinen müssen.
  • Timing: Ob interne Bewegung mit Sprache, Musik oder einem visuellen Ereignis synchronisiert werden soll.
  • Visuelle Quelle: Vom Benutzer bereitgestellter Stil, Projekt-Design-Stil, Markenfarben/Schriftarten oder ein akzeptiertes bestehendes Motion Graphic.
  • Editierbare Felder: Welche Text-, Farb-, Zahlen-, Booleschen-, Bild- oder Videowerte zu Eigenschaften werden sollen.

Fragen Sie nur nach fehlenden, wirkungsvollen Eingaben, die das Ergebnis wesentlich verändern würden.

Visuelles System und Platzierung

Verwenden Sie den bestätigten vollständigen Design-Stil und die inspizierten Referenzen von oben. Stellen Sie für eine neue, individuelle Richtung ein komponiertes Ergebnis her, bevor Sie bündeln; akzeptierte Richtungen und Routinekorrekturen benötigen keine erneute Stilbestätigung.

Wählen Sie jede Komposition, Position, Größe und Lesezeit basierend auf der tatsächlichen Aufnahme und dem Sprachabschnitt. Bewahren Sie gemeinsame Typografie, Palette, Materialien und Bewegung, während Sie die Form der Referenz an den Inhalt anpassen. Ein fester linker/rechter Anker oder Kartencontainer ist nur angemessen, wenn die Komposition ihn erfordert.

Verwenden Sie ein Asset mit pro-Element-Eigenschaften für eine absichtlich wiederkehrende Komponente mit derselben Informationsstruktur erneut. Neue Strukturen benötigen ihre eigene Instanzreferenz und Komposition. Overlay-Grenzen sollten das Graphic eng umschließen; verwenden Sie Timeline-Maße nur für ein Design, das sichtbar den Frame überspannt.

Passen Sie die Asset-Dauer und interne Beats an die platzierte Timeline-Spanne an. Wenn sich das Timing wesentlich ändert, aktualisieren Sie das MG, anstatt unvollendete Animationen abzuschneiden. Überprüfen Sie komponierte, beruhigte Frames Seite an Seite für eine Charge und korrigieren Sie Kollisionen, Lesbarkeit und unbeabsichtigte Wiederholungen, bevor Sie die Fertigstellung melden.

Editierbare Eigenschaften

Machen Sie benutzersichtbare und wahrscheinlich ändernde Werte als editierbare Eigenschaften zugänglich.

  • Sichtbarer Text, Primärfarben, Akzentfarben und wichtige numerische Werte sollten Eigenschaften sein.
  • Schriftartauswahlen sollten font-Eigenschaften sein, wenn Benutzer sie vernünftigerweise ändern möchten könnten.
  • Bild- und Videoquellen müssen image / video-Eigenschaften sein.
  • Codeschlüssel müssen exakt mit den Eigenschaftsschemaschlüsseln übereinstimmen.
  • Lesen Sie Werte aus item.props; hardcoden Sie keinen sichtbaren Inhalt, den der Benutzer später vernünftigerweise ändern möchte könnte.
  • Verwenden Sie Item-Ebene-Eigenschaftsüberschreibungen nur für absichtlich wiederkehrende Komponenten mit derselben Betrachteraufgabe, Informationsstruktur und visuellen Form. Wenn sich eine davon unterscheidet, erstellen Sie ein weiteres MG-Asset und teilen Sie stattdessen Palette, Typ und Bewegungslogik.

Eigenschaftseinträge sollten einen stabilen Schlüssel, benutzersichtbares Label, Typ und Standardwert deklarieren. Unterstützte Eigenschaftstypen umfassen text, number, color, boolean, select, font, image und video.

Schriftarten

Motion Graphics müssen Schriftarten verwenden, die für den Renderer von ChatCut verfügbar sind, damit Vorschau und lokaler Export konsistent bleiben. Verlassen Sie sich nicht auf maschinenspezifische Systemschriftarten wie STKaiti, PingFang SC, Microsoft YaHei, Arial, Helvetica, Comic Sans MS, system-ui, -apple-system oder generische CSS-Familien als primäre gerenderte Schriftart; die Verfügbarkeit unterscheidet sich zwischen Maschinen und kann zu Fallbacks führen.

Wenn Sie eine Schriftart auswählen oder ersetzen, rufen Sie search_fonts auf und verwenden Sie den zurückgegebenen kanonischen Familiennamen wörtlich als fontFamily-Wert und passenden font-Eigenschafts-defaultValue. Verwenden Sie Google Fonts oder benutzerdefinierte Projekt-Schriftarten, die vom Katalog zurückgegeben werden. Wenn eine angeforderte maschinenspezifische Schriftart nicht im Katalog ist, erklären Sie, dass ein konsistentes lokales Rendern nicht garantiert werden kann, suchen Sie nach einer unterstützten Alternative mit einem ähnlichen Gefühl und verwenden Sie diese, es sei denn, der Benutzer akzeptiert explizit einen Schrift-Fallback.

Assets und Komposition

Eine Referenzinstanz kann eine vollständige Komposition beschreiben, die aus mehreren Timeline-Items besteht. Sie impliziert kein eigenständiges MG-Asset. Halten Sie Referenzscreenshots, Produktionsmaterialien und aktuelle Projektaufnahmen getrennt.

Standardmäßig separate Items, wenn das Design gewöhnliche Medien mit Grafiken kombiniert:

  • Wiederverwendbares Papier/Textur/Hintergrund: ein Bild- oder Video-Item hinter der Komposition.
  • Aktuelles Projektfoto, Produktbild oder Filmmaterial: sein eigenes Medien-Item. Der Agent wählt/esetztet, zuschneidet, positioniert und wendet unterstützte Effekte darauf an; der Benutzer wird nicht erwartet, die Layer manuell zusammenzubauen.
  • Typografie, Formen und animierte Dekoration: transparente MG-Item(s). Trennen Sie Hintergrunddekoration von Vordergrundtext, wenn Medien dazwischen liegen müssen.

Planen Sie Layer-Reihenfolge, Zielmedienrechteck, Start/Dauer und Einblendungszeit vor dem Authoring. Geben Sie im MG-Brief/Code-Scope an, welche Layer bereits außerhalb des MG existieren, damit das Referenzfoto oder -papier nicht erneut generiert wird. Wenden Sie Schwarz-Weiß/Farbe/Körnung auf das beabsichtigte Medien-Item an, anstatt versehentlich den Vordergrundtext zu beeinflussen. Überprüfen Sie die Effektunterstützung auf der tatsächlichen Wiedergabe-/Exportfläche; das Trennen von Layern beweist nicht an sich die Web/Desktop-Parität.

  1. Verwenden Sie Assets von browse_assets im aktuellen Projekt wieder. Importieren Sie nur Produktionsdateien, die in der Ausgabe benötigt werden, in "Meine Assets". Laden Sie asset-import und verwenden Sie dessen import_media-Sitzungs-/Upload-Helper. Das Registrieren von Projektmedien veröffentlicht diese nicht in der öffentlichen Ressourcenbibliothek.
  2. Platzieren Sie normale Produktionsmedien über edit_item unter Verwendung der zurückgegebenen aktuellen Projekt-Asset-IDs. Der Agent kümmert sich um das Ersetzen von Beispielpersonen, Kopien und Daten mit dem Inhalt der aktuellen Aufgabe. Verwenden Sie nicht die vollständigen Assets der Referenz, wenn das Projekt eigene Medien für die Rolle hat. Entfernen Sie Beispielmedien, die nicht Teil der Projektproduktion sind; geben Sie die Asset-Erstellung nicht auf, wenn Beispielmedia-IDs fehlschlagen. Verwenden Sie import_media mit den Materialien des Host-Projekts. Verzögern Sie Timeline-Arbeit bis zum Platzierungsschritt, es sei denn, die edit_item-Schnittstelle des Hosts platziert ein importiertes Asset gleichzeitig.
  3. Wenn das endgültige MG zum Exportieren einer anderen Rolle oder Anzeige konvertiert werden muss, planen Sie für beide Versionen und konvertieren Sie nach der Bestätigung der ersten Version. Nicht benötigte Beispielmedien, Kopien oder Styling sollten nicht gerendert werden.
  4. Wenn Sie mehrere MGs für eine einzelne Timeline erstellen, erwägen Sie die Verwendung des collection-Typs, wenn ein einzelnes Inline-Item eine Sammlung von mehreren unabhängigen Unter-MGs enthalten kann. Wählen Sie diesen Ansatz, wenn er das Authoring und die Timeline vereinfacht; es ist keine Voraussetzung, falls der Workflow des Items und des Unter-MG-Kontexts keine Sammlungen unterstützt.

Nach dem Code

Nachdem Sie create_motion_graphic_from_code oder edit_asset aufgerufen haben:

  • Wenn Sie ein neues MG erstellt haben, lesen Sie browse_assets erneut und verifizieren Sie Asset-IDs und Vorschau, bevor Sie es in der Timeline platzieren.
  • Wenn Sie ein bestehendes MG bearbeitet haben, bestätigen Sie den Asset-Status, wenn die Antwort keinen direkten Erfolg anzeigt.
  • Überprüfen Sie nach dem Platzieren mit view_project_frame die visuelle Ausgabe, es sei denn, die Timeline-Arbeit wurde als letzter Schritt durchgeführt und ist sichtbar.

Timeline-Platzierung

Nach dem Erstellen eines MG ist die Timeline-Platzierung erforderlich, damit das Graphic im Video-Rendering erscheint. Dies erfolgt über den Tool-unterstützten Bearbeitungsworkflow.

Wenn das Ziel-Asset existiert: Verwenden Sie edit_item, um die Haupt-Timeline-Parameter (start, duration, targetViewportLayer, opacity, etc.) zu setzen. Setzen Sie es auf eine bestehende Audio/Video/Text-Spur. Platzieren Sie auf einer sichtbaren Spur, überlegen Sie, ob das MG sichtbar sein oder Tracks für andere Medien freimachen soll. Wenn kein bestehendes Item vorhanden ist, auf dem platziert werden kann, verwenden Sie add_item, um ein neues Item zu erstellen, das das MG referenziert. Das Item zeigt auf das neu erstellte MG-Asset.

Befolgen Sie die Tool-Schemas; wenn add_item ein vorhandenes Asset referenziert, erstellt das Tool den Item-Eintrag und platziert es auf der Timeline. Verwenden Sie keine add_item-Tools, die ausschließlich für Medienaufnahmen bestimmt sind, um MG-Assets zu referenzieren.

Timeline-Platzierung über MCP-Tools:

  1. Verifizieren Sie die Asset-ID des MGs (von der Erstellungsantwort oder browse_assets) und die Zielspurnummer.
  2. Verwenden Sie add_item oder edit_item, je nachdem, ob das Item neu ist oder vorhanden. trackOrder bestimmt die visuelle Reihenfolge.
  3. Setzen Sie start, duration und targetViewportLayer, um die Sichtbarkeit zu steuern.
  4. Fügen Sie bei Bedarf Animationen oder andere Item-Eigenschaften hinzu.

Wenn die Tool-Schnittstelle eine Timeline-Unterstützung anzeigt, verwenden Sie den vom ChatCut-Host bereitgestellten Tool-Workflow. Wenn keine Timeline-Tools verfügbar sind, melden Sie die fehlende ChatCut-Timeline-Plugin-Unterstützung.

Timeline-Item-Konfiguration

Wenn Sie ein Item in der Timeline platzieren, konfigurieren Sie seine Parameter gemäß dem zuvor identifizierten Bedarf:

  • placement: Spezifisch mit Startzeit und Dauer (in Sekunden).
  • layer: Ziellayer (z. B. "video1", "overlay2"), abgestimmt auf die Sichtbarkeit.
  • startTime: Wenn das MG beginnen soll (in Sekunden).
  • duration: Wie lange das MG sichtbar bleiben soll (in Sekunden).
  • fit: Wie das Asset die Begrenzungen des Ziel-Layers ausfüllt (z. B. "fit", "fill", "stretch").
  • opacity: Transparenzniveau (0,0 bis 1,0).
  • transform: Zusätzliche 2D-Transformationen (Position, Skalierung, Rotation, Verzerrung), die vom Standard-Layer-Rahmen abweichen.
  • blendMode: Mischmodus (z. B. "normal", "multiply", "screen").
  • entrance, exit: Ein- und Ausblendeffekte (z. B. {"type": "fade"}).

Nicht benötigte Felder weglassen. Timelines messen Frames in Sekunden. Verwenden Sie browse_assets, um MG-Haupt-Asset-IDs zu lokalisieren, nachdem sie erstellt wurden.

Nach dem Platzieren überprüfen

Nach Platzierungsänderungen lesen Sie view_project_frame, um das komponierte Aussehen zu überprüfen. Überprüfen Sie, ob das MG sichtbar und lesbar ist und die beabsichtigte Rolle erfüllt. Wenn Sie mehrere Grafiken erstellen, planen Sie die Timeline-Positionen und stellen Sie sicher, dass sie nicht unnötig kollidieren. Nachdem Sie die Platzierung über MCP-Tools abgeschlossen haben, aber bevor Sie die Aufgabenerfüllung melden, lesen Sie den aktuellen Projekt-Frame, um die Anzeige zu bestätigen.

Keine Aufgabe ist abgeschlossen, bis die Timeline-Platzierung des MGs überprüft ist (entweder über view_project_frame oder eine andere visuelle Bestätigung).

Motion Graphics sichern (Referenz)

Wenn Sie ChatCut-Motion-Graphic-Assets erstellen, können Sie diese in einer Bibliothek referenzieren, indem Sie die Assigned-Asset-IDs notieren. Die Referenzierung eines Assets erstellt keine Kopie. Verwenden Sie die Asset-ID in der Timeline-Item-Konfiguration.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills