Video demo
Un video aquí es primero evidencia y luego película. Cada fotograma muestra algo real, etiquetado por lo que es, legible en un teléfono y temporizado para que el resultado se vea antes del detalle.
Esto es un modelo, no una habilidad instalada. Describe un método que ha producido películas reales, pero no incluye ningún renderizador, grabador o verificador. Usa las herramientas que tengas; extensiones describe las que vale la pena construir. Resuelve las rutas de referencia relativas a esta carpeta de habilidad.
1. Elige el modo, luego escribe el resumen
| Modo | Uso | Duración | Estructura |
|---|---|---|---|
| completado | un cambio fusionado o corrección de error | 15–30 s | tarjeta de introducción → el cambio en la UI real → tarjeta final con el issue o PR |
| sprint-demo | una revisión de sprint para partes interesadas | 2–4 min | objetivo del sprint → 3–5 puntos completados, los más valiosos primero → no completado → siguiente |
| anteriormente | un episodio de un proyecto en curso | 1–3 min | último hilo abierto → partes: pregunta → resultado → qué cambió → siguiente hilo |
| investigación | un experimento, spike o noche de investigación | 1–2.5 min | pregunta → método en una imagen → resultado con su denominador → sorpresas → decisión |
| lanzamiento | qué se envió y qué sigue | 1–2.5 min | estructura de resumen con fusionado → lanzado → staging → estados de producción |
| concepto | una película conceptual, maqueta o propuesta | 45–95 s | gancho de resultado → un ejemplo práctico → prueba → límite honesto → recompensa |
| tutorial | cómo hacer una tarea | 30–90 s | resultado final → pasos en la UI real → resultado final de nuevo |
| repro | un informe de error | 10–30 s | entorno → pasos → el fallo, retenido → resultado esperado en texto |
Detalle por modo: modos. Retrospectivas, aniversarios y despedidas son la extensión de viaje en extensiones.
Antes de cualquier captura, escribe BRIEF.md en la carpeta de la película: modo, audiencia, la única conclusión, ancho de visualización (por defecto: un teléfono, 844 px en horizontal y 390 px en vertical para el reproductor), perfil de marca, la clase de evidencia de cada escena, fecha límite y resultados. Pregunta solo por lo que no puedas inferir de la solicitud o las fuentes.
2. No negociables
- Evidencia antes que arte. Muestra UI real, resultados guardados reales y páginas fuente reales. Nunca pintes un estado que no ocurrió, inventes un número, o impliques velocidad, lanzamiento o uso en producción. Cada hecho en pantalla tiene una fila en la tabla de afirmaciones antes de que se construya su escena (evidencia).
- Etiqueta lo que es, en pantalla, todo el tiempo. Una barra fuera de la cámara indica la clase de evidencia:
Construcción local,Demo de concepto · datos de muestra,Respuesta grabada · repetida,Staging,Producción. Los conceptos y maquetas nunca se hacen pasar por funciones enviadas. - Resultado primero. La conclusión y un número destacado o resultado visible aparecen en aproximadamente 1.5 s del inicio de una escena y permanecen hasta el corte. Duración de la escena ≥ 1 s + palabras ÷ 3 + 1.5 s de espera (ritmo).
- Legible en un teléfono. Texto principal ≥ 80 px a 1080p; cualquier cosa que el espectador deba leer ≥ 36 px. Demasiadas palabras: recorta palabras o recompón, nunca reduzcas.
- UI nítida. Captura evidencia a 2× de densidad y muéstrala a ≥ 1.0 de escala o amplía. Nunca sobredimensiones una pantalla densa de 1080p y la llames primer plano.
- Solo marca aprobada. La marca personal o de empresa proviene de un perfil de marca y los activos aprobados de esa marca (marca). Nunca redibujes, recoloques o aproximes un logotipo.
- Sonido con licencia. La música y los efectos necesitan una licencia verificada y el crédito que requiere.
- Completado significa verificado. Informa las comprobaciones técnicas, fotogramas inspeccionados, reproducción a velocidad y escucha por separado. La aceptación del solicitante es su propio estado (revisión).
3. Ciclo de trabajo
- Resumen y afirmaciones.
BRIEF.mdy la tabla de afirmaciones. Para películas con números, haz que un revisor independiente, idealmente de una familia de modelos diferente o una persona, verifique el texto final en pantalla, incluido el texto dentro de capturas de pantalla, antes del renderizado completo. - Guion gráfico en palabras. Una línea por escena: ventana de tiempo, línea principal, imagen, etiqueta de evidencia, señal de sonido, cómo transiciona. Elige los 3–5 tipos de transición que usa la película y qué causa cada uno.
- Captura (captura). Flujos de navegador scriptados para metraje interactivo, captura de fotogramas con reloj falso para la animación de una página, capturas de pantalla de elementos a 2× para imágenes fijas.
- Composición (compositor). Los modos cortos se adaptan a un compositor guiado por especificaciones; los modos más largos se adaptan a una composición hecha a mano en una línea de tiempo pausada con escenas en una cuadrícula de barras.
- Inspección antes del renderizado. Captura el primer momento legible de cada escena, el punto medio, la espera final y ambos lados de cada corte. Corrige colisiones, texto recortado, fotogramas vacíos y cualquier cosa que un desconocido no pueda leer.
- Renderiza, mezcla, verifica. Renderiza, codifica, mezcla música y efectos, ejecuta las comprobaciones técnicas, luego lee la hoja de contactos, las tiras de corte y las hojas de teléfono tú mismo (movimiento y sonido).
- Entrega. Copias en silencio, con música y web, más un póster, el crédito de música junto al reproductor, y un
REVIEW.md: qué se midió, qué solo se observó y la toma más débil.
4. Cadena de herramientas
Cualquier renderizador que produzca fotogramas de manera determinista servirá. HyperFrames (Apache-2.0) y un script de captura de fotogramas canalizado a FFmpeg renderizan composiciones HTML directamente. Remotion (React; revisa primero los términos de licencia de la empresa) y Motion Canvas (escenas en TypeScript) tienen sus propios modelos de escena; el contrato de composición en compositor se traduce a ellos. La automatización del navegador como Playwright impulsa la captura. FFmpeg codifica, mezcla y mide. Fija las versiones del renderizador y desactiva la telemetría donde se ofrezca.
5. Autoridad
Hacer una película autoriza la captura local, la composición y la verificación. No autoriza subidas, mensajes, comentarios en PR o issues, cambios en el producto o publicación. Usa datos de muestra o ficticios aprobados; nunca muestres nombres de clientes, clientes o personal sin aprobación, y nunca hagas zoom en una identidad con sesión iniciada.
Referencias
| Necesidad | Lee |
|---|---|
| Perfiles de modo y estructuras narrativas | modos |
| Afirmaciones, etiquetas, estados, verificación de hechos | evidencia |
| Tiempo de lectura, tamaños de texto, anchos de teléfono | ritmo y teléfono |
| Movimiento, transiciones, música y efectos | movimiento y sonido |
| Perfiles de marca personal y de empresa | marca |
| Técnicas y trampas de captura | captura |
| Especificación de video completado y contrato de composición | compositor |
| Etapas de revisión y sugerencias de entrega | revisión y entrega |
| Grabador, verificadores, resúmenes desde una línea de tiempo, películas de viaje | extensiones |