Vai al contenuto principale

Compila le release notes automaticamente con l'IA

Al termine di questa recipe avrai un'automazione che, a fine di ogni sprint, raccoglie tutto ciò che hai shippato dal board, redige release notes curate raggruppate in New, Improved e Fixed, e le lascia in un documento perché una persona le revisioni e le pubblichi. Scrivere le release notes è un peso perché le informazioni ci sono già — sparse sulle righe che hai chiuso in questo sprint. Poiché lavoro shippato e chat del team vivono nello stesso workspace, l'IA può leggere quell'attività reale e narrarla, invece di ricostruire la release a memoria un venerdì pomeriggio.

Prontezza: Disponibile ora (costruita come un'Automazione). La versione in cui un singolo collega con un nome proprio gestisce il rituale delle release notes end to end — compilazione, bozza e sollecito a pubblicare — è in early access.

Cosa fa​

Il compiler delle release notes è un'automazione con una persona in mezzo:

  1. Gira su uno schedule — ad esempio alle 16:00 l'ultimo giorno di ogni sprint (o ogni venerdì, o il primo del mese per un changelog mensile).
  2. Raccoglie cosa è stato shippato dal board: le righe che hanno raggiunto uno status Shipped, Released o Done dall'edizione precedente. Puoi estrarre da un board o da più (prodotto, mobile, platform) nella stessa esecuzione.
  3. Redige le note con un passaggio IA — un header di versione, un breve intro e sezioni raggruppate per New, Improved e Fixed — ogni item riscritto in linguaggio semplice e rivolto al cliente, non con il titolo grezzo del ticket interno.
  4. Salva la bozza come documento nella cartella Releases e pinga il release owner con il link.
  5. Una persona revisiona, affina e pubblica. L'IA fa la raccolta e la prima bozza; una persona firma comunque il testo prima che arrivi ai clienti.

Tenere lo step di publish in mano umana è ciò che rende sicuro far girare tutto senza sorveglianza ogni sprint — la parte noiosa (trovare cosa è shippato, scrivere il primo passaggio, raggruppare) è automatizzata, e il giudizio resta tuo.

Costruiscilo tu​

Setup una tantum​

Prepara il board su cui il lavoro vive già

Non ti serve un board nuovo — ti serve che quello su cui si traccia il lavoro di engineering porti tre cose che il compiler legge:

  • Status — con un valore terminale da cui nasce la release, ad esempio Shipped, Released o Done.
  • Type (o Category) — New, Improved, Fixed (aggiungi Security o Deprecated se li usi). È ciò su cui le note si raggruppano.
  • Shipped Date — una colonna data su cui il compiler filtra, così ogni edizione copre esattamente un periodo.

Se gli item arrivano a "shipped" senza una data affidabile, aggiungi una piccola automazione di supporto: un trigger Campo modificato su Status e un'azione Imposta data a ora che timbra Shipped Date nel momento in cui una riga passa a Shipped. Così il filtro data del compiler è sempre accurato.

L'automazione​

Trigger: Schedule

In Automazioni, avvia un flusso con un trigger Schedule impostato sulla cadenza di release — ad esempio 16:00 l'ultimo giorno di ogni sprint. Questo unico trigger trasforma le release notes in un rituale fisso invece che in un task che qualcuno deve ricordarsi di fare.

Azione: Trova le righe shippate di questa release

Aggiungi un'azione Trova righe sul board che restituisce le righe di questa edizione — ad esempio dove Status è Shipped (o Released/Done) e Shipped Date è nelle ultime due settimane. Usa un filtro riga per combinare quelle condizioni. Shipi su più board? Aggiungi un passaggio Trova righe per board — uno per web, uno per mobile, uno per platform — così una sola esecuzione copre l'intera release.

Transform: Assembla la lista

Aggiungi una transform Join per unire le righe trovate in un'unica lista pulita e leggibile su cui l'IA possa lavorare. Preferisci controllare la forma di ogni riga (ad esempio [Type] Title — description)? Usa invece una transform di templating, così ogni item arriva all'IA in un formato coerente.

Passaggio IA (opzionale): Classifica ogni item per tipo

Se il board non ha già una colonna Type, aggiungi un passaggio IA → Classifica che ordina ogni item in New, Improved o Fixed. Salta questo passaggio se le righe sono già tipizzate — il passaggio Genera può raggruppare direttamente sulla colonna esistente.

Passaggio IA: Redigi le release notes

Aggiungi un passaggio IA → Genera che scrive le note da quella lista: un header di versione, un intro di un paragrafo sul tema della release e una sezione per tipo con ogni change come bullet in linguaggio semplice. Dagli la tua voce nel prompt — "benefit-first, niente gergo interno, seconda persona, ~250 parole" — così la prima bozza legge già come il tuo changelog. La vuoi in più di una lingua? Aggiungi un passaggio IA → Traduci per produrre una variante per ogni locale.

Azione: Salvala come documento da revisionare

Aggiungi un'azione Crea documento che salva la bozza nella cartella Releases. È la copia di lavoro editabile del release owner — il primo passaggio dell'IA, pronto perché una persona lo stringa e lo approvi.

Azione: Di' al team che è pronta

Aggiungi un'azione Pubblica messaggio nel canale nel canale #product o #releases — "📝 le release notes di v2.4 sono in bozza e pronte da revisionare" con il link al documento preso dal passaggio precedente. Preferisci pingare una sola persona? Usa invece Invia messaggio diretto al release owner.

suggerimento

Annunci ai clienti, non solo al team? Tieni l'invio dietro una persona. Aggiungi un'azione Invia o bozza email in modalità bozza verso gli stakeholder, o un passaggio di richiesta di approvazione umana che mette in pausa l'automazione finché qualcuno non approva — così la bozza interna è automatica, ma nulla di esterno parte finché una persona non firma il testo.

Oppure chiedilo a Copera AI​

Non devi assemblare il grafo a mano. Apri Ask Copera AI e descrivilo:

"Sul nostro Engineering board, aggiungi una colonna Shipped Date e una colonna Type con New, Improved e Fixed. Poi costruisci un'automazione che l'ultimo giorno di ogni sprint trova tutto ciò che è stato shippato nelle ultime due settimane, redige release notes raggruppate per tipo in linguaggio semplice e rivolto al cliente, le salva come documento nella cartella Releases e pubblica un messaggio nel canale #product con il link così posso revisionare e pubblicare."

Ask Copera AI può creare le colonne, poi assemblare l'automazione per te. Con la modalità di permesso predefinita Ask before acting, mostra una card di review per ogni modifica prima che venga creata — così approvi le colonne e l'automazione prima che esistano. Vedi Cosa può fare Copera AI per l'elenco completo di ciò che può costruire.

Vuoi le note subito invece che su uno schedule? Chiedi on demand: "Leggi il nostro Engineering board e scrivi le release notes di tutto ciò che è marcato Shipped in questo sprint, raggruppate in New, Improved e Fixed, poi salvale come documento." Legge il board, redige le note e — con Ask before acting attivo — ti mostra la bozza su una card di review, con un elenco Sources delle righe esatte da cui ha attinto, prima di creare qualsiasi cosa.

Fallo diventare un collega fisso​

Early access

I colleghi IA fissi stanno arrivando gradualmente. Quando uno è disponibile nel tuo workspace, puoi mettere un singolo collega con un nome proprio — un "Release Manager" — a capo dell'intero rituale: osserva gli item che raggiungono Shipped sui board durante lo sprint, redige le release notes da revisionare, le salva come documento e pubblica un avviso interno che sono pronte, tutto sul proprio schedule e con la propria identità. La pubblicazione verso i clienti resta umana — un collega redige e posta dentro il workspace ma non invia mai all'esterno da solo. Se non vedi ancora i colleghi, stanno arrivando — tutto in questa guida si può costruire oggi come Automation.

Consigli​

suggerimento

Dai a ogni riga una buona frase. Le note valgono quanto le righe sotto. Una riga intitolata "Fix" produce un bullet debole; una riga la cui descrizione dice cosa è cambiato e a chi serve ne produce uno ottimo. L'IA riscrive per tono, ma non può inventare la sostanza — un body di riga chiaro è l'abitudine a più alto leverage per buone release notes.

suggerimento

Delimita ogni edizione con una colonna Version. Aggiungi una colonna Version e stampala quando il lavoro viene shippato (un'azione Imposta campo sull'automazione di supporto lo fa). Poi il filtro Trova righe del compiler può estrarre "tutto ciò che è taggato v2.4", così un'edizione mappa in modo pulito a una release invece che a una finestra data scorrevole.

suggerimento

Prima bozza a te, poi accendi. Punta l'annuncio ai tuoi DM per i primi un paio di sprint. Quando le note leggono come le scriveresti tu, cambia la destinazione al canale #product e lasciala girare senza sorveglianza.

suggerimento

Compila anche dalla release meeting. Se fai una sprint review, attiva un'automazione companion su Trascrizione completa, aggiungi un passaggio Carica contesto meeting e un passaggio IA → Estrai per tirare fuori dalla conversazione i momenti "cosa abbiamo shippato", e piegali nella bozza. Così le note riflettono sia il board sia ciò che il team ha davvero messo in evidenza in sala. Vedi Meeting Transcription.

suggerimento

Imposta un tetto di spesa. Poiché il passaggio Genera (e Classifica o Traduci, se presenti) consuma usage IA, dai all'automazione un tetto di spesa per automazione così una release pesante non può mai superare il budget che scegli. La dashboard di usage mostra esattamente dove vanno i crediti.

Domande frequenti​

Copera può compilare le release notes automaticamente?​

Sì. Un'automazione schedulata usa un'azione Trova righe per estrarre tutto ciò che hai shippato in questo periodo, un passaggio IA Genera trasforma quelle righe in note curate raggruppate in New, Improved e Fixed, e un'azione Crea documento salva la bozza. Può anche pubblicare un annuncio nel canale di prodotto. Poiché il lavoro shippato vive già su un board, l'IA scrive da dati reali.

Scrive note amichevoli per i clienti o elenca solo i titoli dei ticket?​

Le riscrive. Il passaggio IA Genera prende titoli e descrizioni interni e produce un linguaggio semplice e orientato al beneficio, raggruppato per tipo, con un header di versione e un breve intro — non un elenco grezzo di nomi di ticket. Imposti la voce nel prompt.

Da dove arrivano gli item shippati?​

Dal tuo board — le righe che hanno raggiunto uno status Shipped, Released o Done, filtrate per una data di ship. Punta il passaggio Trova righe al board degli issue, al board di prodotto o a un board Releases dedicato. Una sola esecuzione può coprire più board.

Posso revisionare le note prima che vengano pubblicate?​

Sì, ed è il pattern consigliato. Crea documento salva una bozza editabile, un'email può essere preparata in modalità bozza invece che inviata, e un passaggio di richiesta di approvazione umana può mettere in pausa l'automazione finché qualcuno non dà l'ok — così nulla rivolto ai clienti esce senza revisione.

Può raggruppare le modifiche per tipo e versione?​

Sì. Se il board ha una colonna Type, le note si raggruppano direttamente su di essa; se no, un passaggio IA Classifica ordina prima ogni item in New, Improved o Fixed. Aggiungi una colonna Version e filtra su di essa così ogni edizione copre esattamente una release.

Può costruire le release notes dalla mia attività su GitHub?​

Copera compila le release notes dal tuo board — le righe che segni come shippate. Se tracci il lavoro di engineering in Copera (o rispecchi gli issue su un board), il compiler ha tutto ciò che serve. Il connettore GitHub può creare issue da un'automazione, ma leggere le pull request per generare note in automatico non è ancora disponibile, quindi il board è la fonte affidabile. Vedi Connettori.

Correlati​