Communitygithub.com

yunye123/interview-soul-editor

Ferramenta de edição de entrevistas focada no texto literal, com gates temáticos humanos e verificação de fontes.

O que é interview-soul-editor?

O 'Interview Soul Editor' é uma habilidade de agente de IA projetada para transformar material bruto de entrevistas em roteiros de vídeo curtos com tema único, carga emocional, evidências verificáveis e capacidade de retorno à fonte original. Ele trata a IA como parceira de seleção e estruturação, não como reescritora do autor. A habilidade impõe regras rígidas de edição literal: nenhuma frase pode ser alterada, reescrita ou parafraseada; apenas cortes, reordenação, concatenação e ajustes de ritmo são permitidos. Ela segue um fluxo de trabalho em portões, desde a confirmação do escopo até a verificação palavra por palavra e a geração de uma planilha de edição com timestamps. O editor suporta entrada de vídeo/áudio (via transcrição local) ou textos já transcritos, e organiza todos os produtos em um diretório `edit/` estruturado. Inclui também um roteiro de revisão em três rodadas (corte, teste de estresse, estrutura final) e seleção de ganchos e finais a partir do texto original. A verificação de fidelidade ao original é feita pelo script `audit_cut.py`, que garante que 100% dos blocos de fala existam na transcrição fonte.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add yunye123/interview-soul-editor

Perguntar na sua IA favorita

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

Documentação

Edição de Alma de Entrevista

Transforme o material bruto de entrevistas em roteiros de vídeo curtos com tema único, carga emocional, evidências verificáveis e capacidade de retorno à fonte original. Trate a IA como parceira de seleção e estruturação, não como reescritora do autor.

Sete Regras Rígidas

  1. Mantenha a mídia original e a transcrição literal originais somente leitura; todos os produtos devem ser gravados no diretório edit/.
  2. Linha vermelha intransponível: não mude uma frase, não regrave, não parafraseie, não traduza; faça apenas seleção, reordenação, concatenação, corte e ajuste de ritmo.
  3. Cada bloco de fala do produto final deve existir palavra por palavra na transcrição fonte. Frases similares, resumidas ou polidas são consideradas falha.
  4. Separe a correção de transcrição da edição. Ao suspeitar de erro de ASR, marque [Reouvir] com o timestamp; não corrija silenciosamente.
  5. Primeiro confirme o tema e as quatro perguntas da alma, depois produza o roteiro completo; primeiro confirme a estratégia de edição, depois execute o corte real do vídeo.
  6. Não prometa criar um viral de primeira. Cada rodada deve gerar melhoria avaliável ou uma razão clara para parar, evitando repetir o mesmo prompt mecanicamente.
  7. Não deixe o modelo calcular ou auto-reportar contagem de palavras. A unidade de conteúdo do roteiro deve ser contada pelo audit_cut.py; a métrica final deve ser baseada no WPS/Word e na audição real.

Identificar a Entrada e Estabelecer o Projeto

Entrada é Vídeo ou Áudio

  1. Use ffprobe para verificar nome do arquivo, duração e trilhas de áudio/vídeo; não modifique o arquivo fonte.
  2. Priorize chamar o $local-transcribe instalado, ou execute diretamente:
v2t "/caminho/absoluto/entrevista.mp4" "/caminho/absoluto/edit/transcricoes" --spk

Para entrevistas com múltiplos falantes, use --spk. Mantenha o .txt para verificação literal e o .srt / .json para localização por timestamp. Se v2t não estiver disponível, use a capacidade de transcrição local existente do host; sem o consentimento do usuário, não faça upload de entrevistas não publicadas para serviços em nuvem.

Entrada já é uma Transcrição

Trate o arquivo especificado pelo usuário como a única fonte de texto. Se não houver timestamps, é possível concluir o planejamento do tema e do roteiro, mas marque claramente no corte "ainda não é possível o corte exato" e não falsifique timestamps.

Diretório Fixo de Produtos

edit/
├── project.md
├── transcripts/                 # Produtos de transcrição originais, não sobrescrever
├── 01-theme-map.md
├── 02-candidate-cut.md
├── 03-source-audit.md
├── 04-final-cut.md
├── 04-final-cut-pure.txt
├── 05-hooks-endings.md
└── 06-edit-sheet.md

Em project.md, registre: arquivo fonte, plataforma alvo, público alvo, duração final, orçamento do rascunho, tema selecionado, quatro perguntas da alma, gargalo atual, decisões aprovadas pelo usuário e itens a reouvir. Avance apenas um gargalo por rodada.

Avançar por Gargalos

Gargalo 0: Confirmar o Escopo da Tarefa

Confirme plataforma alvo, duração final, se há múltiplos falantes, se precisa cortar diretamente para vídeo. Se o usuário não especificar, o padrão é vídeo curto premium com duração final de 2–3 minutos; o roteiro candidato deve ter cerca de 1.5–2 vezes o alvo final, e deixe claro que é um valor provisório. O orçamento pode ser convertido aproximadamente em 280–300 unidades de conteúdo por minuto para fala em chinês, mas após gerar o roteiro, use script para contar, não estimativa do modelo; a métrica final é baseada no WPS/Word e na audição real.

Gargalo 1: Planejar o Tema e as Quatro Perguntas da Alma

Após ler a transcrição completa, gere 01-theme-map.md. Cada tema candidato deve incluir:

  • Tema em uma frase e conflito central;
  • Quatro perguntas da alma: para quem falar, o que dizer, que impacto deseja causar em quem, quem é o oponente;
  • Trechos originais da transcrição ou intervalos de tempo que suportam o tema;
  • Picos emocionais, pontos contra-intuitivos, detalhes específicos e ganchos potenciais;
  • Valor de aprofundamento único e risco de desvio.

Recomende apenas 3–7 temas verdadeiramente distintos. Não use o mesmo ponto de vista com títulos diferentes para completar a lista. Peça ao usuário para escolher um tema; se não houver seleção, não produza roteiros completos para todos os temas.

Leia editorial-rubric.md para entender as quatro perguntas da alma e a pontuação do tema.

Gargalo 2: Montar um Roteiro Candidato Redundante

Com base no tema selecionado, produza 02-candidate-cut.md. Se o alvo for 3 minutos, pode começar com cerca de 5 minutos; se o alvo for cerca de 800 palavras, pode começar com cerca de 1200 palavras. A redundância é para continuar cortando, não para incluir ramificações.

Escreva cada trecho contínuo da transcrição original como um bloco VERBATIM independente; para reordenar, mova blocos inteiros. Não combine meias frases de posições não consecutivas como se fossem um bloco contínuo. Siga rigorosamente o formato de cut-script-format.md.

Imediatamente após gerar o roteiro candidato, execute audit_cut.py. Se a verificação da transcrição original falhar, corrija primeiro; não leve erros para a revisão. Se a contagem de unidades de conteúdo desviar do orçamento, só pode continuar selecionando ou cortando frases originais, não reescrevendo para completar.

Gargalo 3: Três Rodadas de Revisão com Propósito

Revise em ordem, não faça três rodadas apenas perguntando "pode melhorar?":

  1. Rodada de Corte: Remova conteúdo não relacionado ao tema, público, impacto ou oponente; mescle argumentos repetidos.
  2. Rodada de Teste de Estresse: Responda "por que esta versão pode não ter engajamento", verifique gancho lento, conflito pouco claro, informação genérica, falta de detalhes, emoção insuficiente, conclusão prematura etc.; depois corrija usando apenas frases originais.
  3. Rodada Final de Estrutura: Verifique "interconectado, do começo ao fim" – propósito de cada parágrafo, relação lógica, ordem de imersão, imagens detalhadas, desvio do tema principal e serviço às quatro perguntas da alma.

Cada rodada liste "manter / remover / reordenar / motivo" e depois dê a nova ordem dos blocos. Proibido usar polimento para mascarar problemas estruturais. Se uma rodada não encontrar novos problemas, apresente evidências e pare a iteração.

Gargalo 4: Determinar Gancho e Final

Após o corpo do conteúdo estar estável, gere 05-hooks-endings.md:

  • Encontre 3–8 candidatos de abertura na transcrição original, anotando ID do bloco, poder de retenção, consistência temática e risco de contexto enganoso;
  • Permita "coletânea de frases de efeito" como abordagem, mas cada frase deve vir do original, e evite compor um novo significado que o entrevistado não expressou;
  • Encontre finais adequados para encerramento, suspense, expectativa para próximo episódio ou interação com comentários;
  • Se a transcrição original não tiver CTA falado, liste apenas "sugestões de legenda na tela / texto de publicação" separadamente; não misture com o roteiro literal do produto final.

Gargalo 5: Verificação Literal e de Contagem de Palavras

Execute:

python3 "/caminho/para/interview-soul-editor/scripts/audit_cut.py" \
  --source "/caminho/para/edit/transcricoes/entrevista.txt" \
  --cut "/caminho/para/edit/04-final-cut.md" \
  --target-units 900 \
  --pure-out "/caminho/para/edit/04-final-cut-pure.txt"

Somente com missing_verbatim_blocks = 0 o roteiro pode ser chamado de "aprovado na verificação da transcrição original". O script conta unidades de conteúdo com base em caracteres chineses e palavras em inglês/números, e fornece uma estimativa de 280–300 unidades/minuto; não o chame de contagem precisa de palavras do WPS.

Para itens [Reouvir], volte ao vídeo original para confirmar e depois atualize a versão corrigida da transcrição ou mantenha o texto original do ASR e adicione anotações de reouvir. Não corrija silenciosamente no roteiro.

Gargalo 6: Gerar Planilha de Edição com Retorno à Fonte

06-edit-sheet.md Cada linha deve incluir pelo menos: ordem de saída, ID do bloco, arquivo fonte, ponto de entrada, ponto de saída, frase literal original, papel estrutural, anotações de emoção/ação, transições. Priorize manter choro, risos, pausas, ênfase e caudas de reação após frases de efeito; se houver desvio de timestamp, deixe margem para o editor ouvir.

Antes de extrair formalmente os blocos, volte à transcrição original e pesquise cada frase original: primeiro para confirmar que a frase existe, segundo para recuperar trechos originais que a IA possa ter perdido, mas que são mais fortes. Coloque os novos candidatos novamente em revisão e verificação; não pule gargalos.

Comparação de Múltiplos Modelos

Quando o usuário fornece várias versões de IA, converta todas para o mesmo formato de bloco VERBATIM; primeiro elimine frases que não vêm da transcrição original, depois avalie cegamente de acordo com editorial-rubric.md. Mantenha os blocos realmente mais fortes de cada versão e re-verifique. Sem ter ferramentas para chamar vários modelos, não invente "múltiplos modelos concordam".

Limitações de Execução Real de Vídeo

Esta habilidade entrega por padrão "roteiro verificado + gancho/final candidatos + planilha de edição com timestamps", sem modificar automaticamente as imagens. Se o usuário solicitar explicitamente a produção direta de vídeo:

  • Priorize reutilizar o pipeline transcript → EDL → render → self-eval do browser-use/video-use;
  • Para DaVinci Resolve, avalie bibliotecas de mídia, busca e fluxo de trabalho EDL/XML com StoryToolkitAI;
  • Para integração com Premiere / CapCut, entregue 06-edit-sheet.md para edição manual; primeiro uniformize iluminação, composição e posição dos personagens, depois extraia blocos na ordem;
  • Antes de qualquer corte real, peça ao usuário que aprove a estratégia de edição em texto.

Leia open-source-reuse.md para conhecer soluções verificadas do GitHub/npm e limites de adoção.

Definição de Conclusão

Relate conclusão apenas quando todas as condições a seguir forem atendidas: tema e quatro perguntas da alma confirmados; todos os blocos de fala do produto final vêm da transcrição original; contagem de palavras/duração próxima ao alvo; revisão final da linha principal aprovada; gancho e final selecionados ou listados como candidatos; cada bloco pode ser localizado no material fonte; todos os itens a reouvir explicitamente listados. Distinga estritamente entre "pode ter potencial de compartilhamento" e "garantia de viral".

Habilidades Relacionadas