请问HN:你们是如何自动化生成发布说明的?
你们在项目中是如何生成发布说明的?<p>我刚刚为一个开源项目补充了一年的文档发布说明。我最终写了一个小型的基于发布标签的生成器:它遍历 Git 标签,收集版本之间合并的 PR,将它们分类,并按年份 -> 月份 -> 类别 -> 版本的顺序渲染 Markdown/MDX。我还添加了一个可选的 LLM 步骤,通过 Pydantic 模式输出结构化 JSON,包括每月摘要的 PR 要点。这个过程是幂等的,并且保留了手动编辑或遗漏的内容,因此你可以自动生成,然后随着时间的推移进行整理。<p>我很好奇你们在实践中使用的工具是什么:<p>- Towncrier?<p>- reno?<p>- GitHub Releases / 自动生成的说明?<p>- 其他工具?<p>你对当前的设置有什么喜欢或不喜欢的地方?有什么工具推荐吗?<p>如果有人想看看我写的脚本,我很乐意分享,并希望能得到一些建设性的反馈。
查看原文
How are you generating release notes in your projects?<p>I just had to backfill a year of docs release notes for an OSS repo. I ended up writing a small release tag driven generator: it walks git tags, collects merged PRs between releases, buckets them into categories, and renders Markdown/MDX grouped by year -> month -> category -> version. I also added an optional LLM step that outputs structured JSON via Pydantic schema for PR bullets that includes monthly summaries. It is idempotent and preserves manual edits or omissions, so you can auto-generate, then curate over time.<p>I’m curious what works for you in practice:<p>- Towncrier?<p>- reno?<p>- GitHub Releases / auto-generated notes?<p>- something else?<p>What do you like/hate about your current setup? Any tools you’d recommend?<p>If anyone wants to see the script I wrote, I am happy to share it and would love some constructive feedback.