用途:为已打标签的 NemoClaw 版本起草发布公告(post-tag Announcement)。技能读取 GitHub 标签与 compare 数据,生成可供维护者手动发布到 GitHub Discussion 的本地 Markdown 草稿,并返回草稿路径与建议讨论标题“NemoClaw <current-version> is out.”。
主要能力:核对发布区间(git ls-remote 确认 <current-version>^{} 指向目标提交,compare 范围为 <previous-version>...<current-version>);用 gh api compare 收集提交、文件与 PR 信息,用 gh pr view 补充 PR 元数据;按文档写作与评审约定组织内容:三段叙述开头、分类的已发布变更列表(每条说明改了什么、为何重要)、外链 PR 编号、仅致谢外部贡献者。
前置条件:需在 NemoClaw 仓库内;gh 已对 NVIDIA/NemoClaw 认证;发布标签已存在;被标记提交应在 docs/changelog/YYYY-MM-DD.mdx 中恰好含一个当前版本条目;须使用真实 GitHub 与远程标签状态。
使用方式:先确认标签与区间,再采集已发布面,判断收录项并按 4–6 个分类归类,处理贡献者署名,撰写叙述,最后把草稿写到检出目录之外(如 ../nemoclaw-release-vX.Y.Z/release-note-draft.md)。常用命令保持原样,如:git ls-remote https://github.com/NVIDIA/NemoClaw.git refs/heads/main refs/tags/<previous-version> 'refs/tags/<previous-version>^{}' refs/tags/<current-version> 'refs/tags/<current-version>^{}';gh api repos/NVIDIA/NemoClaw/compare/<previous-version>...<current-version>;gh pr view <number> --repo NVIDIA/NemoClaw --json number,title,author,headRepositoryOwner,url,mergeCommit,labels,body,mergedAt。判断外部贡献者可用 gh api -i orgs/NVIDIA/members/<login>(204 为可见成员,404 视为外部)。
适用场景:维护者汇总某次版本发布、生成公告草稿、整理已发布 PR 与贡献者致谢。
限制:不得创建或更新 GitHub Discussion;不得凭记忆起草;默认只致谢外部贡献者,不提组织或归属;公开公告不得包含候选 SHA、镜像标识、E2E 结果、重跑细节或异常原因;测试回滚不计入发布价值条目;不重写无关历史发布文本;不创建或静默修复 docs/changelog/,若缺少规范条目应报告流程缺陷并按 nemoclaw-maintainer-evening 恢复。