Communitygithub.com

CutPilot — edição AI multitrack local e ship

Edição AI local-first: inspeciona footage, cortes alinhados à narração, timeline de review, captions, motion Remotion, interchange CapCut/JianYing, render local. Logo incluso.

O que é CutPilot — edição AI multitrack local e ship?

Short-form passo 3: CutPilot. Timeline ship após claude-shorts + Easel clipify.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Hellotravisss/cutpilot/tree/HEAD/skills/cutpilot-video-editing

Perguntar na sua IA favorita

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

Documentação

Edição de Vídeo CutPilot AI

CutPilot é um fluxo de trabalho de edição local-first e Codex-first, com uma linha do tempo de revisão manual incorporada. O Codex toma decisões editoriais a partir do briefing, narração, metadados e folhas de contato do usuário; as ferramentas do CutPilot tornam essas decisões reproduzíveis e renderizáveis, enquanto o usuário pode ajustar diretamente os detalhes suportados da linha do tempo.

Fluxo de Trabalho

  1. Chame inspect_media_folder na pasta fornecida pelo usuário. Não faça upload de originais.
  2. Leia o manifesto retornado e inspecione as imagens de folha de contato geradas quando a seleção visual for importante.
  3. Identifique o arquivo de narração a partir da nomeação ou instrução do usuário. Pergunte apenas por escolhas criativas que não possam ser inferidas.
  4. Inspecione as folhas de contato, depois chame annotate_assets com descrições e tags visuais factuais. Não adivinhe conteúdo não visto. Construa build_semantic_index após mudanças substanciais de ativos.
  5. Prefira search_semantic_assets para intervalos exatos de ativos, subclipes de cena e transcrições. Passe IDs de ativos já usados em avoidAssetIds quando o usuário desejar menos repetição. Use rank_assets_for_narration apenas como um fallback leve.
  6. Crie um plano de corte com tomadas frequentes e semanticamente combinadas. Cada clipe visual precisa de um caminho de origem, início da linha do tempo, início da origem e duração. Nunca repita uma tomada a menos que o usuário peça ou a repetição tenha um propósito editorial claro.
  7. Resuma a estrutura proposta e obtenha aprovação antes de renderizações caras, a menos que o usuário tenha explicitamente solicitado a execução de ponta a ponta.
  8. Chame render_project após a aprovação. Entregue o MP4 mais o projeto JSON.

Padrões Editoriais

  • Corresponda visuais ao significado falado: código quando código é mencionado, imagens de casamento quando trabalho de casamento é mencionado, detalhes de fábrica para narração de fábrica.
  • Prefira mais cortes propositais em vez de segurar um clipe genérico por muito tempo.
  • Preserve a narração como áudio principal e mute o B-roll a menos que o usuário solicite som natural.
  • Use 9:16, 1080x1920, 30fps para vídeo social vertical, a menos que o usuário especifique o contrário.
  • Mantenha os arquivos originais intocados.

Fluxo de Trabalho Primeiro Projeto

Para uma edição durável, prefira as ferramentas de projeto v0.2:

  1. create_project
  2. import_assets
  3. inspect_media_folder
  4. edit_timeline
  5. validate_project
  6. read_project
  7. transcribe_asset quando o tempo da transcrição for necessário. Use download_transcription_model uma vez se nenhum modelo estiver disponível.
  8. set_captions e export_subtitles quando legendas forem solicitadas.
  9. render_project após o usuário aprovar o corte.
  10. Use edit_item_effects e set_transition para estilização não destrutiva de clipes.
  11. Use create_motion_graphic / update_motion_graphic para títulos editáveis, terços inferiores e cartões de informação.
  12. Use generate_voiceover para TTS privado do macOS, ou register_generated_asset para preservar a proveniência de mídia criada por geradores externos.
  13. Chame create_project_snapshot antes de uma revisão autônoma substancial. Use list_project_snapshots e restore_project_snapshot quando o usuário quiser comparar ou desfazer uma direção.
  14. Para projetos Vlog, chame get_vlog_workflow_status para encontrar o primeiro estágio incompleto baseado em evidências e sua ferramenta recomendada.
  15. Use submit_vlog_release_export para o MP4 final. Ele sempre executa uma verificação prévia rigorosa e se recusa a exportar enquanto houver bloqueadores.
  16. Após a renderização, chame inspect_rendered_video e inspecione visualmente sua folha de contato. Trate avisos de segmento preto/congelado como pistas, não como falhas editoriais automáticas.
  17. Use export_interchange com fcpxml para Resolve/Final Cut ou edl para uma transferência simples de vídeo primário.
  18. Use submit_generation uma vez por imagem/vídeo/música/SFX solicitada. Use track_generation para status e materialização; não coloque um resultado gerado antes que o usuário o tenha revisado quando a geração custa dinheiro.
  19. Use edit_item_transform para posição, tamanho, rotação, ajuste e animação de entrada/saída/flutuação explícitos. Inspecione vários quadros para que o movimento transitório não seja confundido com layout quebrado.
  20. Use create_motion_graphic_from_svg para gráficos dirigidos por propriedades criados diretamente. Declare cada {{property}}, mantenha recursos externos fora do SVG e use update_svg_motion_graphic para alterações posteriores de texto/cor/origem.
  21. Use quadros-chave de transformação ordenados para coreografia intencional de x/y/rotação. Use cross-dissolve apenas em um limite de clipe adjacente contíguo e inspecione quadros de antes, durante e após a transição.
  22. Quando o usuário quiser inspecionar ou ajustar manualmente a edição de IA, chame open_review_session com o projeto real e a pré-visualização mais recente, depois abra seu URL localhost no Codex. Feche-o com close_review_session quando a página ao vivo não for mais necessária.
  23. As gravações da interface de revisão são edições reais do projeto. Elas criam snapshots automaticamente e rejeitam tempo, opacidade, sobreposição, tokens expirados e intervalos de mídia malformados inválidos.
  24. Use split_item ou razor_all_tracks para cortes contínuos de origem. Use trim_item para mudanças de limite, ripple_delete_item para remover tempo e insert_timeline_gap para abrir tempo preservando mídia cruzada através de divisões automáticas.
  25. Na interface de revisão, os usuários podem arradar corpos de clipe, arradar alças de corte, dividir no playhead, aplicar exclusão Ripple, inserir lacunas globais, definir transições de saída e inspecionar formas de onda geradas reais.
  26. As opções de transição incluem fade, dip-black, cross-dissolve, quatro wipes direcionais, revelação radial e quatro slides direcionais. Use transições avançadas apenas em limites de clipe adjacentes contíguos e verifique um quadro intermediário.
  27. Pontes de geração nomeadas usam MYCUT_SEEDANCE_ENDPOINT, MYCUT_KLING_ENDPOINT, MYCUT_MUREKA_ENDPOINT ou MYCUT_SFX_ENDPOINT, com variáveis _TOKEN opcionais correspondentes. Elas preservam semânticas de envio/status/materialização; não afirme que um fornecedor pago foi testado ao vivo a menos que esse endpoint tenha sido realmente configurado e chamado.
  28. Use edit_item_keyframes para animação de x/y/scale/rotation/opacity. O easing é armazenado no keyframe esquerdo e pode ser linear, ease-in, ease-out, ease-in-out, hold ou controles Bezier Y personalizados. Verifique vários tempos renderizados.
  29. Use list_glsl_presets e apply_glsl_preset para efeitos WebGL integrados, ou edit_item_effects com tipo glsl para código-fonte de fragmento criado diretamente. Mantenha as declarações u_texture, u_time, u_progress e u_resolution compatíveis com WebGL1 e verifique a renderização compilada.
  30. Use create_jsx_motion_graphic para componentes React orientados por quadro e update_jsx_motion_graphic para alterações posteriores de fonte/props. Defina MotionGraphic; React e frame/fps/progress/dimensions são fornecidos. Verifique transparência e vários quadros.
  31. Use export_interchange com premiere-xml para Premiere Pro, fcpxml para Final Cut/Resolve ou edl para uma lista de cortes simples. Use import_fcpxml ou import_premiere_xml para criar um novo projeto CutPilot a partir de XML NLE local, depois valide e verifique a renderização da linha do tempo importada.
  32. Use export_jianying_draft apenas quando o usuário aceitar compatibilidade legada de texto simples experimental. Sempre informe que os rascunhos modernos do Jianying são criptografados/dependentes de versão e chame validate_jianying_draft; nunca afirme compatibilidade de abertura de aplicativo sem iniciar o aplicativo de destino com sucesso.
  33. Use list_caption_templates e update_caption_style para legendas ricas. Ative karaoke apenas quando existirem timestamps de palavras, depois verifique vários intervalos de palavras na renderização queimada.
  34. Use edit_item_playback para velocidade constante de 0.1x-16x, curvas de velocidade editáveis, reversão ou quadros congelados de vídeo. Os pontos da curva usam o tempo da linha do tempo do clipe local mais taxa e easing; a duração da linha do tempo permanece fixa enquanto a curva integrada determina o intervalo de origem. O áudio segue a mesma curva com alongamento de tempo segmentado com preservação de pitch.
  35. Use edit_item_effects para pilhas visuais não destrutivas ordenadas. chroma-key remove uma cor RGB selecionada com controles de similaridade/mistura; mask suporta geometria retângulo/elipse, penas e inversão; color-grade, curves e vignette fornecem finalização local. Verifique transparência contra uma faixa de vídeo inferior e inspecione pixels de centro/borda/canto.
  36. Use edit_item_audio_effects para processamento de áudio por clipe ordenado. A limpeza de voz normalmente começa com high-pass, gate, EQ, compressão e de-essing; stereo e pitch são ferramentas criativas. O pitch preserva a duração da linha do tempo. Meça o espectro real da renderização, dinâmica RMS/pico e energia esquerda/direita antes de relatar sucesso.
  37. Use render_audio quando o usuário quiser uma narração processada, mixagem de música, podcast ou transferência de áudio sem vídeo. Escolha WAV de 24 bits ou FLAC para continuação sem perdas, MP3 para entrega ampla e M4A para entrega AAC compacta; verifique se o arquivo exportado não contém fluxo de vídeo.
  38. Use list_timelines, create_timeline, duplicate_timeline, activate_timeline, rename_timeline e delete_timeline para sequências separadas longas, curtas, verticais ou quadradas que compartilham uma biblioteca de ativos. Nunca delete a última linha do tempo.
  39. Use set_timeline_in_out e range: zone em render_project ou render_audio para um intervalo de exportação exato selecionado. O fatiamento de intervalo preserva o mapeamento de origem, curvas de velocidade, legendas, marcadores e tempo de áudio sem modificar a sequência de origem.
  40. Use export_motion_graphic para entregar um Motion Graphic SVG ou JSX/React como um MOV ProRes 4444 transparente autônomo. Verifique tanto o perfil 4444 quanto um formato de pixel alfa yuva.
  41. Use read_transcript_edit para inspecionar segmentos de transcrição com tempo, depois apply_transcript_sequence para reordenar ou omitir segmentos de origem. Isso reconstrói vídeo/áudio de cabeça falante vinculado e legendas de palavras a partir de intervalos de origem exatos; não invente tempos de segmento aproximados.
  42. Use create_asset_bin, move_asset_bin, assign_assets_to_bin e list_asset_library para organizar e pesquisar mídia local sem mover arquivos de origem. Use scan_missing_assets antes de renderizar projetos importados ou movidos.
  43. Use relink_asset para uma substituição explícita ou relink_missing_from_folder para recuperação em massa de nome de arquivo exato. Nunca adivinhe entre correspondências ambíguas; preserve IDs de ativos para que cada referência de linha do tempo, transcrição, anotação, tag, bin e registro de geração permaneça intacto.
  44. Os salvamentos normais de projeto entram automaticamente em um diário de editor persistente de 100 etapas. Use editor_history_status, undo_project e redo_project para reversões de edição imediatas; uma nova edição após Desfazer intencionalmente limpa o ramo Refazer. Mantenha snapshots nomeados para marcos duráveis.
  45. Use set_timeline_format com 16:9, 9:16, 1:1, 4:3 ou 3:4 para alterar a tela editável. Prefira layoutMode: scale quando transformações, keyframes, máscaras e legendas posicionadas por pixel existentes devem se adaptar à nova tela.
  46. render_project aceita resolution não destrutiva (original, 1080p, 720p, 480p) e frameRate (24-60). Verifique as dimensões e taxa reais do FFprobe; essas substituições de saída não devem modificar a sequência de origem editável.
  47. Use create_track, rename_track, reorder_track, edit_track e delete_track para ciclo de vida explícito de faixas. A ordem das faixas determina a ordem de composição do vídeo; vídeo mudo fica oculto, áudio mudo fica silencioso e faixas bloqueadas rejeitam edições.
  48. Configure set_timeline_snapping em quadros. Use snap_timeline_time para visualizar uma guia ou move_item/snapped trim_item para alinhar com bordas de clipe, marcadores, In/Out, playhead ou início da linha do tempo. Nunca force um snap além da tolerância ou em uma sobreposição.
  49. Use set_edit_context para referências exatas no estilo ChatCut a ativos, itens da linha do tempo, tempos da linha do tempo, regiões da tela ou intervalos de origem da transcrição. Chame resolve_edit_context antes de agir para que as decisões de IA se liguem a IDs reais e objetos cronometrados. As alterações de seleção persistem localmente, mas intencionalmente não entram em Desfazer/Refazer.
  50. Comece um novo trabalho com list_project_starters e create_project_from_starter quando um cenário conhecido se encaixar. Os starters criam faixas nomeadas reais, funções de roteamento, bins, legendas, snapping, um briefing criativo salvo e um fluxo de trabalho recomendado. Use configure_project_starter apenas enquanto todas as linhas do tempo estiverem vazias; nunca sobrescreva uma sequência editada com um starter.
  51. Use place_asset_on_timeline para montagem do monitor de origem. Defina In/Out exatos da origem e uma faixa de destino compatível. append usa o final da faixa de destino; insert abre tempo em todas as faixas desbloqueadas e desloca legendas/marcadores; overwrite muda apenas o intervalo de destino enquanto preserva os restos esquerdo/direito contínuos da origem.
  52. Use place_linked_av quando o áudio original de um ativo de câmera/vídeo deve permanecer sincronizado. Membros vinculados compartilham linkGroupId; use move_linked_group e trim_linked_group para edições atômicas seguras para sincronia, ou unlink_timeline_items antes de um ajuste independente intencional. Rejeite colisões e membros bloqueados em vez de dessincronizá-los.
  53. Prefira submit_export_job para exportações longas ou visíveis ao usuário para que o Codex permaneça responsivo. Consulte read_export_job ou list_export_jobs; relate a fase exata e o caminho de saída, e use cancel_export_job apenas quando solicitado. Os trabalhos renderizam a partir de um snapshot de projeto imutável, portanto, edições posteriores da linha do tempo não podem alterar silenciosamente uma exportação em andamento.
  54. Use analyze_asset_silence antes de propor remoção de pausa. Mostre os intervalos de silêncio detectados, limite, duração mínima, preenchimento de borda de respiração e tempo total removido. Chame apply_silence_cut apenas após os intervalos serem aceitos; ele reconstrói AV vinculado contínuo da origem e remapeia legendas de transcrição. Nunca trate toda passagem silenciosa como editorialmente descartável.
  55. Use analyze_asset_scenes em arquivos longos de B-roll ou câmera quando os limites das tomadas forem importantes. Revise seus tempos de corte e folha de contato antes de save_scene_subclips; depois anote/tagueie subclipes ou pesquise-os com list_asset_subclips. Use place_asset_subclip para preservar In/Out exatos da origem detectada em vez de aproximar um intervalo de tomada.
  56. Use analyze_asset_beats para inspecionar música local antes da edição de corte na batida. Revise BPM, posições das batidas, sensibilidade e intervalo mínimo antes de save_beat_markers. Construa

Habilidades Relacionadas