Communitygithub.com

federicobrancasi/pr-studio

Use quando o usuário deseja um vídeo que explique um pull request (um explicador de PR, um vídeo de revisão, 'faça um vídeo para <URL do PR>'). Abrange todo o fluxo de trabalho neste repositório – buscar o PR, escrever a narração, a voz, escolher e preencher os diagramas, verificações, renderização, aprovação do diretor de PR e entrega.

O que é pr-studio?

Esta skill cria vídeos explicativos curtos (40-100 segundos) de pull requests, voltados para gerentes ou pessoas que não lerão o PR em detalhes. O fluxo completo é automatizado via CLI (comandos como `prs new`, `prs check`, `prs voice`, etc.) e inclui: busca dos dados do PR, elaboração de um storyboard com evidências, geração de narração (com suporte a voz local ou Azure), escolha de tratamentos visuais, renderização de imagens-chave e verificação de linting. A skill prioriza precisão total (cada declaração deve vir do PR, sem achismos) e variedade visual (evitando layouts repetidos de vídeos anteriores). Após a renderização, é necessária aprovação do agente `pr-director`; o resultado é entregue em mp4 com legendas e um resumo por batida. Ideal para equipes que usam GitHub Actions, Slack ou sessões em nuvem, com suporte a modos não supervisionados e orçamento de tempo (59 minutos em sessão Slack).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/federicobrancasi/pr-studio/tree/HEAD/.claude/skills/pr-video

Perguntar na sua IA favorita

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

Documentação

Vídeo de PR

Um explicador de 40 a 100 segundos de um pull request, para alguém que não o lerá (geralmente um gerente): o que mudou, por que, como funciona, o que é arriscado, o status e por onde um revisor deve começar. Técnico, mas simples. Tudo é executado via CLI: node cli/prs.mjs <comando> a partir da raiz do repositório, ou node <caminho para pr-studio>/cli/prs.mjs <comando> de qualquer lugar (abaixo: prs).

Início

  • Ninguém assistindo (um job do GitHub Actions)? Leia guides/unattended.md primeiro: sem perguntas, um limite de tempo, uma rodada de revisão, para onde o resultado vai.
  • Iniciado pelo Slack (@GitHub, uma sessão em nuvem)? Leia guides/slack.md primeiro: triagem, o orçamento de 59 minutos, postar cada vídeo na thread, e o que não fazer lá.
  • Uma vez por máquina: prs doctor (navegador, modelo de voz, Whisper, ffmpeg; ele apenas adiciona o que está faltando).
  • Depois leia guides/story.md e guides/visuals.md. Folheie catalog.md para ver os diagramas disponíveis.

Fluxo de trabalho (mire em 15-20 minutos)

  1. Buscar. prs new <URL do PR> escreve videos/<slug>/: brief.md (leia tudo), pr.diff (pesquise as linhas necessárias; não leia por inteiro), pr.json e um esqueleto de storyboard com o número certo de batidas.
  2. História. Escreva videos/<slug>/storyboard.json: uma ideia por batida, uma need por batida, pistas e as afirmações com evidências (guides/story.md). Execute prs check até que ele diga pronto para prs voice.
  3. Voz, em segundo plano. Inicie prs voice (cerca de um minuto; MAI-Voice-2 quando uma chave Azure estiver configurada, senão a voz Kokoro local) e continue trabalhando enquanto ele é executado.
  4. Direção. prs direct escolhe um tratamento para cada batida e o movimento do vídeo, escreve direction.json e gera o esqueleto de scenes.js com esses tratamentos. Preencha cada TODO a partir do PR. Mantenha as escolhas: elas são selecionadas para diferir de vídeos recentes. Se uma batida realmente não puder ser mostrada, reescolha-a com prs direct --use <batida>=<tratamento> --reason "..." (o motivo é registrado e revisado).
  5. Visual. prs stills renderiza quadros-chave e build/stills/contact.png. Abra a folha de contato e os quadros que importam e corrija o que vê. Os stills funcionam antes de a voz ficar pronta (timing provisório).
  6. Verificação. prs lint deve reportar 0 problemas (layout, proveniência do texto, faixa de legenda, novidade, QR).
  7. Renderizar e publicar. prs render (segundos, quadros em cache), depois prs publish: codificar, legendas, a verificação de sincronia (áudio vs legendas), entrega em ~/Downloads/pr-videos/<slug>/ e entrada na galeria.
  8. Aprovação. Siga guides/review.md até que o agente pr-director responda VEREDITO: APROVADO; republicar após correções.
  9. Entregar. Forneça o caminho do mp4, sua duração, um resumo de uma linha por batida, o veredito e o que você não pôde verificar (você não pode ouvir o áudio; a verificação de sincronia o mede).

Opcional: se o usuário pedir opções, adicione export const concepts = { beat, options: { a, b, c } } a scenes.js e execute prs concepts: ele renderiza a batida de três formas lado a lado.

Regras

  • Preciso ou ausente. Cada afirmação na narração e na tela deve vir do PR: seu corpo, commits, diff, testes ou código no commit head. Escreva as afirmações não testadas do autor como "de acordo com o autor". Sem suposições sobre intenção, sem marketing.
  • Proveniência do texto. O texto da tela passa por label() (suas palavras), fact() (números e nomes de pr.json), quote() (texto exato do PR), ident() (nomes de código no diff), path() e code(). prepare verifica cada um contra o PR; números em um label() são sinalizados.
  • Um visual. Branco, paleta Microsoft, Aptos. Não adicione cores, fontes, fundos ou novos layouts dentro de um vídeo. O primeiro quadro (título) e o cartão final são fixos.
  • Explicações diferentes. Nunca abra ou copie o scenes.js de outro vídeo; a galeria mantém apenas storyboards e folhas de contato. Se o catálogo não tiver um diagrama que o PR precisa, adicione um tratamento a catalog/ (com demo, when, parâmetros, um still do catálogo via prs catalog --stills, lint limpo) em vez de posicionar pixels manualmente.
  • Olhe o que você faz. Abra os stills e a folha de contato antes de dizer que algo funciona.

Comandos

prs new <url>buscar o PR, escrever brief.md e um esqueleto de storyboard
prs checkstoryboard: janela de duração, pistas, placeholders, âncoras de evidência, dicas de pronúncia
prs voice [--provider mai|kokoro|recording|silent]narração + timing das palavras (com pausas ajustadas)
prs direct [--use beat=treatment --reason ...]escolher tratamentos e movimento; gerar esqueleto de scenes.js
prs stills [--beat id] [--at 12.3,20]quadros-chave + folha de contato
prs lint [--every 0.5]layout, proveniência, faixa de legenda, novidade, QR
prs render / prs draftquadros finais / uma prévia mp4 com metade do tamanho
prs publishcodificar, legendas, verificação de sincronia, entrega, galeria
prs catalogtodos os tratamentos com seus parâmetros
prs triage <PRs> | --file f, prs summary, prs budgetquais PRs merecem um vídeo (execuções no Slack); a mensagem de encerramento; minutos restantes em uma sessão de nuvem
prs history, prs reportvídeos recentes; onde o tempo foi gasto
prs smokeum vídeo demo curto do início ao fim, com timings: esta máquina está pronta?

Habilidades Relacionadas