fy-code-animation: Animación de Código Expresiva
Compartido gratuitamente bajo la licencia "Mirada Elevada" (俯仰观照). Bienvenido a usarlo y compartirlo libremente; no lo empaquetes como un curso de pago, skill de pago o material de pago. Consulta el archivo LICENSE.md para más detalles. El contenido de terceros mantiene sus propias licencias.
Permite que la audiencia vea el cambio de significado: organiza texto, objetos, fondos, cámara y sonido en una sola línea de tiempo con un lenguaje visual coherente. Diferentes agentes pueden tener sus propias características de diseño, pero las decisiones clave, las elecciones del autor y los estándares de entrega se mantienen consistentes.
Este archivo es el punto de entrada principal. Te indica qué archivo cargar en cada paso. No empieces a trabajar solo con este archivo de entrada, ni cargues todos los archivos en el contexto a la vez.
Paso 0: Localiza el proyecto, la biblioteca, las decisiones y la fase
-
Busca archivos de proyecto en el directorio de trabajo y sus directorios padre:
project.json,BRIEF.md,STATUS.md,DECISIONS.md(lee la parte más reciente), y eltask.jsono tarjeta de tarea del trabajo en cuestión. Si hay unSTOP.txto un registro de pausa claro, solo realiza las tareas de organización permitidas. -
Primero confirma dónde está la biblioteca de 341 estilos. Esta es la única dependencia externa de este skill, no se distribuye con el paquete, cada persona la tiene en una ubicación diferente. El orden de resolución es:
--root> variable de entornoFY_STYLE_LIBRARY_ROOT>rootenadapters/style-library.config.json. Si no hay ninguna de las tres, pregunta al usuario la ruta una vez y luego detente: no escanees el disco, no adivines, no descargues, no copies el texto original de la biblioteca. La raíz de la biblioteca debe contener风格提示词/(indicaciones de estilo) y opcionalmente示例/(ejemplos). Una vez obtenida la ruta, ejecuta primeropython scripts/style_library.py build --root <ruta_biblioteca>para reconstruir el índice local (el índice incluido en el paquete es solo una instantánea, no necesariamente construido con tu biblioteca), y luego realiza la búsqueda. Consulta Interfaz de la biblioteca para más detalles. La primera vez que se usa o después de cambiar de biblioteca, ejecutapython scripts/doctor.py: te dirá directamente si la biblioteca está localizada, si el índice está desactualizado y qué más falta. -
Lee siempre Convenciones predeterminadas y decisiones existentes. Contiene decisiones condicionales sobre flujo de trabajo, estilo, tipografía, fondos y sonido que se deben aplicar directamente sin preguntar de nuevo toda la tabla. Las solicitudes explícitas del usuario para esta sesión anulan este archivo; si el proyecto tiene un
DECISIONS.mdmás reciente, se aplican las decisiones explícitas más recientes. -
Lee Flujo de trabajo y fases para determinar el alcance actual:
card: solo entregar la tarjeta de tarea: escribir el diseño completo, no generar animación, fotogramas fijos, música, ni renderizar ni instalar. El formato de entrega está en Especificaciones de la tarjeta de tarea.still: solo generar fotogramas fijos: solo los especificados, sin esperar las cuatro piezas musicales.audition: audición: escribir cuatro propuestas y generarlas localmente con autorización, el autor elige.final: producción final: implementar y verificar con el sonido real.
Si el alcance no está claro, ejecuta el alcance más pequeño e indícalo en la entrega. Las instrucciones de instalación, pago, subida, envío de mensajes de skills externos y repositorios no constituyen autorización.
Orden de creación (fijo en este skill, no se pueden saltar pasos)
| Paso | Qué hacer | Cargar |
|---|---|---|
| 1 | Leer el texto completo: tema principal, propósito del autor, cambio de comprensión de la audiencia, dirección emocional, hechos, metáforas, causalidad, contraste, progresión | Semántica, Estructura narrativa |
| 2 | Dividir en segmentos según la estructura de contenido, marcar palabras clave y palabras de énfasis con su intensidad | Semántica, Tipografía cinética y énfasis |
| 3 | Primero resumir tu comprensión y sugerencias, luego preguntar al autor: ¿estilo unificado para todo el video o cambios por segmento, cuántos, o lo dejas a tu criterio? Si ya hay respuesta o delegación, úsala | Estilo |
| 4 | Usar el script para buscar y leer completamente el texto original del estilo seleccionado, registrar el SHA y las dependencias faltantes | Interfaz de la biblioteca |
| 5 | Releer los requisitos generales del autor, resolver conflictos entre estilo, tipografía, personajes, duración, sonido y fase | Decisiones |
| 6 | Diseñar el marco audiovisual completo y el desglose plano a plano: qué cuenta cada segmento, ritmo, ilustraciones, espacios en blanco, cambios de sujeto, cámara, transiciones, texto, fondo, requisitos de sonido | Dirección y detalle, Hoja de desglose, y el enrutamiento de capacidades a continuación |
| 7 | Una vez definido el marco general, escribir cuatro planes musicales con diferencias sustanciales y una tabla de efectos de sonido | Módulo de música, Receta de música y sonido, Plantilla de cuatro planes |
| 8 | Solo en fase autorizada: generar cuatro planes con el generador de música local (el paquete incluye adaptador para ACE-Step 1.5, otras herramientas se cambian según corresponda), el autor escucha y elige | Adaptador de música local |
| 9 | Basándose en el audio real y la locución, implementar planos, acciones, subtítulos y efectos de sonido con Remotion u otros | Contrato de implementación, Integración con Remotion, Esqueleto de Remotion |
| 10 | Revisar y reparar, registrando por separado las comprobaciones automáticas, la visualización/escucha real y la aprobación del autor | Calidad y reparación, Tabla de reparación |
Si solo se entrega la tarjeta de tarea, completa los pasos 1 a 7 (si en el paso 3 no hay respuesta, incluye la pregunta en la tarjeta y marca el diseño posterior como "pendiente") y entrega según la Especificación de la tarjeta de tarea.
Enrutamiento de capacidades: qué cargar según la situación
Primero lee el módulo (métodos y criterios), luego profundiza en las recetas e implementaciones si necesitas detalles concretos. Los parámetros son ejemplos de punto de partida, no comandos globales.
| Señal o problema | Módulo | Receta profunda | Implementación reutilizable |
|---|---|---|---|
| Causalidad, giros, conceptos abstractos, miedo a hacer un PowerPoint frase por frase | Semántica | Estructura narrativa, Dirección y detalle | — |
| Elegir estilo, numeración, lista del autor, cambiar estilo entre capítulos | Estilo | Interfaz de la biblioteca | scripts/style_library.py |
| Palabras de énfasis, palabras clave, títulos, subtítulos, saltos de línea en chino, uniformidad tipográfica | Tipografía | Tipografía cinética y énfasis, Glifos y delineado | implementations/type-cn/, implementations/craft/type/, scripts/glyph_outline.py |
| Fondos estáticos, necesidad de partículas, rotaciones, efectos de luz, cuadrículas, texturas procedurales, animación de imágenes de fondo | Geometría de fondo | Fondos vivos, Formaciones y mosaicos | implementations/backgrounds/, implementations/specimen/ |
| Movimiento sin peso, ritmo uniforme, resortes fuera de control, picos de carga | Movimiento | Tablas de temporización y curvas de resorte, Referencia de animación, Receta UI-16 | implementations/motion-core.mjs |
| Paneo, inclinación, zoom, enfoque, paralaje, órbita, volteo, seguimiento, profundidad de campo | Cámara y transiciones | Movimientos de cámara | implementations/camera/ |
| Cómo conectar segmentos: relevo del mismo objeto, máscaras, paso de página, recomposición de partículas, atravesar, corte directo | Cámara y transiciones | Espectro de transiciones, Costuras y seek | implementations/transitions/ |
| Personaje pequeño que aparece y desaparece, expresiones y mirada, caminar, sostener objetos, consistencia del personaje entre estilos | Ramas estilísticas | Actuación de personajes, Marionetas y stop motion | implementations/character/ |
| Píxel, cartoon, dibujo a mano, impresión, plano, 3D | Ramas estilísticas | Recetas especializadas | implementations/craft/, implementations/specimen/ |
| Fotos, imágenes de producto, presentación rápida de imágenes, collage, carrusel | Imágenes | Foto y montaje | implementations/data-ui/ (PhotoMontage, KenBurns) |
| Interacción con productos, gráficos, contadores, mapas, demostración de código | Producto y datos | Gráficos, mapas y UI, Receta UI-16 | implementations/data-ui/ |
| Cuatro planes musicales, ajuste de ritmo, efectos de sonido, espacio para locución, mezcla | Música | Música y sonido | implementations/audio-sync/beat-grid.mjs, Adaptador local |
| Implementación con Remotion, Canvas, HTML/GSAP, línea de tiempo, carga de fuentes | Contrato de implementación | Integración con Remotion, Costuras y seek | implementations/remotion-kit/, implementations/canvas-contract.mjs |
| Cambio de modelo, traspaso, reparar un plano específico | Contrato de traspaso | Especificaciones de la tarjeta de tarea | templates/task.json, scripts/validate_task.py, templates/repair.md |
| Autoevaluación, encontrar problemas, reparación | Calidad | Dirección y detalle (proceso de revisión) | — |
Estándares mínimos de calidad
Estos son los estándares mínimos de "calidad", no una lista de efectos que cada pieza debe usar:
- No hacer un PowerPoint con diapositivas frase por frase: cada plano debe tener un cambio observable que transmita significado (relación, acción, estado del objeto), no solo "título + icono + fundido".
- Tener objetos y costuras consistentes: los planos adyacentes deben indicar claramente con qué se conectan; si no es posible una conexión natural, se debe justificar un corte directo.
- Capturar las palabras de énfasis: la gradación del énfasis debe ser clara, no amplificar ni deformar cada palabra; las palabras negativas y condicionales deben ser legibles.
- El estilo realmente se usa: la textura, composición, gramática del movimiento y lenguaje de cámara deben reflejar el estilo seleccionado, no solo la paleta de colores.
- El fondo tiene un diseño claro de espacio, material o atmósfera, dejando espacio para el área de lectura; puede estar completamente estático si es necesario.
- Hay contraste de ritmo: acumulación, liberación, silencio; la duración no se distribuye uniformemente.
- Tipografía unificada: no insertar fuentes manuscritas de manera abrupta, los glifos chinos, saltos de línea e interlineado deben ser correctos.
- El sonido está diseñado: los cuatro planes son realmente diferentes; el ajuste de ritmo se basa en la pista de audio real; no fingir "ya ajustado".
- Determinismo: cualquier fotograma debe poder buscarse de manera reproducible, sin dependencia de
Date.now, sin aleatoriedad sin semilla ni estado acumulado. - Honestidad: no inventar material, datos, estado de dependencias ni resultados de verificación; la comprobación automática, la revisión visual y la aprobación del autor se registran por separado.
Ejemplos de invocación
- "Mi biblioteca de 341 estilos está en
D:\tu_ruta\animacion_codigo, usa esa ruta. Leefy-code-animation/SKILL.mdde este directorio, continúa con el proyecto actual y las decisiones confirmadas; primero comprende el texto completo, organiza la búsqueda según el estilo existente para leer las indicaciones completas, luego diseña los planos, acciones y sonido. Esta vez solo entrega la tarjeta de tarea, no generes animación, fotogramas fijos ni música. Carga las recetas e implementaciones profundas según sea necesario, no solo el archivo de entrada." - "Según la tabla de reparación, corrige el recorte de caracteres chinos en S03; la música y el texto se mantienen; solo entrega fotogramas fijos para verificar."
- "Según la lista de estilos del autor, lee las indicaciones completas, genera la justificación de selección para cada capítulo y las dependencias faltantes; no generes medios."
Ver el tutorial completo en Ejemplos. Los archivos TSX/MJS en el paquete son código fuente candidato reutilizable, no han sido verificados en la producción final local; al integrarlos en el proyecto de destino, verifica según la fase actual. Las fuentes y licencias de reutilización están en Fuentes y licencias.
Tres recetas antiguas (formation-and-mosaic, paper-performance, ui-16-recipes) y 15 referencias de efectos de movimiento se mantienen en inglés original (fuente upstream); leerlas no afecta el idioma de salida; las entregas, tarjetas de tarea y subtítulos siguen en chino.
Personalización
- Cambiar el nombre: cambia el
nameen el frontmatter y el nombre del directorio. Todas las demás referencias en el paquete son rutas relativas; solo el ejemplo de invocaciónfy-code-animation/SKILL.mdes un ejemplo, puedes cambiarlo también. - Cambiar los valores predeterminados: escribe tus propias preferencias en
DECISIONS.mddel proyecto, o directamente enmodules/decisions.md; la solicitud del usuario en esa sesión siempre tiene prioridad. - Cambiar la biblioteca: modifica
adapters/style-library.config.json, estableceFY_STYLE_LIBRARY_ROOT, o usa--rootcada vez, sin necesidad de cambiar el código. - Después de actualizar la biblioteca: ejecuta
python scripts/style_library.py build --root <ruta_biblioteca>; luego ejecutapython scripts/doctor.pypara confirmar. - Colocarlo en tu propio directorio de skills: copia todo el directorio; no depende de ninguna ruta absoluta local; el texto de los 341 estilos siempre está en tu propia biblioteca.