SuperAPI AI 工具集

draft-release-notes

写作与研究

查看项目

更新于 10-16 02:34

技能介绍

用途:为 NVIDIA NeMo Fabric 起草发布说明。以仓库中可验证的证据为依据,完整、按 tag 的发布历史放在 GitHub Releases;只有当文档可见的发布摘要发生变化时,才更新文档站发布说明页。

主要能力:提供只读证据收集脚本,比较发布引用、检查各引用上的发布说明页、识别版本文本并把提交分组为评审候选(仅作证据索引,非成稿文案);区分常规发布与补丁发布;可生成提交并推送、用 prepare-pr 技能开 PR。

使用方式:先确定发布分支与目标版本。用户给出版本时推导 release/<major>.<minor> 并切换;未给出则要求当前分支匹配 release/<major>.<minor>,不得从包元数据或 Git 历史推断发布线。从 Cargo.toml 读取目标版本,用户给出的版本须与包版本一致。随后运行: python3 .agents/skills/draft-release-notes/scripts/collect_release_evidence.py --previous <previous-release-tag-or-branch> --current HEAD --version <release-version> 补丁发布用上一个稳定 tag 作 --previous;新发布线用上一个发布分支或 tag。基于发布分支新建本地分支,例如:git switch -c "docs/create-release-notes-${TARGET_VERSION}" "${RELEASE_BRANCH}"。逐条核验候选结论(变更的公开文档、API 类型、命令帮助或源码),优先处理破坏性变更、迁移、用户可见功能和持续存在的支持限制。仅更新 docs/about-nemo-fabric/release-notes.mdx(除非发布改变了其路由或入口),保留 MDX front matter 与 JSX SPDX 注释,说明完整历史见 GitHub Releases,不创建 changelog;更新 README.md 的 Roadmap,移除本次发布已实现或修复的条目。校验:git diff --check、just docs。若上述文件有变更,用 git add/commit -sm 与 git push -u upstream HEAD 提交推送,并用 prepare-pr 开标题为 docs: Release notes for v${TARGET_VERSION} 的 PR;二者均无变更则跳过提交与 PR。

限制:不推断发布线,不替换已有分支,不改无关工作区改动,不编造功能。资料未提供具体校验脚本细节与收费信息。