Communitygithub.com

Arranque Motion

Entwurf, Implementierung, Rendering, Überprüfung oder Verbesserung von animierten S03–S12-Szenen in arranque-so, oder Neuerstellung von S01/S02, mit Charakteren, Kameras, Signalen, einer 3D-Welt und Dialog-Synchronisation. Verwende dies bei der Arbeit an filmischer Choreografie und der Validierung technischer Genauigkeit und Kontinuität.

Was ist Arranque Motion?

Diese Skill-Anleitung (SKILL.md) beschreibt den vollständigen Arbeitsablauf für die Erstellung und Überprüfung animierter Szenen im Projekt 'arranque-so'. Sie richtet sich an KI-Agenten wie Claude Code oder Codex, die filmische Choreografien mit Figuren, Kameras, Dialogen und einer 3D-Umgebung umsetzen. Der Prozess gliedert sich in sechs Phasen: Vertragserfüllung (Abgleich mit Spezifikation), Erstellung eines Beat-Sheets (Bewegung → technisches Detail), Implementierung (Generierung von Szenengerüsten, Registrierung und Verknüpfung von Ankern), numerische Validierung (automatisierte Tests für Korrektheit, Determinismus und Konsistenz), Rendering und Inspektion (Erstellung von Bildern, HTML-Bögen und optionalen Videos mit metrischen Vergleichen) sowie Kritik/Korrektur anhand einer Bewertungsmatrix. Die Skill definiert klare Bestehenskriterien für jede Phase und stellt sicher, dass jede Bewegung durch einen technischen Fakt erklärt wird, keine Folienästhetik verwendet wird (z.B. keine beigen Hintergründe, Karten oder statischen Panels) und dass alle Anker und Schnitte durch Bildmaterial belegt werden. Besonderes Augenmerk liegt auf der Wiederverwendbarkeit von Komponenten, der strikten Trennung von Skript und DOM/React, sowie der Sicherstellung, dass numerische Tests nicht als visuelle Qualitätsaussagen missverstanden werden.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/andres18113/animacion-muejeje/tree/HEAD/.agents/skills/arranque-motion

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Arranque Motion?

Arbeite vom Repository-Stammverzeichnis aus mit Node 24 und installierten Abhängigkeiten. Implementierer folgen den Phasen; Regisseure validieren die Bewertungsmatrix vor der Freigabe. Behalte S01/S02 als genehmigten Referenzstand bei. Implementiere nur Szenen, die vom Benutzer autorisiert wurden.

In Referenzen zitiert repo:pfad#symbol eine Datei relativ zum Stammverzeichnis und dessen Export; öffne sie lokal. Die Links zu Referenzen/Skripten/Assets sind relativ zu dieser Skill.

Einzige Quelle: .agents/skills/arranque-motion/ (Codex-Entdeckung). Claude Code entdeckt sie über den Verknüpfungspunkt .claude/skills/arranque-motion; falls dieser in einem frischen Klon fehlt, führe enlazar-skills aus. Bearbeite nur die einzige Quelle; kopiere diesen Inhalt nicht in andere Dateien und bearbeite nicht skills-lock.json (welches entfernte Skills aufzeichnet).

0. Vertrag

Der historische externe Spezifikationstext ../SO-ARR-BIOS-001 v2.0.0.md (§8 Szene, §9, §12 und technischer Betrieb) ist optionaler Autorenkontext und nicht in diesem Repository enthalten. Verwende für Überprüfungen in einem frischen Klon die lokalen Verträge und tests/fixtures/boot-contract.json für Dialog-/Storyboard-Referenzdaten. Lies src/arranque/escenas.ts (ContratoEscena/ESCENAS), tiempo.ts, dialogo.ts, subtitulos.ts, anclas.ts, recursos.ts, audio.ts unter src/arranque/, sowie docs/arranque/README.md / VOCES.md. Überprüfe Eingaben, Ausgaben, Dauer, Charaktere und Voraussetzungen gegen die BIOS-Basislinie. Wenn ein Vertrag/Cue fehlt, erstelle ihn vor der Generierung einer autorisierten Szene. Füge ANCLAS_VISUALES mit vollständigen Wörtern innerhalb eines Segments hinzu; führe node tests/validar-h02.mjs aus. Bestehen: nachvollziehbarer Vertrag, sich nicht überschneidende relative Cues, vorhandene Anker und streng pro Szene geordnet. Lies Signale und Energie.

1. Beat-Blatt

Kopiere die Vorlage in den Überprüfungsdatensatz. Fülle Beat → technischen Fakt aus der Spezifikation (A0x oder B/C/D je nach Phase) → Aktion → Ankerwort → Bild ein, berechnet mit anclasDeEscena. Ordne jeder Aktion Antizipation, Reaktion und Beruhigung zu. Überprüfe Schauspiel und Kameras. Verwende node .agents/skills/arranque-motion/scripts/buscar-camara.mjs --help; führe das Suchwerkzeug mit Sprecher- und Zielregionen aus (Sekundär vorne / Ziel hinten). Bestehen: jede Bewegung erklärt einen Fakt; keine Folienästhetik: beige Hintergründe, Karten, statische Panels, Zeitangaben oder Kopfzeilen. Der Regisseur kann jeden Beat mit seinem Wort/Bild vergleichen.

2. Implementierung

Lies deterministische Architektur. Erstelle zuerst den Plan:

node .agents/skills/arranque-motion/scripts/nueva-escena.mjs --id S03 --nombre "Primera instrucción" --componente S03PrimeraInstruccion --dry-run

Der Generator erstellt reine cine/guion/Sxx.ts- und escenas/SxxNombre.tsx-Dateien unter src/arranque/ nur für eine autorisierte Szene. Er gibt Registrierungseinträge aus; er ändert Root nicht. Dem Skelett fehlt die genehmigte Choreografie: ersetze die Beispiel-Kamera/Zustände durch den vorherigen Schnitt. Registriere in src/Root.tsx, innerhalb des Ordners des entsprechenden Meilensteins, unter Beibehaltung von CRLF; füge Anker in src/arranque/anclas.ts hinzu sowie einen Eintrag/Link in src/arranque/cine/guion/registro.ts für validar-cine und die Werkzeuge. Verwende Mundo3D, Actor, SubtituloCine, CapaAudio, useCoreografia wieder; capas bietet trazar/puntoEn/dParcial, SenalViajera, OndaAlterna, FlujoContinuo und FiltrosBrillo; instrumentos bietet Trazas/escalon/subidaEstabilizada. Actor bietet manoEnPantalla/anguloVentilador. Konsultiere Referenzen für tatsächliche Signaturen und Quellen. Bestehen: Skript unabhängig von DOM und React; f konvertiert Bilder in Sekunden; gemeinsame projizierte Kamera; dauerhafte Zustände und Akteure, die am Schnitt verbunden sind. Ändere keine Maskottchendateien oder Abhängigkeiten.

3. Numerische Validierung

node tests/validar-cine.mjs
node tests/validar-h02.mjs
npx --no-install tsc
npx --no-install eslint src

Bestehen: alle Exit-Codes 0. validar-cine durchläuft Bilder, misst volle Sprecher ≥200 px, Band y≤885, Deterministisches mit Suchvorgängen außerhalb der Reihenfolge und registrierten Verknüpfungen. h02 überprüft Vertrag, Dialog, Untertitel, Anker, technische Werte und Audio. tsc/eslint überprüfen die Integration. Diese Prüfungen ersetzen keine visuelle Inspektion.

4. Rendern und Inspektion

Lies Leistung und Rendering. Auf dem Host:

node .agents/skills/arranque-motion/scripts/revisar-escena.mjs --composicion MacroEncendido --anclas --secuencias --video --escala 0.5 --dry-run
node .agents/skills/arranque-motion/scripts/revisar-escena.mjs --composicion MacroEncendido --anclas --secuencias --video --escala 0.5

Der Prüfer speichert PNGs, paginierte HTML/Chrome-Bögen, optional MP4, Index und Manifest (Bilder, Hashes, Argumente) in out/revision/COMPOSICION/DATUM-ZEIT/. Standardmäßig enthält es Anker, Start/Ende und beide Seiten von Schnitten. Untersuche vollständige ±Radius-Sequenzen um Aktionen herum; erweitere den Radius oder die Bilder, um Antizipation und Beruhigung einzuschließen. Verwende --bundle RUTA bei Iterationen wieder; generiere dann 1080p mit --escala 1 --video --bundle RUTA. Für HTML ohne Rendern verwende --hoja manifest.json mit vorhandenen PNGs. Bestehen: jeder Anker/Schnitt hat einen Beleg; jede Aktion hat eine Sequenz, und Vorschau sowie 1080p wurden überprüft. Rendere ein Bild zweimal auf dieser GPU und vergleiche SHA-256. In der Sandbox führe nicht Remotion CLI aus (esbuild Access denied); ersetze keine Bundler-/Renderer-Importe. Liefere den Plan an den Host und markiere Renderings als ausstehend.

5. Kritik und Korrektur

Wende die Bewertungsmatrix an, Punkt für Punkt: PASS/FAIL und Belege-Datei/-Bild im Beat-Blatt. Korrigiere Fehler und wiederhole die Phasen 3–5 für betroffene Bereiche, bis alle bestehen. Erkläre keine Freigabe, wenn Video, Kontrastmessung oder Regievalidierung fehlen.

6. Regression und Auslieferung

node .agents/skills/arranque-motion/scripts/regresion-visual.mjs --manifiesto .agents/skills/arranque-motion/assets/regresion/macro-encendido.json --bundle out/bundle
node tests/validar-rigs.mjs
node tests/verificar-mascotas.mjs
node tests/validar-svg-mascotas.mjs
node .agents/skills/arranque-motion/scripts/validar-skill.mjs

Der Vergleicher verwendet acht genehmigte Bilder. Bestehen: identische Hashes auf der Referenzmaschine/GPU und alle Befehle mit Exit-Code 0. Verwende --actualizar nur nach genehmigten visuellen Änderungen, unter Beibehaltung vorheriger Belege und Begründung. Der Skill-Validator überprüft Struktur, Zitate, Hilfe und Erkennung; --permitir-pendiente validiert vorläufig, ohne zu behaupten, dass der Verknüpfungspunkt installiert ist. comun.mjs zentralisiert CLI, Katalog und HTML-Bögen; animiere nicht mit der Uhr seiner Datensätze. Liefere geänderte Dateien, Blatt/Bewertungsmatrix, Manifeste, Befehle mit Exit-Codes, Vergleich und Host-ausstehende Elemente aus. Stelle numerische Tests nicht als visuelle Qualitätsaussagen dar.

Verwandte Skills