Communitygithub.com

mishanaer/showtime

Crie, revise ou revise vídeos curtos de produto a partir de um aplicativo real. Use para demonstrações, storyboards ou vídeos showtime existentes. Suporta captura do simulador iOS e composição local.

O que é showtime?

O showtime é uma skill projetada para criar vídeos curtos e focados em um único benefício do produto, através da interação real com o aplicativo, capturando a tela do simulador iOS. Ela oferece flexibilidade de enquadramento (superior, inferior ou telefone inteiro), composição automática e geração de vídeos MP4 com loop a 60 FPS. A skill também gerencia um fluxo de trabalho estruturado: aprovação do cenário pelo usuário, preparação interna com verificações técnicas e visuais, captura orientada por script e exportação final sem necessidade de revisão externa. Suporta dispositivos iPhone 17/18, escolhe cores e papéis de parede automaticamente, e permite ajustes diretos com nova verificação automática dos trechos afetados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mishanaer/showtime/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que showtime faz?

Demonstre um benefício do produto através da interação real com o aplicativo. Continue o trabalho existente na etapa relevante; reutilize filmagens quando elas suportarem a alteração solicitada.

Iniciando um novo vídeo

  1. Pergunte ao usuário qual é o cenário e aguarde a resposta. Use o cenário fornecido pelo usuário.
  2. Assim que o cenário estiver disponível, pergunte qual enquadramento ele deseja: corte superior (crop-top), corte inferior (crop-bottom) ou o telefone inteiro (full). Aguarde a escolha antes de preparar a história para revisão.
  3. Obtenha aprovação do cenário, composição e tempo. Em seguida, prepare e revise internamente a cena real, grave, exporte e conclua a Aceitação visual antes de enviar o vídeo finalizado. Não há uma etapa separada de pré-visualização ou aprovação de storyboard para o usuário.

Faça uma pergunta de cada vez, no idioma da conversa. Trate informações já fornecidas pelo usuário como respondidas.

Padrões e limites

  • Grave o simulador em sua cadência nativa. Assista a rolagens e transições em velocidade normal. Refilme se o movimento capturado apresentar travamentos visíveis.

  • Entregue um MP4 de 10 a 20 segundos, 1920×1920, 60 FPS constantes, com resultado legível e em loop. Sem títulos ou legendas editoriais; o texto do aplicativo permanece visível. Formatos diferentes solicitados requerem verificação do suporte do backend.

  • Escreva o texto de revisão do cenário do usuário, o cenário salvo e o conteúdo na tela em inglês, a menos que explicitamente solicitado o contrário. Defina content.language nos dois manifestos. Explicações fora do cenário seguem o idioma da conversa do usuário.

  • A aprovação do cenário autoriza a produção dentro daquela história. Os materiais preparados ainda exigem revisão interna e evidências, não uma segunda decisão do usuário. Um pedido direto de correção autoriza esse escopo; repita as verificações afetadas antes de entregar o vídeo final revisado. Nunca marque materiais não vistos como revisados pelo usuário.

  • O primeiro vídeo enviado ao usuário deve atender aos mesmos requisitos de qualquer entrega posterior: conteúdo completo, indicadores de toque, tempo, enquadramento e verificações técnicas e visuais completas. Mantenha ensaios técnicos internos. Corrija verificações com falha antes de enviar; se uma verificação obrigatória não puder ser concluída, reporte o bloqueador em vez de oferecer uma pré-visualização não verificada para aprovação. Reutilize uma tomada ou exportação aprovada; não repita apenas para renomeá-la como “final”.

  • Mantenha transições nativas completas, tempo de rolagem e leitura. Encurte esperas ociosas ou simplifique a história para caber na duração.

  • Vídeos novos usam maquetes aprovadas da família iPhone 17 ou 18 e as paletas de fundo incluídas. Escolha automaticamente um modelo de simulador disponível, cor do telefone e fundo compatíveis; as preferências do usuário substituem essas escolhas. Mostre a combinação no storyboard. Consulte Preparação para ativos e correspondência de captura.

  • Aplique o layout escolhido pelo usuário. Use crop-top para ação próxima ao topo, crop-bottom para ação próxima ao compositor, anexos ou teclado, e full para mostrar o telefone inteiro centralizado com 90 px acima e abaixo em um quadrado de 1920. Use o enquadramento selecionado na preparação, revisão e exportação.

  • O texto aparece caractere por caractere com o cursor de inserção oculto durante a digitação. Restaure a aparência original do cursor do campo imediatamente após o último caractere ou uma entrada interrompida; não adicione uma pausa para restauração. As teclas do teclado não devem mostrar destaques, caracteres pop-up ou indicadores de toque. Driver de digitação padrão · Uso · Aceitação visual

Espaço de trabalho

O diretório deste arquivo é a raiz do showtime (SHOWTIME). Resolva e invoque scripts pelo caminho absoluto. Siga as instruções do aplicativo alvo. Leia o run.json e os artefatos da execução relevante; atualize o progresso com scripts/showtime_run.py init/note/status. Progresso não é aprovação.

Mantenha a skill instalada e os ativos somente leitura durante a produção. Escreva no diretório de execução do vídeo; preserve as tomadas anteriores e o trabalho de outros agentes. Use pilotos históricos apenas quando fornecidos como referência.

Antes da produção, execute scripts/showtime_doctor.py; adicione --record --axe <driver> ao gravar. Novas execuções usam o perfil do produto; execuções existentes mantêm sua configuração.

Leia apenas o que a tarefa precisa

TarefaReferência
Planejar uma história, capturar, editar ou exportarExecução — carregue a seção relevante
Preparar uma cena ou storyboardPreparação — regras visuais e evidências antes da revisão
Salvar aprovações ou autorizar uma correçãoContratos de manifesto e revisão
Revisar quadros preparados ou um vídeo finalizadoAceitação visual
Ajustar cor, tempo ou tamanho do toqueAtivo de toque

Uma entrega finalizada inclui o MP4, a captura fonte, o diário de ação, observações e descobertas de verificação. As verificações técnicas não estabelecem aceitação visual.

Habilidades Relacionadas