naive-kun/naive-video-skill

Pipeline de Vídeo de Cabeça Falante

Transforme gravações brutas ou cortadas de cabeça falante em um corte de trabalho aprovado, legendas editáveis, uma prévia com pacote de animação e uma exportação final verificada. Trate este arquivo como o roteador e o contrato compartilhado. Leia apenas o workflow interno roteado e as referências necessárias para o estágio atual.

Promessa para Iniciantes

Presuma que o usuário nunca editou com Codex.

• Faça uma pergunta curta de cada vez, apenas quando a resposta não puder ser inferida com segurança.
• Prefira um padrão funcional a apresentar muitas escolhas técnicas.
• Explique o próximo resultado visível, não os detalhes internos do renderizador.
• Introduza corte bruto, provedores de transcrição ou configuração de API apenas quando a filmagem bruta realmente precisar desse caminho.
• Explique opções pagas e locais de forma clara, recomende uma quando útil, e nunca force.
• Termine cada estágio com os caminhos de saída exatos e a próxima frase que o usuário pode dizer.
• Retome o trabalho existente em vez de recomeçá-lo.

Regras Inegociáveis

1. A fonte é imutável. Nunca sobrescreva ou edite destrutivamente a mídia fonte fornecida.
2. O áudio principal é o relógio. Não re-temporalize, reordene, re-sample ou substitua-o, a menos que o usuário aprove explicitamente uma estratégia de corte bruto. Após a aprovação, o working_video derivado torna-se o relógio downstream, enquanto o original permanece imutável.
3. A evidência permanece legível. Nunca cubra texto do corpo da captura de tela, UI do produto, rostos ou zonas seguras marcadas pelo usuário. Não desfoque ativos de evidência.
4. Prévia antes do final. Construa uma prévia oficial e aguarde aprovação, a menos que o usuário solicite explicitamente exportação direta.
5. Final com qualidade original. Não apresente uma prévia upscaled de baixa resolução como um final verdadeiro de alta resolução. Use a fonte original como base final sempre que possível.
6. Não interrompa o progresso. Se uma renderização estiver avançando, aguarde e reporte o progresso. Altere pipelines apenas após um erro real ou aprovação explícita.
7. Nenhum dado privado na skill. Caminhos locais do projeto, nomes de mídia, regras de marca, capturas de tela, detalhes do cliente e chaves de API permanecem no projeto do usuário.
8. Aprenda apenas com feedback explícito. Não infira regras de estilo permanentes a partir de silêncio ou um rascunho não confirmado.
9. Tipografia faz parte da correção. Declare e verifique a família da fonte, peso real, política de linhas de legenda, alinhamento de linha de base e ajuste do rótulo mais longo antes da aprovação.
10. Padrões públicos permanecem neutros em relação à marca. Armazene paletas do criador, sistemas de cartão recorrentes e regras visuais privadas apenas no perfil local.
11. Instalação pública expõe uma Skill. Mantenha módulos de estágio em references/workflows/; não adicione arquivos SKILL.md aninhados que gerenciadores de pacotes possam registrar separadamente.
12. Operações de instalação são recuperáveis. Faça backup de uma instalação existente antes da substituição e arquive alvos de desinstalação em vez de realizar exclusão forçada recursiva.
13. Provedores opcionais permanecem opcionais. O pacote de padrão curado é HyperFrames + GSAP nativo. Nunca clone, instale, atualize ou exija ShotCraft, Remotion ou outro provedor sem consentimento explícito do usuário. Receitas nativas devem permanecer uma alternativa completa.

Leia references/quality-gates.md antes de trabalhar em prévia ou exportação.

Tabela de Rotas

Intenção ou frase do usuário	Rota	Saída típica
初始化视频项目, 第一次用, start a video project	references/workflows/init.md	Estado, plano de edição, perfil de design
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut	references/workflows/rough-cut.md	Corte bruto não destrutivo aprovado e handoff de timing
抽字幕轴, 只做字幕, transcribe, 改字幕	references/workflows/captions.md	SRT, CSV, transcript JSON
帮我设计, 换颜色风格, 规划弹窗, design	references/workflows/design.md	DESIGN e plano de edição completo
参考这张截图设计, 按这张图的视觉语言, style reference	references/workflows/design.md branch de referência	STYLE_REFERENCE local do projeto
按语义匹配动效, GSAP 动效丰富一点, semantic motion	references/workflows/design.md, depois prévia	MOTION_PLAN validado e prévia
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference	references/workflows/design.md branch ShotCraft	Referências de shot mapeadas opcionais no MOTION_PLAN
做预览, 加动效, build preview	references/workflows/preview.md	URL de prévia oficial
出成片, 导出 4K, export final	references/workflows/export.md	Vídeo final verificado
改这个, 恢复上一版, revise	references/workflows/revise.md	Revisão escopada e nova prévia/final
进度, 到哪了, status	references/workflows/status.md	Estágio atual e próxima ação
体检, 为什么失败, doctor	references/workflows/doctor.md	Diagnóstico somente leitura
以后都这样, 记住这个风格, learn this	references/workflows/learn.md	Lições locais do projeto confirmadas
复盘成片, 下次怎么改进, retro	references/workflows/retro.md	Retrospectiva de entrega estruturada
升级状态, 迁移, migrate	references/workflows/migrate.md	Atualização de esquema de estado

Detecção de Modo

Antes de rotear:

1. Identifique o diretório do projeto de vídeo do usuário, não este repositório de skill.
2. Procure por .naive-video-state.json.
3. Se ausente e a tarefa for mais do que uma edição de texto de legenda avulsa, carregue o workflow de init.
4. Se presente, leia-o mais EDIT_PLAN.md, DESIGN.md e VIDEO_LESSONS.md apenas quando relevante. Use working_video quando presente; caso contrário, use main_video.
5. Execute python3 tools/video_doctor.py --project <project_dir> quando o estado e os arquivos discordarem.

Use estes estágios:

initialized -> captions_ready -> design_ready -> preview_ready
-> approved -> rendering -> final_ready

Nunca marque um estágio posterior até que seu gate de qualidade passe.

Pipeline Padrão

Quando o usuário solicitar o workflow completo:

1. Inspecione a mídia fonte com ffprobe.
2. Inicialize o estado do projeto e diretórios de saída seguros.
3. Pergunte se a filmagem já está cortada apenas quando esse status não estiver claro. Se estiver bruta, carregue o workflow opcional de corte bruto e exija aprovação da estratégia.
4. Produza ou valide arquivos de legenda a partir de working_video quando presente, caso contrário main_video.
5. Pergunte se capturas de tela, gravações, imagens de produto, gráficos ou demonstrações devem aparecer. Deixe o usuário escolher posicionamento semântico, âncoras exatas de segundo/frase falada, ou um híbrido; explique que âncoras exatas são mais precisas.
6. Normalize o timing de nível de palavra quando disponível e divida a fala em grupos lógicos voltados para o espectador. Não finja precisão de palavra a partir de inícios de legenda inteira.
7. Colete ou infira um perfil de estilo e zonas seguras. Ofereça correspondência opcional de referência de captura de tela para iniciantes.
8. Escreva um plano de edição e um plano de movimento semântico com cada inserção solicitada, link de grupo lógico e intervalo de tempo.
9. Para novos projetos, mapeie automaticamente alguns nós semânticos seguros para o pacote nativo inspirado no ShotCraft curado, a menos que o usuário escolha skip. Preserve projetos aprovados existentes, a receita nativa e o fallback offline.
10. Para trabalhos de primeiro uso, novo estilo ou com raciocínio pesado, renderize keyframes estáticos representativos e resolva problemas de composição antes de uma prévia dinâmica completa.
11. Construa uma prévia HyperFrames + GSAP usando um proxy compatível com navegador, se necessário.
12. Execute gates de qualidade de prévia e forneça a URL de prévia oficial.
13. Aguarde aprovação, a menos que explicitamente instruído a pular.
14. Renderize overlays ou composição final usando o vídeo de trabalho aprovado e seu relógio de áudio.
15. Verifique existência do arquivo, duração, resolução, taxa de quadros e áudio.
16. Registre apenas feedback confirmado como lições locais do projeto.
17. Após a entrega, execute uma retrospectiva factual e promova apenas regras explícitas e seguras para privacidade.

Arquivos do Projeto

O workflow de init cria esta memória mínima do projeto sem tocar na mídia fonte:

<project_dir>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json       # grupos de raciocínio voltados para o espectador e beats temporizados
├── STYLE_REFERENCE.md       # criado apenas quando uma imagem de referência é usada
├── MOTION_PLAN.json         # criado quando o movimento semântico é planejado
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│   ├── rough-cut.mp4            # opcional; a mídia original nunca é sobrescrita
│   ├── rough-cut-edl.json       # registro de decisão opcional
│   ├── script-aligned.srt
│   ├── caption-table.csv
│   └── transcripts/
├── preview/
├── final/
└── qa/
    └── KEYFRAME_REVIEW.md   # revisão de composição estática antes da prévia dinâmica

O estado são metadados operacionais, não um banco de dados de mídia. Mantenha-o pequeno e nunca armazene corpos de transcrição, capturas de tela privadas ou segredos nele. Veja references/state-management.md.

Padrões de Estilo

Se o usuário quiser velocidade e não der referência:

• Preserve a proporção de aspecto da fonte.
• Use um sistema de cartão limpo e legível com uma cor de destaque configurável.
• Use legendas em negrito com ênfase moderada em palavras-chave.
• Use transformações GSAP e opacidade para movimento.
• Coloque cartões em espaço vazio verificado.
• Reduza a densidade de movimento enquanto capturas de tela ou demonstrações estiverem visíveis.
• Mantenha o nível de texto legível e alinhado à linha de base; anime o componente contêiner em vez de inclinar rótulos.
• Escolha uma contagem máxima explícita de linhas de legenda e política de quebra.

Pergunte por uma cor de destaque apenas se a consistência da marca for importante. Caso contrário, use o preset neutro e torne fácil alterá-lo depois. Iniciantes podem opcionalmente fornecer uma captura de tela e escolher força de referência baixa, média ou alta; explique que a skill copia a linguagem visual, nunca a marca ou o conteúdo da fonte. A densidade de movimento é contida, equilibrada ou energética. Veja references/style-onboarding.md.

Receitas GSAP detalhadas e mapeamentos semânticos estão em references/motion-recipes.md. Seleção de runtime e plugin estão em references/gsap-runtime.md. Regras de extração de captura de tela e anti-cópia estão em references/style-reference-workflow.md. Escolhas de timing de ativos estão em references/asset-onboarding.md. Carregue-os apenas para o branch de design correspondente.

Regras de descoberta e adaptação do ShotCraft estão em references/shotcraft-integration.md; o pacote nativo para iniciantes está em references/shotcraft-default-pack.md. Carregue-os para novos projetos automáticos, cartões nomeados ou solicitações de shot cinematográfico. Nunca instale um provedor silenciosamente.

Timing de nível de palavra, grupos lógicos voltados para o espectador e comportamento de acúmulo/saída estão em references/content-logic-workflow.md. Carregue-o após legendas e antes do design semântico.

Tipografia, geometria de componentes, notificações glass e adaptação seek-safe de foco/tipo/divisão estão em references/visual-quality-rules.md. Carregue-o para cada tarefa de design ou prévia.

Contrato de Auto-Iteração

Auto-iteração significa melhorar o workflow do usuário atual sem vazá-lo para os padrões públicos.

Classifique o feedback em um escopo:

• project: aplica-se apenas a este vídeo.
• profile: aplica-se a vídeos futuros deste usuário; escreva-o apenas após confirmação explícita.
• product: uma melhoria de confiabilidade geral, segura para privacidade; proponha-a ao mantenedor da skill separadamente.

Registre feedback de perfil em VIDEO_LESSONS.md com as palavras do usuário, a regra confirmada e o afetado.