Communitygithub.com

fy-code-animation

Convierte texto en chino, indicaciones de estilo y sonido en animaciones de código expresivas con estética unificada y coherencia narrativa (Remotion / Canvas / HTML).

¿Qué es fy-code-animation?

Este skill está diseñado para agentes de IA que necesitan crear animaciones de código profesionales a partir de contenido en chino, indicaciones de estilo y sonido. Proporciona un flujo de trabajo estructurado de 10 pasos que cubre desde la comprensión semántica del texto hasta la generación final de video con Remotion, pasando por la selección de estilos visuales (acceso a una biblioteca de más de 341 estilos), diseño de tipografía dinámica, animación de fondos y partículas, física de movimiento, movimientos de cámara, transiciones, actuación de personajes, soporte para ramas estilísticas (píxel, cartoon, dibujo a mano, 3D), gráficos, mapas, UI y montaje fotográfico. Incluye además la composición de cuatro propuestas musicales distintas con efectos de sonido, y un riguroso proceso de control de calidad con separación de hallazgos automáticos, revisión humana y aprobación del autor. Soporta distintos alcances de entrega: solo tarjeta de tarea (diseño completo sin generación de medios), fotograma fijo, audición musical o producción final. No está diseñado para instalar dependencias automáticamente ni para generar medios sin autorización explícita del usuario.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FYZB2020/dsh-fy-code-animation/tree/main/skills/fy-code-animation

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. 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 el task.json o tarjeta de tarea del trabajo en cuestión. Si hay un STOP.txt o un registro de pausa claro, solo realiza las tareas de organización permitidas.

  2. 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 entorno FY_STYLE_LIBRARY_ROOT > root en adapters/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 primero python 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, ejecuta python scripts/doctor.py: te dirá directamente si la biblioteca está localizada, si el índice está desactualizado y qué más falta.

  3. 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.md más reciente, se aplican las decisiones explícitas más recientes.

  4. 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)

PasoQué hacerCargar
1Leer 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ónSemántica, Estructura narrativa
2Dividir en segmentos según la estructura de contenido, marcar palabras clave y palabras de énfasis con su intensidadSemántica, Tipografía cinética y énfasis
3Primero 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, úsalaEstilo
4Usar el script para buscar y leer completamente el texto original del estilo seleccionado, registrar el SHA y las dependencias faltantesInterfaz de la biblioteca
5Releer los requisitos generales del autor, resolver conflictos entre estilo, tipografía, personajes, duración, sonido y faseDecisiones
6Diseñ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 sonidoDirección y detalle, Hoja de desglose, y el enrutamiento de capacidades a continuación
7Una vez definido el marco general, escribir cuatro planes musicales con diferencias sustanciales y una tabla de efectos de sonidoMódulo de música, Receta de música y sonido, Plantilla de cuatro planes
8Solo 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 eligeAdaptador de música local
9Basándose en el audio real y la locución, implementar planos, acciones, subtítulos y efectos de sonido con Remotion u otrosContrato de implementación, Integración con Remotion, Esqueleto de Remotion
10Revisar y reparar, registrando por separado las comprobaciones automáticas, la visualización/escucha real y la aprobación del autorCalidad 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 problemaMóduloReceta profundaImplementación reutilizable
Causalidad, giros, conceptos abstractos, miedo a hacer un PowerPoint frase por fraseSemánticaEstructura narrativa, Dirección y detalle—
Elegir estilo, numeración, lista del autor, cambiar estilo entre capítulosEstiloInterfaz de la bibliotecascripts/style_library.py
Palabras de énfasis, palabras clave, títulos, subtítulos, saltos de línea en chino, uniformidad tipográficaTipografíaTipografía cinética y énfasis, Glifos y delineadoimplementations/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 fondoGeometría de fondoFondos vivos, Formaciones y mosaicosimplementations/backgrounds/, implementations/specimen/
Movimiento sin peso, ritmo uniforme, resortes fuera de control, picos de cargaMovimientoTablas de temporización y curvas de resorte, Referencia de animación, Receta UI-16implementations/motion-core.mjs
Paneo, inclinación, zoom, enfoque, paralaje, órbita, volteo, seguimiento, profundidad de campoCámara y transicionesMovimientos de cámaraimplementations/camera/
Cómo conectar segmentos: relevo del mismo objeto, máscaras, paso de página, recomposición de partículas, atravesar, corte directoCámara y transicionesEspectro de transiciones, Costuras y seekimplementations/transitions/
Personaje pequeño que aparece y desaparece, expresiones y mirada, caminar, sostener objetos, consistencia del personaje entre estilosRamas estilísticasActuación de personajes, Marionetas y stop motionimplementations/character/
Píxel, cartoon, dibujo a mano, impresión, plano, 3DRamas estilísticasRecetas especializadasimplementations/craft/, implementations/specimen/
Fotos, imágenes de producto, presentación rápida de imágenes, collage, carruselImágenesFoto y montajeimplementations/data-ui/ (PhotoMontage, KenBurns)
Interacción con productos, gráficos, contadores, mapas, demostración de códigoProducto y datosGráficos, mapas y UI, Receta UI-16implementations/data-ui/
Cuatro planes musicales, ajuste de ritmo, efectos de sonido, espacio para locución, mezclaMúsicaMúsica y sonidoimplementations/audio-sync/beat-grid.mjs, Adaptador local
Implementación con Remotion, Canvas, HTML/GSAP, línea de tiempo, carga de fuentesContrato de implementaciónIntegración con Remotion, Costuras y seekimplementations/remotion-kit/, implementations/canvas-contract.mjs
Cambio de modelo, traspaso, reparar un plano específicoContrato de traspasoEspecificaciones de la tarjeta de tareatemplates/task.json, scripts/validate_task.py, templates/repair.md
Autoevaluación, encontrar problemas, reparaciónCalidadDirecció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. Lee fy-code-animation/SKILL.md de 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 name en el frontmatter y el nombre del directorio. Todas las demás referencias en el paquete son rutas relativas; solo el ejemplo de invocación fy-code-animation/SKILL.md es un ejemplo, puedes cambiarlo también.
  • Cambiar los valores predeterminados: escribe tus propias preferencias en DECISIONS.md del proyecto, o directamente en modules/decisions.md; la solicitud del usuario en esa sesión siempre tiene prioridad.
  • Cambiar la biblioteca: modifica adapters/style-library.config.json, establece FY_STYLE_LIBRARY_ROOT, o usa --root cada 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 ejecuta python scripts/doctor.py para 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.

Skills relacionados