yomage-ai/ai-video-director-skill

Diretor de Vídeo IA

Responda no idioma do usuário. Suporta Chinês Simplificado e Inglês. Realize configuração, verificação, transcrição, conversão, renderização e verificação; peça apenas decisões ou ações que o Agente não possa tomar em nome do usuário. Reutilize autorizações existentes.

Use o idioma atual do usuário. O Agente realiza instalação, verificação do ambiente, transcrição, conversão, renderização e aceitação; conteúdo, corte bruto, direção audiovisual geral e versão final são confirmados pelo usuário, sem perguntar novamente por autorizações já existentes.

Escopo / 适用范围

O percurso de produção é a filmagem gravada com apresentador (talking-head), incluindo filmagens de demonstração de tela com a câmera embutida. Inspecione a filmagem nivelada antes de prometer reposicionar a pessoa: camadas independentes exigem fontes separadas ou uma reconstrução explicitamente revisada. Não exija gravações separadas quando a tentativa atual usar explicitamente uma fonte nivelada.

A produção de apresentador real e demonstração de tela é o percurso atual. Quando a tela e a câmera já estão gravadas em uma única imagem, verifique o material primeiro, não prometa que pode mover a pessoa sem perdas; quando esta rodada usar explicitamente uma gravação de tela única, não force a regravação de faixas separadas.

A produção de avatar digital/humano digital está pausada. Nunca use SadTalker ou o legado ai-auto-editing-director. Uma amostra de voz curta explicitamente autorizada usa voice-clone.md; isso não autoriza substituição completa de voz. A adoção de novas ferramentas ou modelos usa tool-governance.md.

Avatares digitais estão pausados; o Skill antigo de diretor e o SadTalker estão desativados. Amostras de voz, pagamentos, contas, identidade e direitos de material usam seus respectivos escopos já confirmados, sem expandir a autorização.

Iniciar ou Continuar / 开始或续接

1. Resolva o diretório real do Skill e leia dependency-setup.md. O Agente executa sh scripts/bootstrap.sh --stage intake --apply no macOS/Linux ou scripts/bootstrap.ps1 --stage intake --apply no PowerShell no Windows. Reutilize dependências saudáveis; instale as que faltam. Uma instalação de pasta do Skill não tem hook de dependência universal: faça isso no primeiro uso, mesmo que a pasta já exista. Execute doctor após reparos, usando o Node resolvido. Os recibos de configuração são evidências de instalação local, não conectividade do editor. Mantenha o primeiro cartão de conteúdo rápido; prepare ferramentas brutas antes da execução bruta e o renderizador selecionado antes do trabalho fino.
2. Mantenha projetos e mídia privada fora deste repositório. Crie um projeto com director.mjs init-project ou carregue seu estado existente. Nunca sobrescreva mídia, linhas do tempo ou componentes aprovados; crie uma nova versão e retenha a antiga até que a substituição passe.
3. Carregue o estilo Xiaoxiong integrado descrito em xiaoxiong-public-style.md. Seus padrões de áudio, legenda, cor, paleta, layout e ajuste de conteúdo funcionam sem um perfil privado. Leia os padrões efetivos e substituições opcionais com memory.mjs show --stage intake --include-candidates. Use --stage rough|fine|release, --key, --style e substituições de projeto conforme necessário. Quando o uso da identidade Xiaoxiong for selecionado, carregue $xiaoxiong-ip e passe seu diretório resolvido com --identity-skill; caso contrário, nenhum personagem ou encerramento Xiaoxiong é inserido. Prepare a fonte exata e os ativos de referência neutros com prepare-style-assets.mjs --out <external-project>/assets/xiaoxiong-style. O histórico é opcional. Feedback pendente é uma proposta, não um padrão efetivo. Siga memory-and-feedback.md.
4. Para um projeto novo, leia workflow.md. Leia apenas as referências do estágio atual abaixo; consulte as seções de contrato da máquina com director.mjs contract --section roughCut (ou bRollContinuity, finishingPass) quando necessário. Não carregue todo o contrato ou todas as referências por padrão.

Por padrão, traga os estilos públicos de legenda, loudness, paleta de cores e imagem do Xiaoxiong; máquinas novas não precisam de perfil pessoal antigo. A imagem e o encerramento do Xiaoxiong só carregam xiaoxiong-ip. Verifique a instalação real, localização do projeto e preferências atuais pela primeira vez; ao continuar, reutilize resultados de ambiente inalterados. Material privado não entra no repositório público. Leia as especificações e preferências efetivas por estágio; histórico e feedback a testar não podem substituir automaticamente a decisão atual.

No primeiro uso, o Agente deve completar as dependências, não apenas executar Doctor e entregar a lista de instalação ao usuário. A entrada reutilizará ou baixará e verificará Node 22+, completará dependências de script e FFmpeg; antes do corte bruto, execute setup.mjs --stage rough --apply --codex <caminho absoluto da CLI integrada do host de desktop atual> para completar o plugin ChatCut oficial, depois verifique a conexão real e a transcrição. Antes da edição fina, execute setup.mjs --stage fine --apply, reutilize ou instale versões fixas do HyperFrames, Skill de criação complementar e navegador de renderização; adicione --renderer cutout apenas para keying. O Agente deve continuar processando agentActions no recibo, completando a verificação real da amostra; apenas login, o host não permite recarga automática de ferramentas, permissões do sistema ou novas taxas exigem participação do usuário. Não trate localReady como capaz de editar, nem use falta de modelo opcional para bloquear a primeira análise.

Roteamento de Estágio / 阶段路由

Estágio	Ação e referência obrigatória
Conteúdo	Use um manuscrito confiável e uma sonda de mídia local para um primeiro cartão rápido. Siga first-approval-and-style-gates.md. Trave a alegação, evidência, cortes pretendidos e restrições significativas; a contagem de suporte segue o conteúdo e a duração. Adie estilo não aprovado. / Primeiro, dê ao usuário conteúdo legível e um plano de corte bruto; quando houver um manuscrito confiável, não faça processamento pesado antecipadamente.
Bruto	Antes de importar ou retomar mídia, leia chatcut-media-recovery.md: distinga conexão do host, upload pendente e reprodução real; preserve a edição e use recuperação limitada. Em seguida, leia production-standard.md e dialogue-join-audit.md. Compare takes com prioridade de qualidade, verifique cada junção real e todas as classes de defeitos repetidos, preserve inícios/finais de palavras, revise pausas e ritmo inicial/médio/final. Normalize cor e diálogo uma vez usando processamento explícito. / Antes de importar, verifique a rota do material; falhas de upload seguem o processo de recuperação limitada, sem repetições infinitas ou perda de edições existentes. Verifique todas as junções, respirações e ritmo de fala.
Transição	Leia chatcut-handoff.md. Exporte o timing revisado para EDL canônico; retiming constante explícito, EQ de vídeo e processamento de áudio usam um plano de processamento baseado em hash. Efeitos XML não suportados devem falhar; use uma derivação de qualidade de fonte revisada para processamento complexo. / Efeitos não suportados não podem ser descartados silenciosamente.
Aprovação do Bruto	Renderize o A-roll exato, prepare janelas de revisão com prepare-rough-review.mjs, realmente assista/ouça e execute audit-rough-cut-review.mjs. A revisão vincula o EDL real, fontes, render e janelas. A aprovação do usuário segue essa revisão. Para escopo apenas de corte bruto, use o ramo de entrega abaixo e termine aqui. / Gerar janelas automaticamente não equivale a já ter ouvido e revisado. Tarefas apenas de corte bruto entregam após esta confirmação.
Estilo / Amostra Geral	Leia fine-edit-direction.md e curated-style-library.md. Referência aprovada exata → referência explícita do usuário → candidatos curados → dynamic-style-adaptation.md. Recomende uma amostra audiovisual completa de 6 a 12 segundos; inclua legendas, evidências, apresentador e decisões de BGM/SFX juntos. Execute audit-fine-edit-direction.mjs. / O usuário confirma toda a direção audiovisual; com referência existente, revise apenas as diferenças reais.
Edição Fina	Roteie por tomada usando tool-selection.md. Leia as referências condicionais abaixo. Execute verificações direcionadas de borda arriscada, legenda, layout, matte, som e cor antes de uma renderização completa. / Escolha a ferramenta adequada para cada tomada; valide localmente primeiro, depois o filme inteiro.
Lançamento	Use release-render-operations.md para saída pesada. Aplique um preset de host aprovado correspondente como um pacote completo, preserve um trabalho pesado, monitore a memória e mude de estratégia após falha. Verifique e decodifique completamente o arquivo final exato. / A aprovação do proxy não substitui a verificação de resolução final.
Entrega	Use o gate do estágio e audit-delivery-manifest.mjs; entregue o mestre, projeto editável, timing, legendas, direitos, QA e registros de aprendizado. Leia platform-release-and-publish-package.md e execute audit-publish-package.mjs apenas quando a publicação estiver no escopo. / Entregue arquivos abertáveis localmente e restrições claras.

Referências Condicionais / 按需读取

• Evidência de UI: evidence-state-roi-audit.md. Trave a navegação exata e ROI semântico; use dados de demonstração isolados e uma lista de permissão de módulo visível antes da captura. / Evidência de interface: primeiro bloqueie o estado, região semântica e lista de permissão de privacidade.
• Cobertura simultânea do apresentador e A/B: presenter-coverage-modes.md, depois audit-coverage-boundaries.mjs. Trate B-base-A-cutout independentemente de PiP; preserve áudio canônico e teste alpha em movimento. / Janela do apresentador, keying e tela dividida são julgados separadamente; os pontos de corte de layout são baseados em quadros inteiros.
• Legendas: caption-semantic-pagination.md, depois audit-caption-pages.mjs. Formato curto retrato começa com uma linha semântica; legibilidade ou referências aprovadas exatas podem justificar duas linhas. / Uma linha para retrato é uma recomendação substituível, não uma limitação absoluta.
• Layout seguro para retrato: portrait-talking-head-safe-layout.md, incluindo layout.portrait-talking-head.safe-v1 quando corresponder à série aprovada. / Os parâmetros de legenda redimensionável e paleta de cores do estilo Xiaoxiong já estão integrados; a posição real é verificada com conteúdo e plataforma.
• Progresso semântico: semantic-progress-rmcu.md, rmcu.semantic-progress.v1. Use apenas quando ajudar na navegação. Rótulos longos inativos usam elipse; estouro ativo segue o contrato do componente. / Barra de progresso usada conforme necessário para o conteúdo.
• Reutilização de movimento de código: code-motion-components.md; classifique o componente como G, P, T, A ou X e separe o mecanismo geral, adaptador privado e instância do projeto. / Mecanismo público, adaptador privado e parâmetros de peça única são separados.
• ChatCut: siga as habilidades básicas, talking-head, transcrição, verificação e exportação do seu host ativo conforme aplicável. A criação HyperFrames lê $hyperframes; um renderizador possui uma tomada. / Use as ferramentas suportadas pelo host atual; não adivinhe a conectividade com base no cache do plugin.

Gates Executáveis / 可执行门禁

Leia execution-and-evidence.md antes da primeira renderização. Use stage.mjs check|run pipeline.json rough-render|fine-render|deliver como caminho de execução normal. O candidato A-roll existe necessariamente antes de sua própria revisão de corte bruto; a renderização fina requer o corte bruto aprovado e a amostra de estilo. A entrega vincula o arquivo final exato e reverifica os hashes de dependência.

Use a entrada de estágio unificada. O candidato de corte bruto é renderizado primeiro, depois ouvido/revisado; a edição fina formal deve passar pelos gates de corte bruto e amostra de estilo; a entrega deve corresponder ao arquivo final realmente aprovado. Mudanças upstream invalidam evidências antigas. Este mecanismo restringe o fluxo de trabalho normal, não afirma ser uma prevenção de bypass em nível de sistema operacional.

Para uma solicitação apenas de corte bruto, defina outputScope: "rough-cut", vincule roughDelivery.editableProject e roughDelivery.captions, depois execute stage.mjs run pipeline.json deliver após a aprovação do corte bruto. Entregue A-roll aprovado, EDL, projeto de timing editável e legendas. Pule estilo, renderização fina e publicação; nenhuma aprovação final adicional do mestre é necessária para o mesmo arquivo de corte bruto aprovado. Veja execution-and-evidence.md.

Apenas corte bruto: o Agente define o escopo acima e vincula o projeto editável e legendas; após a aprovação do corte bruto, executa diretamente a entrega. O mesmo arquivo de corte bruto não requer re-confirmação; não requer amostra de estilo, edição fina ou pacote de publicação.

Nunca marque um arquivo como revisado a partir de uma chamada de ferramenta bem-sucedida, uma transcrição ASR, um booleano marcado ou uma imagem atraente. A falta de capacidade auditiva ou visual deve permanecer um item explicitamente não verificado. O Agente registra a audição real e evidências renderizadas; a aprovação do usuário é preservada com sua fonte, timestamp e hash do artefato.

Sucesso de ferramenta, existência de transcrição, campo marcado ou uma imagem bonita não provam qualidade aprovada. O Agente deve deixar o método de verificação real e a versão correspondente; quando faltar capacidade audiovisual, marque honestamente como não verificado.

Feedback e Verificação / 反馈与验证

Use interaction.md para manter quatro decisões normais do usuário compactas: conteúdo, corte bruto, estilo audiovisual e mestre final. Mescle decisões de legenda/música/apresentador na amostra de estilo; herde autorização existente. Siga memory-and-feedback.md para regras públicas, estilos curados, preferências privadas e lições específicas do projeto.

Priorize manter quatro pontos claros de confirmação, sem dividir cada detalhe de estilo em aprovações repetidas. Decisões já adotadas não são perguntadas novamente; o estilo Xiaoxiong já autorizado compartilhado é mantido com a versão pública do Skill; a imagem pessoal entra no IP Skill, outras substituições de usuário e experiências de peça única são salvas separadamente.

Acompanhe o próximo projeto real independente com analysis/trial-metrics.json: latência do primeiro cartão, revisões, defeitos repetidos, contagem de renderizações, tempo ativo e recursos medidos. Resultados de teste não são prova de qualidade de edição estável. Siga a decisão de promoção registrada atual; publicar código-fonte não marca uma tentativa de projeto real pendente como concluída.

A próxima peça real independente registra tempo de espera, retrabalho, defeitos repetidos, número de re-renderizações e curva de recursos. Código aprovado não equivale a produto estável; siga a decisão de promoção atual; enviar código-fonte não pode alterar uma verificação de peça real pendente para concluída.