O que takewright faz?
O Takewright transforma uma ideia em um vídeo finalizado: planejar → verificar → gerar → revisar → editar. Claude é o diretor; um provedor (nuvem, GPU local ou o próprio aplicativo web do usuário) renderiza.
Responda no idioma do usuário. Os prompts enviados aos modelos são em inglês, a menos que o modelo ou a cena exija outro idioma (por exemplo, diálogo em chinês em um modelo nativo chinês).
Prioridades (nesta ordem)
- Qualidade na primeira tentativa. Um take inutilizável / 废片 desperdiça mais dinheiro e tempo do que qualquer outra coisa. Nunca corte regras técnicas ou verificações para economizar tokens.
- Economia de créditos e tempo. Estime antes de cada tarefa paga; imagem antes de vídeo; rascunho antes do final; corrija na edição antes de regerar.
- Economia de tokens. Leia apenas os arquivos que a etapa atual precisa (mapeamento abaixo). Um cartão de confirmação, não pergunta por pergunta.
Nunca prenda o usuário: todo modelo e capacidade permanece disponível; padrões são sugestões; parâmetros explícitos do usuário vencem (ainda assim, estime e confirme).
Regra de manutenção: edições futuras podem adicionar ou refinar regras, mas não devem remover limites de modelo, regras de comando, verificações de qualidade ou orientações estéticas, a menos que estejam comprovadamente erradas ou substituídas por algo melhor.
Mapeamento de arquivos — carregar sob demanda
| Quando | Ler |
|---|---|
Ainda não existe ~/.takewright/config.json, ou o usuário pede para configurar/trocar de provedor | setup/wizard.md (redireciona para um provedor ou arquivo local) |
| Gerando com um provedor | o arquivo desse provedor em setup/providers/ ou setup/local.md (uma vez por sessão) |
| Planejando qualquer cena | craft/preflight.md e craft/prompting.md |
| Uma imagem de referência ou foto está envolvida | craft/image-to-video.md |
| Visual, estilo, iluminação, "deixar premium/cinematográfico" | craft/aesthetics.md |
| Um take está fraco, quebrado ou rejeitado | craft/troubleshoot.md |
| Revisando um take ou entregando | craft/qc.md |
| Gênero se encaixa (apenas o que corresponde) | genres/product-ad.md, genres/architecture.md, genres/short-video.md, genres/short-drama.md, genres/explainer.md |
| Juntar clipes, legendas, música, proporções, capa | assembly/editing.md (+ scripts/assemble.py) |
Os caminhos são relativos à pasta desta skill. Scripts precisam de Python 3.8+ e ffmpeg; execute-os como python <diretório-da-skill>/scripts/<nome>.py (no Windows, tente python, depois py, depois python3).
Etapa 0 — Configuração (silenciosa se já feita)
Leia a configuração global ~/.takewright/config.json (Windows: %USERPROFILE%\.takewright\config.json), depois a configuração do projeto ./.takewright/config.json, se existir (valores do projeto substituem os globais). Se nenhum existir, execute setup/wizard.md. A configuração nunca armazena chaves de API.
Fluxo de trabalho
1. Briefing (pergunte apenas o que importa)
Inferir plataforma, proporção, duração e gênero a partir da solicitação. Faça no máximo 1–2 perguntas em uma mensagem, apenas para coisas que mudam o resultado (por exemplo: fotos reais disponíveis? regras da marca? plataforma de destino?).
| Sinal | Sugestão padrão |
|---|---|
| TikTok / Reels / Shorts / 抖音 / 小红书 | 9:16, cenas de 3–8 s |
| YouTube / hero de site / paisagem | 16:9 |
| Postagem em feed | 1:1 ou 4:5 |
| Usuário tem fotos do assunto | imagem-para-vídeo (primeiro quadro) — melhor controle |
| Uma pessoa precisa dizer falas exatas | rota com sincronização labial (veja o arquivo do provedor) |
2. Planejar
Para qualquer coisa com mais de um clipe, escreva uma lista de cenas no idioma do usuário:
Cena 1 (0–5 s): imagem / ação / câmera / luz / som
Em seguida, um prompt em inglês por cena (craft/prompting.md). Uma ação principal e um movimento de câmera por cena.
3. Verificação de pré-voo
Execute cada cena por meio de craft/preflight.md. Corrija problemas antes de estimar. Nunca pule esta etapa, mesmo para um "teste rápido".
4. Um cartão de confirmação (antes de qualquer crédito ou renderização local longa)
Estime cada tarefa paga (o arquivo do provedor informa como), depois mostre um cartão e aguarde um sim explícito:
Pronto para gerar:
Conteúdo: {uma linha} · {N} cenas
Plano: {imagem → imagem-para-vídeo / rascunho → final / direto}
Provedor · modelo: {…} Proporção: {…} Resolução: {…} Duração: {s por cena}
Entradas: {nenhuma / primeiro quadro / N imagens de referência / vídeo de referência}
Pré-voo: {aprovado / ajustado: …}
Estimativa: rascunho {x}, final {y}, total ≈ {z} {créditos/$/minutos de GPU}
Orçamento de retake (várias cenas): ≈ {n} rascunhos por cena
Gerar? (qualquer parâmetro pode mudar)
Traduza o cartão para o idioma do usuário. Se uma estimativa não estiver disponível, diga isso e ainda pergunte. Nunca envie uma tarefa paga sem este sim. Nunca tente novamente automaticamente uma tarefa paga.
5. Gerar (caminho mais barato para um bom resultado)
- Imagem primeiro para cenas-chave: gere o quadro-chave como imagem (barato), aprove-o e depois anime-o.
- Rascunho → final onde o modelo suporta rascunhos ou resolução mais baixa: explore barato, finalize apenas takes aprovados.
- Direto apenas para cenas simples, testes rápidos ou quando solicitado.
- Fallback gratuito: fotos reais animadas com um zoom lento (
assemble.py stills) — sem créditos, sem risco de detalhes inventados. Ofereça para listagens/produtos, orçamentos apertados ou após dois takes ruins. Envie trabalhos longos de forma assíncrona e consulte em segundo plano; respeite os limites de taxa do provedor; em caso de timeout, informe ao usuário como buscar o resultado mais tarde.
Realidade do orçamento (diga uma vez para trabalhos com várias cenas): vídeo com IA é probabilístico — o mesmo prompt dá resultados diferentes. Planeje cerca de 2–3 rascunhos para uma cena simples e mais para movimentos complexos.
6. Revisar
Baixe cada resultado para ./takewright-output/{YYYY-MM-DD}/ com slug {projeto}_{cena}_{proporção}_{rascunho|final}_v{n}. Execute craft/qc.md (extração de quadros via scripts/assemble.py frames). Classifique cada take como 好 Bom / 可修 Reparável / 废片 Inutilizável. Inutilizável → craft/troubleshoot.md antes de qualquer nova tentativa.
7. Editar e entregar
Monte os takes aprovados com assembly/editing.md: juntar, legendas, narração, música, loudness, variantes de proporção, quadro de capa. Relate caminhos de arquivo, configurações, seeds e créditos cobrados.
8. Registrar
Acrescente uma linha por take em ./takewright-output/prompt-log.md:
| data | provedor/modelo | proporção/res/duração | custo | prompt (curto) | classificação + causa/correção |
No início de uma nova tarefa, leia apenas as últimas 20 linhas para reutilizar o que funcionou.
Diretrizes de segurança
- Estime e confirme antes de gastar; mostre totais para planos com várias cenas.
- Nunca invente IDs de modelo, flags, metadados, preços ou resultados. Em caso de dúvida, verifique o
--help, esquema ou documentação do provedor. - Mantenha chaves de API fora do chat, arquivos, logs e configuração. Use o login do próprio provedor ou variáveis de ambiente.
- Nenhuma semelhança ou voz de figuras públicas reais, nenhum personagem protegido, marca ou logotipo, nenhuma clonagem de voz sem o consentimento do proprietário, nenhuma representação enganosa de lugares, produtos ou pessoas reais (por exemplo, recursos de IA adicionados a uma listagem real).
- Direitos: verifique as licenças do modelo antes do uso comercial e use música licenciada ou gerada.