Pular para o conteúdo principal

Compile as Notas de Versão Automaticamente com IA

Ao final desta receita, você terá uma automação que, no fim de cada sprint, reúne tudo o que você entregou a partir do seu board, redige notas de versão bem-acabadas e agrupadas em Novo, Melhorado e Corrigido, e as coloca em um documento para uma pessoa revisar e publicar. Escrever notas de versão é uma tarefa maçante porque a informação já está ali — espalhada pelas linhas que você fechou neste sprint. Como o seu trabalho entregue e o chat do seu time vivem no mesmo espaço de trabalho, a IA consegue ler essa atividade real e narrá-la, em vez de você reconstruir a versão de memória numa sexta-feira à tarde.

Disponibilidade: Disponível agora (construído como uma Automation). A versão em que um único colega de equipe com nome próprio cuida do ritual das notas de versão de ponta a ponta — compilando, redigindo e cutucando você para publicar — está sendo lançada em acesso antecipado.

O que ele faz​

O compilador de notas de versão é uma única automação com uma pessoa no meio:

  1. Ele roda em um agendamento — digamos, às 16h do último dia de cada sprint (ou toda sexta-feira, ou no primeiro dia do mês para um changelog mensal).
  2. Ele reúne o que foi entregue a partir do seu board: as linhas que alcançaram um status Entregue, Lançado ou Concluído desde a última edição. Você pode puxar de um único board ou de vários (produto, mobile, plataforma) na mesma execução.
  3. Ele redige as notas com uma etapa de IA — um cabeçalho de versão, uma breve introdução e seções agrupadas por Novo, Melhorado e Corrigido — com cada item reescrito em linguagem simples e voltada ao cliente, não o título interno do ticket cru.
  4. Ele salva o rascunho como um documento na sua pasta de Releases e avisa a pessoa responsável pela versão com o link.
  5. Uma pessoa revisa, lapida e publica. A IA faz a coleta e o primeiro rascunho; uma pessoa ainda dá o aval ao texto antes de ele chegar aos clientes.

Manter a etapa de publicação nas mãos de uma pessoa é o que torna isso seguro para rodar sem supervisão a cada sprint — a parte chata (encontrar o que foi entregue, escrever a primeira versão, agrupar) fica automatizada, e a decisão de julgamento continua com você.

Construa você mesmo​

Configuração inicial (uma única vez)​

Prepare o board onde o seu trabalho já vive

Você não precisa de um board novo — você precisa que aquele onde o trabalho de engenharia é registrado carregue três coisas que o compilador lê:

  • Status — com um valor terminal a partir do qual a versão é construída, como Entregue, Lançado ou Concluído.
  • Tipo (ou Categoria) — Novo, Melhorado, Corrigido (adicione Segurança ou Descontinuado se você os usa). É por isso que as notas são agrupadas.
  • Data de entrega — uma coluna de data pela qual o compilador filtra para que cada edição cubra exatamente um período.

Se os itens chegam a "Entregue" sem uma data confiável, adicione uma pequena automação de apoio: um gatilho de Campo alterado monitorando o Status e uma ação de Definir data como agora que carimba a Data de entrega no instante em que uma linha vira Entregue. Agora o filtro de data do compilador está sempre correto.

A automação​

Gatilho: Agendamento

Em Automations, inicie um fluxo com um gatilho de Agendamento configurado para a sua cadência de versões — por exemplo, 16h do último dia de cada sprint. Esse único gatilho é o que transforma as notas de versão em um ritual permanente em vez de uma tarefa que alguém precisa lembrar de fazer.

Ação: Encontre as linhas entregues desta versão

Adicione uma ação de Encontrar linhas no seu board que retorne as linhas desta edição — por exemplo, onde Status é Entregue (ou Lançado/Concluído) e Data de entrega está nas últimas duas semanas. Use um filtro de linha para combinar essas condições. Entrega em vários boards? Adicione uma etapa de Encontrar linhas por board — uma para web, uma para mobile, uma para plataforma — para que uma única execução cubra a versão inteira.

Transformação: Monte a lista

Adicione uma transformação de Juntar para combinar as linhas encontradas em uma lista limpa e legível com a qual a IA possa trabalhar. Prefere controlar o formato de cada linha (digamos, [Tipo] Título — descrição)? Use, em vez disso, uma transformação de modelo, para que cada item chegue à IA em um formato consistente.

Etapa de IA (opcional): Classifique cada item por tipo

Se o seu board ainda não tem uma coluna de Tipo, adicione uma etapa de IA → Classificar que organiza cada item em Novo, Melhorado ou Corrigido. Pule esta etapa se as suas linhas já têm tipo — a etapa Gerar pode agrupar pela sua coluna existente diretamente.

Etapa de IA: Redija as notas de versão

Adicione uma etapa de IA → Gerar que escreve as notas a partir dessa lista: um cabeçalho de versão, uma introdução de um parágrafo sobre o tema da versão e uma seção por tipo com cada mudança como um item em linguagem simples. Dê a sua voz no prompt — "foco no benefício, sem jargão interno, segunda pessoa, ~250 palavras" — para que o primeiro rascunho já leia como o seu changelog. Quer em mais de um idioma? Adicione uma etapa de IA → Traduzir para produzir uma variante para cada idioma.

Ação: Salve como um documento para revisão

Adicione uma ação de Criar documento que salva o rascunho na sua pasta de Releases. Esta é a cópia de trabalho editável da pessoa responsável pela versão — o primeiro rascunho da IA, pronto para uma pessoa refinar e aprovar.

Ação: Avise o time que está pronto

Adicione uma ação de Postar mensagem no canal no seu canal #produto ou #lancamentos — "📝 as notas de versão da v2.4 estão em rascunho e prontas para revisão" com o link do documento puxado da etapa anterior. Prefere avisar uma só pessoa? Use um Enviar mensagem direta para a pessoa responsável pela versão.

dica

Vai anunciar para os clientes, não só para o time? Mantenha o envio nas mãos de uma pessoa. Adicione uma ação de Enviar ou redigir e-mail em modo rascunho apontada para as partes interessadas, ou uma etapa de solicitação de aprovação humana que pausa a automação até alguém aprovar — assim, o rascunho interno fica automatizado, mas nada externo é enviado até uma pessoa dar o aval ao texto.

Ou simplesmente peça para a Copera AI​

Você não precisa montar o grafo na mão. Abra o Ask Copera AI e descreva tudo:

"No nosso board de Engenharia, adicione uma coluna de Data de entrega e uma coluna de Tipo com Novo, Melhorado e Corrigido. Depois crie uma automação que, no último dia de cada sprint, encontre tudo o que foi entregue nas últimas duas semanas, redija notas de versão agrupadas por tipo em linguagem simples e voltada ao cliente, salve como um documento na nossa pasta de Releases e poste uma mensagem no canal #produto com o link para eu revisar e publicar."

O Ask Copera AI pode criar as colunas e depois montar a automação para você. Com o modo de permissão padrão Perguntar antes de agir, ele mostra um cartão de revisão para cada mudança antes de qualquer coisa ser criada — então você aprova as colunas e a automação antes de elas existirem. Veja O Que a Copera AI Pode Fazer para a lista completa do que ele consegue construir.

Quer as notas agora mesmo em vez de em um agendamento? Peça sob demanda: "Leia o nosso board de Engenharia e escreva as notas de versão de tudo o que está marcado como Entregue neste sprint, agrupadas em Novo, Melhorado e Corrigido, e depois salve como um documento." Ele lê o board, redige as notas e — com o Perguntar antes de agir ativado — mostra o rascunho em um cartão de revisão, com uma lista de Fontes de exatamente quais linhas ele usou, antes de criar qualquer coisa.

Transforme em um colega de equipe permanente​

Acesso antecipado

Os AI teammates permanentes estão sendo lançados aos poucos. Quando um estiver disponível no seu espaço de trabalho, você pode colocar um único colega de equipe com nome próprio — um "Release Manager" — no comando de todo o ritual: ele fica de olho nos itens chegando a Entregue nos seus boards ao longo do sprint, redige as notas de versão para revisão, as salva como um documento e posta um aviso interno de que elas estão prontas, tudo no seu próprio agendamento e sob a sua própria identidade. A publicação voltada ao cliente continua com uma pessoa — um colega de equipe redige e posta dentro do seu espaço de trabalho, mas nunca envia nada para fora por conta própria. Se você ainda não vê os colegas de equipe, eles estão a caminho — tudo neste guia pode ser construído hoje como uma Automation.

Dicas​

dica

Dê a cada linha uma boa frase. As notas são tão boas quanto as linhas que as sustentam. Uma linha intitulada "Fix" produz um item fraco; uma linha cuja descrição diz o que mudou e quem ela ajuda produz um item ótimo. A IA reescreve o tom, mas não consegue inventar a substância — um corpo de linha claro é o hábito de maior impacto para boas notas de versão.

dica

Delimite cada edição com uma coluna de Versão. Adicione uma coluna de Versão e a preencha quando o trabalho é entregue (uma ação de Definir campo na sua automação de apoio faz isso). Então o filtro de Encontrar linhas do compilador pode puxar "tudo marcado como v2.4", de modo que uma edição corresponde de forma limpa a uma versão em vez de a uma janela de datas móvel.

dica

Primeiro mande para você mesmo, depois ative de vez. Aponte o anúncio para as suas próprias mensagens diretas nos primeiros sprints. Quando as notas estiverem lendo do jeito que você escreveria, mude o destino para o seu canal #produto e deixe rodar sem supervisão.

dica

Compile também a partir da sua reunião de versão. Se você faz um sprint review, dispare uma automação complementar com Transcrição concluída, adicione uma etapa de Carregar contexto da reunião e uma etapa de IA → Extrair para tirar da conversa os momentos de "o que entregamos" e incorpore-os ao rascunho. Agora as notas refletem tanto o board quanto o que o time realmente destacou na sala. Veja Meeting Transcription.

dica

Defina um limite de gasto. Como a etapa de Gerar (e qualquer Classificar ou Traduzir) consome uso de IA, dê à automação um limite de gasto por automação para que uma versão pesada nunca ultrapasse o orçamento que você escolher. O painel de uso mostra exatamente para onde vão os créditos.

Perguntas Frequentes​

O Copera pode compilar notas de versão automaticamente?​

Sim. Uma automação agendada usa uma ação de Encontrar linhas para puxar tudo o que você entregou neste período, uma etapa de IA Gerar transforma essas linhas em notas bem-acabadas e agrupadas em Novo, Melhorado e Corrigido, e uma ação de Criar documento salva o rascunho. Ela também pode postar um anúncio no seu canal de produto. Como o seu trabalho entregue já vive em um board, a IA escreve a partir de dados reais.

Ela escreve notas amigáveis para o cliente ou só lista títulos de tickets?​

Ela as reescreve. A etapa de IA Gerar pega os seus títulos e descrições internos e produz uma linguagem simples e com foco no benefício, agrupada por tipo, com um cabeçalho de versão e uma breve introdução — não uma lista crua de nomes de tickets. Você define a voz no prompt.

De onde vêm os itens entregues?​

Do seu board — as linhas que alcançaram um status Entregue, Lançado ou Concluído, filtradas por uma data de entrega. Aponte a etapa de Encontrar linhas para o seu board de issues, o seu board de produto ou um board de Releases dedicado. Uma única execução pode abranger vários boards.

Posso revisar as notas antes de elas serem publicadas?​

Sim, e é o padrão recomendado. Criar documento salva um rascunho editável, um e-mail pode ser preparado em modo rascunho em vez de enviado, e uma etapa de solicitação de aprovação humana pode pausar a automação até alguém dar o aval — assim, nada voltado ao cliente sai sem revisão.

Ela consegue agrupar as mudanças por tipo e versão?​

Sim. Se o seu board tem uma coluna de Tipo, as notas se agrupam por ela diretamente; se não, uma etapa de IA Classificar organiza primeiro cada item em Novo, Melhorado ou Corrigido. Adicione uma coluna de Versão e filtre por ela para que cada edição cubra exatamente uma versão.

Ela consegue criar as notas de versão a partir da minha atividade no GitHub?​

O Copera compila as notas de versão a partir do seu board — as linhas que você marca como entregues. Se você registra o trabalho de engenharia no Copera (ou espelha os seus issues em um board), o compilador tem tudo o que precisa. O conector do GitHub pode criar issues a partir de uma automação, mas ler pull requests para gerar notas automaticamente ainda não está disponível, então o seu board é a fonte confiável. Veja Connectors.

Relacionados​