Communitygithub.com

heshaofu2/video-workflow

Gerencia as tarefas de processamento de vídeo do projeto atual, selecionando ou encadeando transcrição, extração de insights, corte de vídeos longos, deduplicação de fala, resegmentação de legendas e diagnóstico de qualidade de roteiro, bem como edição ChatCut conforme orientação do usuário. Adequado para processamento de vídeo em várias etapas ou solicitações de edição com alvo não definido; tarefas únicas e específicas devem usar o Skill correspondente diretamente.

O que é video-workflow?

O Skill `heshaofu2/video-workflow` atua como um orquestrador central para processamento de vídeo em projetos. Ele entende o objetivo do usuário, seleciona a capacidade de Skill apropriada (por exemplo, transcrição, extração de insights, corte, deduplicação, resegmentação de legendas, diagnóstico de qualidade), organiza a sequência de execução e garante a entrega coesa dos resultados. Ele unifica a gestão de tarefas de vídeo em múltiplas etapas, garantindo que a saída de cada etapa (como uma transcrição com timestamp) seja corretamente passada para a etapa seguinte, evitando inconsistências de linha do tempo ou trabalho duplicado. O Workflow é projetado para ser usado em projetos de processamento de vídeo onde uma série de operações é necessária, ou onde o objetivo exato não está claro para o usuário. Ele se apoia em Skills de domínio específicos localizados em `.agents/skills/` e utiliza o `video-cli` local para operações determinísticas, receptando as regras compartilhadas do Skill `video-shared`. Ele não substitui Skills de tarefa única, mas sim coordena quando múltiplos passos são necessários, respeitando as escolhas e ferramentas existentes do usuário sem substituí-las desnecessariamente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heshaofu2/video-workflow-suite/tree/HEAD/video-workflow

Perguntar na sua IA favorita

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

Documentação

Responsabilidades e Posicionamento

Responsável por entender o objetivo, selecionar capacidades, organizar a sequência, conectar os resultados e consolidar a entrega. Primeiro, leia o video-shared: as regras comuns são mantidas por ele, operações determinísticas são executadas exclusivamente pelo video-cli local, os Skills de domínio mantêm o julgamento de negócios, e esta entrada principal lida apenas com a orquestração entre domínios.

A entrada local, a camada compartilhada e as capacidades de domínio estão totalmente armazenadas no diretório .agents/skills/ do projeto atual, referenciadas por diretórios adjacentes. O ChatCut continua usando o Skill oficial correspondente.

Seleção de Capacidades

Com base no objetivo atual, leia apenas o Skill necessário e, em seguida, leia os materiais de referência exigidos por ele. Os caminhos a seguir são relativos ao diretório desta entrada:

Objetivo do UsuárioCapacidade no Mesmo NívelEntrega Principal
Transcrever áudio ou vídeo, adicionar rótulos de falantevideo-to-textTranscrição com timestamp, JSON e legendas
Extrair tópicos, insights, frases de efeito, controvérsias e itens de ação a partir de texto existenteinsight-extractorResumo de insights com localização de fontes
Cortar clipes curtos de vídeos longos por tópico, falante ou intervalo de tempovideo-clipperLista de seleções e clipes de corte bruto
Remover regravações, repetições e frases incompletas, mantendo expressões completasspeech-video-dedupCandidatos de deduplicação, pré-visualização de verificação ou vídeo completo limpo
Reagrupar legendas existentes em frases curtas com base no significadosubtitle-resegmentNovo SRT de frases curtas
Avaliar atratividade da abertura, progressão do conteúdo e gatilhos de interaçãoclip-quality-monitorDiagnóstico de roteiro com base no texto original
Usar explicitamente o ChatCut ou continuar seu fluxo de trabalhoGuia oficial do ChatCut talking-head-guide e Skills correspondentesEdição dentro do fluxo de trabalho, legendas ou empacotamento conforme solicitado pelo usuário

A entrada local do Desktop do ChatCut geralmente está em ~/.agents/skills/chatcut-talking-head-guide/SKILL.md; priorize a versão oficial já fornecida na sessão atual.

Esclarecimento do Escopo da Tarefa

  • Quando ferramentas, fluxos de trabalho, caminhos de materiais, seleções ou métodos de corte já existirem, continue usando-os. Não altere a escolha do usuário apenas porque uma ferramenta está disponível.
  • Solicitações como "apenas transcreva", "apenas avalie" ou "procure repetições" devem realizar apenas o trabalho correspondente, sem expandir para um vídeo completo.
  • Apenas para solicitações com objetivo insuficiente, como "me ajude a editar", primeiro confirme se o usuário deseja manter a narrativa completa e limpá-la, ou extrair clipes curtos de um vídeo longo. Quando faltarem materiais, primeiro verifique o caminho do usuário e o contexto do projeto, depois solicite as informações necessárias.
  • Quando faltar uma capacidade local, primeiro pesquise no diretório de trabalho atual; não use uma cópia global com o mesmo nome, nem baixe ou reinstale automaticamente. Para dependências oficiais do ChatCut, procure no plugin ou na fonte complementar do Desktop.

Orquestração de Tarefas Combinadas

Cortar Clipes Curtos de Vídeo Longo

Execute na ordem necessária: video-to-text → insight-extractor → video-clipper. Pule os estágios já satisfeitos quando transcrição, resumo ou intervalos de tempo claros já existirem. A verificação de integridade da seleção e a confirmação são de responsabilidade do video-clipper.

Corte bruto e remoção de silêncio não equivalem à deduplicação semântica ter sido concluída. Quando o usuário solicitar "também limpe cada clipe", encadeie com speech-video-dedup; se não solicitado, não adicione edição de refinamento.

Deduplicação de Fala ou Curso Completo

Use speech-video-dedup para verificar o vídeo inteiro e os cortes. Quando for necessária transcrição, chame video-to-text de forma unificada; a reutilização e a escolha do backend seguem o contrato de transcrição compartilhado, e a deduplicação não mantém um segundo fluxo de reconhecimento. Quando o usuário não solicitar, não comprima um curso completo em vídeos curtos.

Legendas e Diagnóstico de Qualidade

Quando forem necessárias legendas, primeiro determine a edição final, depois obtenha o SRT correspondente à linha do tempo do vídeo final e os tempos de palavra necessários, e finalmente chame subtitle-resegment. Quando houver apenas a transcrição do vídeo original, é necessário mapear e converter de acordo com a edição real ou retranscrever o vídeo final; não reutilize diretamente.

O clip-quality-monitor pode ser usado para auxiliar no julgamento durante a seleção, ou para diagnóstico de roteiro após a edição; ele fornece sugestões apenas com base no texto, não indicando que a reprodução real, o áudio/vídeo ou o efeito na plataforma foram verificados.

Especificar ChatCut

Quando o usuário escolher o ChatCut, use seu fluxo de trabalho oficial para concluir o objetivo, não edite externamente primeiro e depois importe sem permissão. Quando for necessária análise de texto, use capacidades de extração de insights ou diagnóstico de qualidade no mesmo nível.

Quando o usuário especificar explicitamente o Desktop ou um projeto local, use as ferramentas do Desktop; quando especificar um projeto em nuvem, use a conexão correspondente. Quando ambos estiverem disponíveis e a afiliação do projeto não estiver clara, primeiro verifique o contexto do projeto; se ainda houver dúvida, pergunte. Primeiro determine a linha do tempo da fala, depois produza as legendas, trilha sonora e empacotamento visual solicitados pelo usuário.

Conexão de Resultados

  • Determine um diretório de resultados para esta tarefa, que será usado em todos os estágios. As regras de diretório, reutilização de transcrição e unificação da base de tempo seguem a camada compartilhada; não recrie o espaço de trabalho em cada estágio.
  • Transmita a identidade do arquivo de origem, a cobertura da transcrição e o mapeamento de edição real entre os estágios, evitando que timestamps de um estágio sejam confundidos com timestamps de outro estágio.
  • Siga as regras de proteção, confirmação e exportação do vídeo original de cada capacidade, retendo as seleções e pontos de corte já confirmados nesta tarefa.

Entrega

Forneça os resultados solicitados e seus caminhos abertos, explicando quais capacidades foram usadas e qual escopo foi processado. Relate a integridade da seleção, a verificação de pontos de conexão e imagem, a verificação técnica e o diagnóstico de roteiro de acordo com o nível real de conclusão; o cumprimento de um item não significa que os outros foram verificados.

Individual skills in this repo

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

Habilidades Relacionadas