Otimizador de Demonstrações do Screen Studio
Use este skill para transformar a intenção de edição de um usuário em edições seguras e reversíveis na linha do tempo do Screen Studio.
O skill não é um estilo de edição fixo. Deixe sempre o resultado desejado pelo usuário controlar o plano: duração alvo, ritmo, preservação da lógica, limites de velocidade, comportamento de zoom e formato de saída.
Fluxo de Trabalho Principal
- Esclareça ou infira o contrato de edição:
- Duração alvo: exata, aproximada ou sem restrição.
- Estilo: demonstração social, tutorial, demonstração para investidores, passo a passo interno, revisão calma, teaser rápido ou personalizado.
- Prioridade: preservar cada etapa lógica, permitir cortar esperas, permitir excluir repetições, preservar áudio, preservar zooms, reduzir movimento.
- Saída: apenas plano, cópia editada ou exportação.
- Prepare uma cópia segura antes de modificar qualquer coisa.
- Use
scripts/prepare_edit_copy.mjs. - Nunca modifique o projeto
.screenstudiooriginal, a menos que o usuário peça explicitamente.
- Use
- Analise o projeto.
- Use
scripts/analyze_timeline.mjs. - Leia fatias, velocidades, intervalos de reprodução, intervalos de zoom e riscos de zoom de sub-segundo.
- Use
- Crie um plano editável.
- Use
scripts/plan_compression.mjsquando uma duração alvo for fornecida. - Explique o plano em termos humanos antes de aplicá-lo.
- Use
- Peça confirmação antes de modificar a cópia de edição.
- Aplique as alterações confirmadas.
- Use
scripts/apply_speed_plan.mjs. - Use
scripts/normalize_project_json.mjsapós salvamentos externos ou via CLI.
- Use
- Revise o conforto do zoom.
- Use
scripts/optimize_zoom_track.mjs --review. - Aplique alterações de zoom somente após confirmação.
- Use
- Verifique.
- Use
scripts/verify_project.mjs. - Se o Screen Studio estiver disponível, use opcionalmente
scripts/screenstudio_cdp_open_project.mjsescreenstudio --port <port> status.
- Use
Contrato de Preferências
Se o usuário der intenção suficiente, prossiga com valores padrão razoáveis. Se o alvo for ambíguo, faça uma pergunta concisa.
Contrato padrão quando o usuário apenas disser "melhore isso":
{
"targetSeconds": null,
"style": "balanced-demo",
"preserveLogic": true,
"allowDelete": false,
"maxReadingSpeed": 1.6,
"maxActionSpeed": 3,
"maxWaitSpeed": 10,
"zoomPolicy": "reduce-jumpy-zooms"
}
Predefinições comuns:
social-demo: curto, nítido, alta velocidade de espera, reduzir zooms bruscos.tutorial: mais lento, preservar etapas, evitar alterações agressivas de zoom.investor-demo: conciso, preservar momentos narrativos, enfatizar resultados.agent-workflow: acelerar fortemente esperas/carregamentos, preservar decisões principais e resultado final.review-only: analisar e recomendar, não modificar.
Leia references/compression-rules.md para heurísticas de ritmo e references/zoom-comfort-rules.md antes de editar zooms.
Guia Rápido de Scripts
Prepare arquivos seguros:
node scripts/prepare_edit_copy.mjs "/caminho/para/demo.screenstudio"
Analise:
node scripts/analyze_timeline.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"
Planeje um corte de 90 segundos:
node scripts/plan_compression.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" --target-seconds 90 --preset social-demo > /tmp/plan.json
Aplique um plano confirmado:
node scripts/apply_speed_plan.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" /tmp/plan.json
node scripts/verify_project.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"
Revise o conforto do zoom:
node scripts/optimize_zoom_track.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" --review
Abra no modo CDP do Screen Studio quando o Screen Studio estiver instalado:
node scripts/screenstudio_cdp_open_project.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"
Regras de Segurança
- Por padrão, opte por plano-primeiro para edições não triviais.
- Não sobrescreva o projeto original por padrão.
- Não exclua fatias a menos que o usuário tenha permitido a exclusão.
- Trate gravações com muito áudio ou narração como sensíveis à velocidade.
- Normalize
project.jsonapós salvamentos, porque alguns fluxos do Screen Studio/CLI podem envolver dados do projeto como strings JSON aninhadas. - Verifique a duração final a partir do arquivo do projeto e, quando possível, do tempo de execução do Screen Studio.
- Relate exatamente as fatias e zooms alterados.
Leia references/safety-and-backups.md antes de realizar ações destrutivas ou irreversíveis.
Limitações Conhecidas
- Os componentes internos do Screen Studio podem mudar entre versões. Se a abertura via CDP falhar, volte para a análise do arquivo do projeto e informe o usuário.
- A qualidade visual não pode ser totalmente avaliada apenas com dados da linha do tempo. Use extração de quadros ou a visualização do Screen Studio quando disponível.
- Os scripts incluídos são primitivos conservadores. O agente ainda deve explicar as compensações subjetivas e pedir confirmação.