用途:从仓库证据起草 NeMo Relay 当前文档的 release-notes 页面,完整、逐 PR 的发布历史仍保留在 GitHub Releases 中。
主要能力:通过只读脚本对比发布引用,检查两个 ref、比较其 release-notes 目录树、识别页面中已有的版本文本,并将提交分组为待审候选。分组仅作为证据索引,不是可直接发布的文案。
使用方式:运行只读辅助脚本,需显式指定发布引用与目标次版本:
python3 .agents/skills/draft-release-notes/scripts/collect_release_evidence.py
--previous release/<previous-major>.<previous-minor>
--current HEAD
--version <major>.<minor>
工作流:从发布分支与包元数据确认目标版本,保留无关的工作区改动;运行脚本(早期发布分支缺少先前 release-notes 目录属预期,不会失败);在变更的公开文档、API 类型、命令帮助或源码中逐条核实候选声明,优先处理破坏性变更、迁移、用户可见功能与持续支持限制;更新 docs/about-nemo-relay/release-notes/index.mdx,除非该发布更改了其路由或导航项;保留页面现有结构(发布摘要与亮点、兼容性或迁移说明、已知问题、上一版本链接、相关主题),仅在有助于现有页面时使用表格或提示框;保留 MDX front matter 与 JSX SPDX 注释;说明完整历史见 GitHub Releases,不要用本技能创建 changelog 或 GitHub Release 正文。
验证:对目标发布运行脚本,必要时对无 release notes 的早期分支运行;审阅公开声明后运行: git diff --check just docs 交付前对照当前仓库检查产品名、命令、包名、支持声明与链接。
限制:仅用于文档 release-notes 页面,不用于 GitHub Release 正文;候选分组需人工核实后方可采用。