关于 release-nightly
用于准备和发布 nightly 版本的发布工作流技能。它指导 Agent 检查仓库、CI、说明、标签和发布状态,并要求发布前获得明确批准。
主要功能
- 01Nightly 发布前检查
- 02按提交范围编写说明
- 03验证发布说明
- 04标签与构建流程指导
- 05发布后核验
适用场景
- 01发布 nightly 前检查 CI 和仓库状态
- 02根据待发布提交起草说明
- 03核验 nightly 构建和发布资产
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ koruworks/ skills --skill release-nightly安装后在 Claude Code 中输入/release-nightly确认已加载。
详细介绍
发布 nightly
nightly 的制作成本很低,却无法撤回:标签一旦移动,说明就会立即公开,已安装的构建版本也会自动更新到该版本。因此,主要工作是在任何内容离开本机之前完成检查。
查找项目的 nightly 说明
首先,找到项目介绍 nightly 的位置:
- 标签触发的工作流(例如
.github/workflows/nightly.yml;其文件头部注释通常会列出步骤), - 说明文件夹中的 README(例如
releases/nightly/README.md), - 发布说明撰写指南中的 nightly 部分(
releases/WRITING.md)。
这些内容会明确标签名称、说明文件的位置和命名方式、构建如何选取说明文件,以及构建会生成哪些平台的版本。如果找不到这些内容,请停止并询问 nightly 的发布方式;不要自行编造标签或说明格式。
撰写任何内容前先检查
- 标签是最新的。 使用强制方式从远程获取标签(
git fetch origin --force tag nightly)。旧检出留下的本地标签会导致基准错误,说明也会因此描述错误的提交。 - 工作区就是将要发布的内容。 先获取更新,然后确认当前位于 main 分支、与远程同步且工作区干净。工作期间 main 会继续变动,因为其他人可能会合并,因此打标签前要再检查一次。如果子模块指针与其检出内容不一致,不会影响未检出子模块的构建,但要说明这一点。
- 将要打标签的提交在 main 上通过了 CI。 查看该确切提交的 CI 运行记录。nightly 工作流通常不运行测试或 lint,因此 CI 是构建唯一的检查。如果有任务失败,请停止:列出每个失败的任务及其首个实际错误,建议先修复 main,并询问是先修复还是照常发布。如果任务仍在运行,请说明具体任务,并询问是否等待。
- 确实有内容可发布。
git log --no-merges <tag>..HEAD输出不为空。 - 上一个 nightly 运行成功。 检查 nightly 工作流最近的运行记录。如果某次运行失败,且标签仍指向未发布的提交,会影响下一步操作(参见“如果构建失败”)。
撰写说明
针对 nightly 渠道,根据项目的 nightly 说明运行 write-release-notes。除这些说明外,还需注意:
- 确切的文件。 按说明 README 中指定的名称创建文件,通常是 UTC 日期;如果当天是第二次构建,则添加后缀。构建只会选取自标签上次指向的位置以来新增的一个说明文件,因此要检查该范围内没有新增其他文件。
- 完整提交消息,不要只看一行摘要。 运行
git log --no-merges --format='%h %s%n%b' <tag>..HEAD,然后查看任何未能从提交消息中弄清楚的内容对应的差异。 - 只写入此构建包含的内容。 查看工作流构建的平台。在描述某项功能之前,先确认它存在于这些平台上(通常可以从
cfg(windows)或缺少的平台模块看出)。仅适用于某个平台的更改应放在该平台的标题下,否则就不要写。 - 项目的撰写命令可能会调用 Agent。 如果你就是那个 Agent,请根据相同的提交范围自行撰写文件,而不是再启动另一个 Agent。
- 验证文件。 确认文件能够解析、所有必填字段都已填写且不为空,并且不包含发布工具会拒绝的内容,例如图片或 HTML。
展示,然后发布
向用户展示说明和将要打标签的提交。只有当用户要求发布此版本,并且已经看过这些说明,或表示无需审核即可发布时,才进行发布。已发布的说明文件之后绝不编辑:它就是存档。
- 在 main 分支上仅提交说明文件,提交风格参照之前的说明提交(
git log --oneline -- <notes folder>),然后推送该分支。这是普通的快进推送,绝不强制推送。 - 再次检查 main 没有变动且状态仍为绿色,然后将标签移到该提交,并强制推送:
git tag -f nightly && git push -f origin nightly。滚动标签适合强制推送,但仅限该标签。
监视并验证
- 找到标签推送启动的运行(
gh run list --workflow <file>),并监视它(gh run watch <id>)。如果已有运行在进行中,本次运行会等待。 - 运行成功后,检查发布本身(
gh release view nightly):它仍是预发布版,包含本次构建的程序包、签名和更新清单,不包含任何旧内容,并且文本是新的说明。 - 报告运行和发布的链接、版本或构建编号,以及检查发现的任何问题。
如果构建失败
如果工作流按安全顺序发布(新程序包,然后是清单,最后才删除旧内容),发布页面会保留上一个构建。阅读失败的步骤并报告。
- 暂时性故障(运行器故障、网络超时):重新运行失败的运行(
gh run rerun <id> --failed)。标签没有移动,因此运行会使用相同的说明。 - 需要修复代码的故障:再次移动标签前先询问用户。构建会从标签上一个位置到新位置之间的提交中选取说明,因此如果标签从失败的提交移到修复提交,就找不到新说明并会停止。建议用户选择:为修复后的构建创建第二个说明文件;或者先将标签移回上一次已发布的提交(按设计,该运行会在构建前失败),然后再移到修复提交。
评论
支持 Markdown