/director-de-movimiento-de-código
┌──────────────────────────────────────┐
│ 🔴 🟡 🟢 src/auth/session.ts [9:16]│ barra de título Mac con ruta de archivo
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02 const decoded = await verify(); │ línea activa enfocada
│ 03 if (!decoded.valid) { ┌─────┼─ 01 Validación de token
│ 04 throw new AuthError(); │ │
│ 05 } │ líneas inactivas atenuadas
│ 06 return decoded.user; │
├──────────────────────────────────────┤
│ > EJECUCIÓN EN TERMINAL │ cajón deslizante de terminal
│ > POST /api/v1/auth/verify HTTP/1.1 │ registro animado de stdout
│ > Estado: 200 OK (14.2ms) │
└──────────────────────────────────────┘
Primer uso
El directorio de esta habilidad es el directorio base del paquete de la habilidad.
# Verificar que Python 3 está instalado
python3 --version || python --version
Se ejecuta de forma independiente sin claves de API externas, dependencias pesadas ni API en la nube de pago. Utiliza Canvas / SVG sin interfaz gráfica con Playwright, Puppeteer o ffmpeg opcionales para renderizado de MP4 sin cabeza.
Pasos de ejecución del agente
- Código y guión: Pregunta al usuario por el fragmento de código o extráelo de su solicitud. Identifica la narrativa central:
- ¿Qué lenguaje? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
- ¿Cuál es el punto focal? (por ejemplo, una llamada async await, un decorador, un lanzamiento de error, un retorno recursivo).
- ¿Qué salida de terminal o resultado de ejecución demuestra que funciona?
- Creación de especificación: Escribe
<nombre>.code.json(especificación detallada a continuación) en el directorio de trabajo. - Construcción y renderizado: Ejecuta el script de construcción:
python build.py <nombre>.code.json- Para una reproducción HTML interactiva inmediata, abre el archivo
<nombre>.motion.htmlgenerado. - Para inspeccionar una imagen fija:
python build.py <nombre>.code.json --snap 4.5. - Para validar la sintaxis del esquema:
python build.py <nombre>.code.json --validate.
- Para una reproducción HTML interactiva inmediata, abre el archivo
- Control de calidad:
- Las líneas de código caben cómodamente sin desbordamiento horizontal (máximo 48 caracteres por línea recomendado para 9:16 móvil; máximo 80 para 16:9).
- Las llamadas son concisas, numeradas del 01 al 03, y apuntan claramente a las líneas objetivo.
- La salida del terminal refleja con precisión un comportamiento de ejecución realista.
- Entrega: Entrega al usuario la ruta del HTML / video renderizado y el resumen de la especificación.
Formato de especificación (<nombre>.code.json)
{
"title": "src/auth/session.ts",
"language": "typescript",
"aspectRatio": "9:16",
"theme": "obsidian",
"code": [
"async function verifyToken(token: string) {",
" const session = await auth.verify(token);",
" if (!session.isValid) {",
" throw new UnauthorizedError('Expired');",
" }",
" return session.user;",
"}"
],
"focusLines": [2, 3],
"typingSpeed": 35,
"callouts": [
{
"line": 2,
"label": "Verificación Asíncrona",
"note": "Espera la firma criptográfica",
"side": "right"
},
{
"line": 4,
"label": "Cláusula de Guardia",
"note": "Rechaza cargas JWT caducadas",
"side": "right"
}
],
"terminal": {
"enabled": true,
"title": "Salida del Servidor (Node.js v22)",
"commands": [
"$ curl -X POST https://api.dev/auth/verify",
"> Verificando firma HMAC-SHA256...",
"> Token Verificado: user_id=4092 [200 OK]"
]
},
"sound": {
"typewriterClicks": true,
"completionChime": true
},
"durationSeconds": 8.0
}
Definiciones de Parámetros
title: Cadena mostrada en la barra de encabezado de la ventana (por ejemplo, nombre de archivo o ruta de módulo).language:"javascript","typescript","python","rust","go","sql","bash".aspectRatio:"9:16"(Reel vertical para TikTok/Shorts/Instagram) o"16:9"(Pantalla ancha horizontal).theme:"obsidian"(violeta oscuro profundo),"onedark"(inspirado en Atom),"monokai"(clásico de alto contraste) o"cyberpunk"(cian/magenta neón).code: Arreglo de cadenas, cada una representando una línea de código.focusLines: Arreglo de números de línea basados en 1 para mantener al 100% de brillo mientras las otras líneas se atenúan.callouts: Lista opcional de anotaciones. Se recomienda un máximo de 3 llamadas.line: Número de línea basado en 1 para anclar la línea guía.label: Encabezado corto en mayúsculas o negrita (máximo 18 caracteres).note: Subtítulo explicativo (máximo 28 caracteres).
terminal: Cajón inferior opcional con comandos de stdout y respuestas.sound: Configuración opcional de síntesis procedural de la Web Audio API (clics de escritura y campanilla).durationSeconds: Duración total de la animación (por defecto: 8.0s).
Plataformas Compatibles
| Plataforma | Método de Integración |
|---|---|
| Claude / Claude Code | Cargado vía SKILL.md en ~/.claude/skills/code-motion-director/ o en el workspace .claude-plugin/ |
| Google Antigravity | Registrado bajo .gemini/antigravity/skills/code-motion-director/ |
| ChatGPT / GPTs Personalizados | Configurado mediante Instrucciones Personalizadas usando adapters/chatgpt-instructions.md |
| Google Gemini | Inyectado vía instrucción del sistema usando adapters/antigravity-gemini.md |
Estándares de Gusto y Estética
- Jerarquía visual clara: Mantén el código limpio, formateado y legible. Nunca pegues código minificado.
- Llamadas concisas: Las notas de las llamadas deben ser hechos técnicos, no exageraciones de marketing ("Espera la promesa", no "¡Característica súper genial!").
- Contraste y legibilidad: Asegúrate siempre de que el tamaño de la fuente del código sea suficiente para pantallas de teléfonos móviles (mínimo 28px en un lienzo de 1080x1920).
- Ritmo: La escritura debe sentirse natural (25–40ms por carácter). La salida del terminal debe aparecer después de que el código termine de escribirse.