Communitygithub.com

editar

A etapa de edição: blocos renderizados transformados no filme final, dentro do programa de edição especificado em `config.json` (pela chave `editor.id`). Use para "/edit", "editar o filme", "cortar", "abrir no Resolve", "fazer o vídeo final". `none` = o agente edita sozinho com ffmpeg (habilidade `assemble`). Qualquer programa = editar DENTRO desse programa: MCP para operações precisas E uso do computador para olhar a tela e verificar, juntos, nunca apenas MCP. Lê `editor.mcp` / `editor.computer_use` e pergunta antes de assumir o controle da tela. Nunca gera mídia, nunca adiciona música.

O que é editar?

A habilidade de edição transforma os blocos de clipes renderizados em um filme final dentro do programa de edição especificado pelo autor no `config.json`. Ela oferece dois caminhos principais: o autor pode optar por editar com `ffmpeg` (definindo `editor.id` como `none`, que utiliza a habilidade `assemble` para gerar o filme), ou pode escolher um programa de edição profissional como DaVinci Resolve, Premiere Pro, Final Cut Pro ou CapCut. Quando um programa é definido, a habilidade combina o uso de MCP (Model Context Protocol) para operações precisas e repetíveis (criar projeto, linha do tempo, importar clipes) com o uso do computador (computer use) para verificar visualmente cada etapa, assegurando que não haja erros. O agente nunca confia cegamente em mensagens de sucesso sem confirmação visual, e sempre permissão antes de mover o mouse ou teclado do autor. A habilidade também lida com casos onde apenas um dos recursos (MCP ou computer use) está disponível, e, se nenhum estiver disponível, gera um arquivo EDL e o filme final via ffmpeg como fallback. É compatível com qualquer cliente de agente que suporte MCP e computer use, como Claude Code, Cursor ou Codex, registrando o caminho do arquivo do projeto no `editor.notes` e garantindo que nunca adiciona música — isso fica a cargo do autor.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

Perguntar na sua IA favorita

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

Documentação

/edit — clipes → filme, no programa que a história indica

O filme é cortado onde o autor continuará trabalhando. config.json informa o local:

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
ChaveSignificado
idnone — você edita sozinho com ffmpeg. Ou o programa: davinci_resolve, premiere_pro, final_cut_pro, capcut, ou qualquer outro nome que o autor fornecer.
mcptrue quando o servidor MCP desse programa está instalado e conectado no seu cliente.
computer_usetrue quando você pode controlar a tela (uso do computador do Claude, ou equivalente da sua ferramenta).
notesTexto livre opcional: versão, edição, localização do projeto do programa.

Não haver a chave editor é o mesmo que { "id": "none" }.

Etapa 0 — verificar os clipes (todos os caminhos)

Execute a Etapa 1 da habilidade assemble primeiro, qualquer que seja o editor: cada bloco tem um clipe, em ordem, na sua duração real. Uma edição construída sobre um bloco faltando é um filme com um buraco.

Caminho A — editor.id: "none": você é o editor

Siga a habilidade assemble. A saída é renders/final/film.mp4. Essa é a etapa completa.

Caminho B — um programa: editar dentro dele

B1. Verifique o que você pode acessar, depois informe

Antes de tocar em qualquer coisa, confirme o que config.json afirma:

  • MCP: chame uma ferramenta somente leitura no servidor do programa (para DaVinci Resolve, a listagem de projetos ou linhas do tempo). Se falhar, imprima a linha de instalação desse servidor de config.json mcp_servers (npx storyseam mcp --agent <o seu>; para Resolve, npx davinci-resolve-mcp setup) e aguarde. Defina editor.mcp como false somente após o autor confirmar que o servidor não deveria estar lá. Nunca instale por conta própria.
  • Uso do computador: tire uma captura de tela e confirme que o programa está aberto, ou pode ser aberto.

Depois, informe ao autor em uma linha em qual modo você trabalhará e peça permissão antes de assumir o controle da tela: o uso do computador mexe no mouse e teclado deles.

B2. Trabalhe MCP e uso do computador JUNTOS

Nenhum dos dois é suficiente sozinho, e os melhores resultados vêm do uso de ambos em cada etapa:

  • MCP faz o trabalho preciso e repetível: crie o projeto e a linha do tempo na resolução e taxa de quadros da história, importe renders/clips/block_NN.mp4 na ordem dos blocos, coloque cada um em V1/A1 consecutivamente, adicione marcadores por bloco a partir de shotlist/shotlist.json, configure as configurações de renderização e inicie a renderização. Valores exatos e sem cliques errados.
  • Uso do computador são seus olhos e suas mãos onde a API não alcança: capture a tela após cada etapa do MCP para confirmar que ela fez o que foi relatado, percorra cada emenda no visualizador e olhe os quadros de ambos os lados, verifique os medidores de áudio e lide com qualquer coisa que o MCP não exponha (uma caixa de diálogo, um painel, um arrastar, uma configuração sem API).
  • Nunca confie em uma mensagem de sucesso do MCP que você não tenha visto. Um clipe importado na taxa de quadros errada, uma linha do tempo na resolução errada ou uma fila de renderização vazia todos reportam sucesso.

Quando apenas um está disponível:

mcpcomputer_useComo você trabalha
verdadeiroverdadeiroAmbos, como acima. O padrão e o melhor.
verdadeirofalsoApenas MCP. Diga que a edição não foi verificada visualmente e peça ao autor para inspecionar as emendas pessoalmente.
falsoverdadeiroApenas uso do computador. É mais lento, então avise o autor e mantenha as etapas pequenas com uma captura de tela após cada uma.
falsofalsoVocê não consegue controlar o programa. Escreva renders/edit/timeline.edl (CMX 3600, um evento por bloco em ordem, a partir de shotlist.json e das durações reais dos clipes), diga ao autor como importá-lo e também produza renders/final/film.mp4 através da habilidade assemble para que haja um filme de qualquer forma.

B3. A edição

  1. Um projeto com o nome do title do storyseam.md, na resolução e taxa de quadros reais dos clipes (ffprobe em um clipe; não suponha).
  2. Uma linha do tempo. Blocos em V1 e o áudio deles em A1, em ordem, sem lacunas e sem sobreposições.
  3. Um marcador por bloco, nomeado com o id do bloco e o primeiro take.
  4. Deixe uma faixa de música vazia (A2) para o autor. Nunca adicione música. A trilha sonora é do autor, em assets/audio/music/.
  5. Renderize para renders/final/film.mp4 (H.264, AAC, a resolução da linha do tempo) e salve o arquivo de projeto do programa onde ele o mantém. Registre esse caminho em editor.notes.

B4. Notas sobre programas

  • DaVinci Resolve. O servidor MCP dele controla a API de scripts do Resolve. Scripts externos são apenas na versão Studio; na edição gratuita, a ponte no aplicativo (Workspace › Scripts) é o caminho, e na versão gratuita 21.1+ o Python scripting foi removido, então espere depender mais do uso do computador lá. Use a página Edit para a linha do tempo e a página Deliver para renderizar; confirme a fila de renderização em uma captura de tela antes de iniciá-la.
  • Qualquer outro programa. Procure primeiro pelo servidor MCP dele. Se não houver, é a linha mcp: false acima. Não instale software, plugins ou servidores MCP por conta própria; diga ao autor o que ajudaria e deixe que ele faça.

Etapa final — relatório

O caminho para o filme, seu tempo de execução real e resolução, o arquivo de projeto do programa, em qual modo você trabalhou (MCP + uso do computador, um deles ou EDL), qualquer coisa que você não pôde verificar visualmente e que não há música por design.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas