naive-kun/naive-video-skill

Pipeline de Video de Talking Head

Convierte material en bruto o cortes preliminares de videos de personas hablando en un corte de trabajo aprobado, subtítulos editables, una vista previa animada y una exportación final verificada. Trata este archivo como el router y contrato compartido. Lee solo el flujo de trabajo interno y las referencias necesarias para la etapa actual.

Promesa para Principiantes

Asume que el usuario nunca ha editado con Codex.

• Haz una sola pregunta corta a la vez solo cuando no se pueda inferir la respuesta de forma segura.
• Prefiere un valor predeterminado funcional en lugar de presentar muchas opciones técnicas.
• Explica el siguiente resultado visible, no los detalles internos del renderizador.
• Introduce el corte bruto, los proveedores de transcripción o la configuración de API solo cuando el material en bruto realmente necesite esa rama.
• Explica las opciones pagas y locales con claridad, recomienda una cuando sea útil y nunca la fuerces.
• Termina cada etapa con las rutas de salida exactas y la siguiente frase que el usuario puede decir.
• Reanuda el trabajo existente en lugar de reiniciarlo.

Reglas No Negociables

1. La fuente es inmutable. Nunca sobrescribas ni edites de forma destructiva el metraje fuente proporcionado.
2. El audio principal es el reloj. No cambies el tiempo, reordenes, remuestrees ni reemplaces el audio a menos que el usuario apruebe explícitamente una estrategia de corte bruto. Después de la aprobación, el working_video derivado se convierte en el reloj descendente mientras que el original permanece inmutable.
3. La evidencia permanece legible. Nunca cubras el texto del cuerpo de capturas de pantalla, la interfaz de usuario del producto, rostros o zonas seguras marcadas por el usuario. No difumines los activos de evidencia.
4. Vista previa antes de final. Crea una vista previa oficial y espera la aprobación a menos que el usuario solicite explícitamente la exportación directa.
5. Calidad original en el final. No presentes una vista previa de baja resolución ampliada como un verdadero final de alta resolución. Usa la fuente original como base del final siempre que sea posible.
6. No interrumpas el progreso. Si un renderizado está avanzando, espera e informa del progreso. Cambia de pipeline solo después de un error real o aprobación explícita.
7. No hay datos privados en la habilidad. Las rutas locales del proyecto, nombres de medios, reglas de marca, capturas de pantalla, detalles del cliente y claves de API permanecen en el proyecto del usuario.
8. Aprende solo de comentarios explícitos. No infieras reglas de estilo permanentes del silencio o de un borrador no confirmado.
9. La tipografía es parte de la corrección. Declara y verifica la familia de fuentes, el peso real, la política de líneas de subtítulos, la alineación de línea base y el ajuste de la etiqueta más larga antes de la aprobación.
10. Los valores predeterminados públicos se mantienen neutrales en cuanto a la marca. Almacena las paletas del creador, los sistemas de tarjetas recurrentes y las reglas visuales privadas solo en el perfil local.
11. La instalación pública expone una sola habilidad. Mantén los módulos de etapa en references/workflows/; no agregues archivos SKILL.md anidados que los gestores de paquetes puedan registrar por separado.
12. Las operaciones de instalación son recuperables. Haz una copia de seguridad de una instalación existente antes de reemplazarla y archiva los destinos de desinstalación en lugar de realizar una eliminación forzada recursiva.
13. Los proveedores opcionales siguen siendo opcionales. El paquete de tomas predeterminado seleccionado es nativo de HyperFrames + GSAP. Nunca clones, instales, actualices ni requieras ShotCraft, Remotion u otro proveedor sin el consentimiento explícito del usuario. Las recetas nativas deben permanecer como una alternativa completa.

Lee references/quality-gates.md antes de trabajar en vistas previas o exportaciones.

Tabla de Rutas

Intención o frase del usuario	Ruta	Salida típica
初始化视频项目, 第一次用, start a video project	references/workflows/init.md	Estado, plan de edición, perfil de diseño
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut	references/workflows/rough-cut.md	Corte bruto no destructivo aprobado y traspaso de sincronización
抽字幕轴, 只做字幕, transcribe, 改字幕	references/workflows/captions.md	SRT, CSV, transcripción JSON
帮我设计, 换颜色风格, 规划弹窗, design	references/workflows/design.md	DISEÑO y plan de edición completo
参考这张截图设计, 按这张图的视觉语言, style reference	references/workflows/design.md rama de referencia	STYLE_REFERENCE local del proyecto
按语义匹配动效, GSAP 动效丰富一点, semantic motion	references/workflows/design.md, luego vista previa	MOTION_PLAN validado y vista previa
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference	references/workflows/design.md rama de ShotCraft	Referencias de tomas mapeadas opcionales en MOTION_PLAN
做预览, 加动效, build preview	references/workflows/preview.md	URL de vista previa oficial
出成片, 导出 4K, export final	references/workflows/export.md	Video final verificado
改这个, 恢复上一版, revise	references/workflows/revise.md	Revisión con alcance y nueva vista previa/final
进度, 到哪了, status	references/workflows/status.md	Etapa actual y siguiente acción
体检, 为什么失败, doctor	references/workflows/doctor.md	Diagnóstico de solo lectura
以后都这样, 记住这个风格, learn this	references/workflows/learn.md	Lecciones locales del proyecto confirmadas
复盘成片, 下次怎么改进, retro	references/workflows/retro.md	Retrospectiva estructurada de entrega
升级状态, 迁移, migrate	references/workflows/migrate.md	Actualización del esquema de estado

Detección de Modo

Antes de enrutar:

1. Identifica el directorio del proyecto de video del usuario, no este repositorio de habilidad.
2. Busca .naive-video-state.json.
3. Si está ausente y la tarea es más que una edición de texto de subtítulos única, carga el flujo de trabajo de inicio.
4. Si está presente, léelo junto con EDIT_PLAN.md, DESIGN.md y VIDEO_LESSONS.md solo cuando sea relevante. Usa working_video cuando esté presente; de lo contrario, usa main_video.
5. Ejecuta python3 tools/video_doctor.py --project <project_dir> cuando el estado y los archivos no coincidan.

Usa estas etapas:

inicializado -> subtítulos_listos -> diseño_listo -> vista_previa_lista
-> aprobado -> renderizando -> final_listo

Nunca marques una etapa posterior hasta que su control de calidad pase.

Pipeline Predeterminado

Cuando el usuario solicite el flujo de trabajo completo:

1. Inspecciona el medio fuente con ffprobe.
2. Inicializa el estado del proyecto y los directorios de salida seguros.
3. Pregunta si el metraje ya está cortado de forma bruta solo cuando el estado no esté claro. Si está en bruto, carga el flujo de trabajo de corte bruto opcional y requiere la aprobación de la estrategia.
4. Produce o valida archivos de subtítulos desde working_video cuando esté presente; de lo contrario, desde main_video.
5. Pregunta si deben aparecer capturas de pantalla, grabaciones, imágenes de productos, gráficos o demostraciones. Deja que el usuario elija colocación semántica, segundos exactos/anclajes de oraciones habladas o un híbrido; explica que los anclajes exactos son más precisos.
6. Normaliza la sincronización a nivel de palabra cuando esté disponible y divide el discurso en grupos lógicos orientados al espectador. No inventes precisión de palabra a partir de inicios de subtítulos completos.
7. Recopila o infiere un perfil de estilo y zonas seguras. Ofrece la coincidencia opcional de referencia de captura de pantalla para principiantes.
8. Escribe un plan de edición y un plan de movimiento semántico con cada inserción solicitada, enlace de grupo lógico y rango de tiempo.
9. Para proyectos nuevos, asigna automáticamente algunos nodos semánticos seguros al paquete nativo seleccionado inspirado en ShotCraft a menos que el usuario elija omitir. Preserva los proyectos aprobados existentes, la receta nativa y la alternativa sin conexión.
10. Para trabajos de primer uso, nuevo estilo o con mucho razonamiento, renderiza fotogramas clave estáticos representativos y resuelve problemas de composición antes de una vista previa dinámica completa.
11. Construye una vista previa de HyperFrames + GSAP usando un proxy compatible con el navegador si es necesario.
12. Ejecuta los controles de calidad de la vista previa y proporciona la URL oficial de la vista previa.
13. Espera la aprobación a menos que se le indique explícitamente omitir.
14. Renderiza superposiciones o composición final usando el video de trabajo aprobado y su reloj de audio.
15. Verifica la existencia del archivo, duración, resolución, frecuencia de cuadros y audio.
16. Registra solo los comentarios confirmados como lecciones locales del proyecto.
17. Después de la entrega, ejecuta una retrospectiva factual y promueve solo reglas explícitas y seguras para la privacidad.

Archivos del Proyecto

El flujo de trabajo de inicio crea esta memoria mínima del proyecto sin tocar el medio fuente:

<directorio_del_proyecto>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json       # grupos de razonamiento orientados al espectador y tiempos marcados
├── STYLE_REFERENCE.md       # creado solo cuando se usa una imagen de referencia
├── MOTION_PLAN.json         # creado cuando se planifica el movimiento semántico
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│   ├── rough-cut.mp4            # opcional; el medio original nunca se sobrescribe
│   ├── rough-cut-edl.json       # registro de decisiones opcional
│   ├── script-aligned.srt
│   ├── caption-table.csv
│   └── transcripts/
├── preview/
├── final/
└── qa/
    └── KEYFRAME_REVIEW.md   # revisión de composición estática antes de la vista previa dinámica

El estado son metadatos operativos, no una base de datos de medios. Mantenlo pequeño y nunca almacenes cuerpos de transcripciones, capturas de pantalla privadas o secretos en él. Consulta references/state-management.md.

Valores Predeterminados de Estilo

Si el usuario quiere velocidad y no proporciona referencia:

• Preserva la relación de aspecto de la fuente.
• Usa un sistema de tarjetas limpio y legible con un color de acento configurable.
• Usa subtítulos en negrita con énfasis moderado en palabras clave.
• Usa transformaciones y opacidad de GSAP para el movimiento.
• Coloca las tarjetas en espacios vacíos verificados.
• Reduce la densidad de movimiento mientras las capturas de pantalla o demostraciones sean visibles.
• Mantén el nivel de texto legible y alineado con la línea base; anima el componente contenedor en lugar de inclinar las etiquetas.
• Elige un número máximo explícito de líneas de subtítulos y una política de ajuste.

Pregunta por un color de acento solo si la coherencia de la marca es importante. De lo contrario, usa el valor predeterminado neutro y facilita su cambio posterior. Los principiantes pueden proporcionar opcionalmente una captura de pantalla y elegir una intensidad de referencia baja, media o alta; explica que la habilidad copia el lenguaje visual, nunca la marca o el contenido de la fuente. La densidad de movimiento es contenida, equilibrada o enérgica. Consulta references/style-onboarding.md.

Las recetas detalladas de GSAP y las asignaciones semánticas se encuentran en references/motion-recipes.md. El tiempo de ejecución y la selección de complementos se encuentran en references/gsap-runtime.md. Las reglas de extracción de capturas de pantalla y anticopia se encuentran en references/style-reference-workflow.md. Las opciones de tiempo de los activos se encuentran en references/asset-onboarding.md. Cárgalos solo para la rama de diseño correspondiente.

Las reglas de descubrimiento y adaptación de ShotCraft se encuentran en references/shotcraft-integration.md; el paquete nativo para principiantes se encuentra en references/shotcraft-default-pack.md. Cárgalos para proyectos nuevos automáticos, tarjetas con nombre o solicitudes de tomas cinematográficas. Nunca instales un proveedor en silencio.

La sincronización a nivel de palabra, los grupos lógicos orientados al espectador y el comportamiento de acumulación/salida se encuentran en references/content-logic-workflow.md. Cárgalo después de los subtítulos y antes del diseño semántico.

La tipografía, la geometría de los componentes, las notificaciones de vidrio y la adaptación de enfoque/tipo/división segura para la búsqueda se encuentran en references/visual-quality-rules.md. Cárgalo para cada tarea de diseño o vista previa.

Contrato de Autoiteración

La autoiteración significa mejorar el flujo de trabajo del usuario actual sin filtrarlo a los valores predeterminados públicos.

Clasifica los comentarios en un ámbito:

• project: se aplica solo a este video.
• profile: se aplica a los videos futuros de este usuario; escríbelo solo después de una confirmación explícita.
• product: una mejora general de confiabilidad segura para la privacidad; propónselo al mantenedor de la habilidad por separado.

Registra los comentarios del perfil en VIDEO_LESSONS.md con las palabras del usuario, la regla confirmada y la etapa afectada.