mcpField
R
release-nightly

release-nightly

github.com/koruworks云与 DevOps0123 次安装2 周前更新
代码仓库

关于 release-nightly

用于准备和发布 nightly 版本的发布工作流技能。它指导 Agent 检查仓库、CI、说明、标签和发布状态,并要求发布前获得明确批准。

主要功能

  1. 01Nightly 发布前检查
  2. 02按提交范围编写说明
  3. 03验证发布说明
  4. 04标签与构建流程指导
  5. 05发布后核验

适用场景

  1. 01发布 nightly 前检查 CI 和仓库状态
  2. 02根据待发布提交起草说明
  3. 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 的发布方式;不要自行编造标签或说明格式。

撰写任何内容前先检查

  1. 标签是最新的。 使用强制方式从远程获取标签(git fetch origin --force tag nightly)。旧检出留下的本地标签会导致基准错误,说明也会因此描述错误的提交。
  2. 工作区就是将要发布的内容。 先获取更新,然后确认当前位于 main 分支、与远程同步且工作区干净。工作期间 main 会继续变动,因为其他人可能会合并,因此打标签前要再检查一次。如果子模块指针与其检出内容不一致,不会影响未检出子模块的构建,但要说明这一点。
  3. 将要打标签的提交在 main 上通过了 CI。 查看该确切提交的 CI 运行记录。nightly 工作流通常不运行测试或 lint,因此 CI 是构建唯一的检查。如果有任务失败,请停止:列出每个失败的任务及其首个实际错误,建议先修复 main,并询问是先修复还是照常发布。如果任务仍在运行,请说明具体任务,并询问是否等待。
  4. 确实有内容可发布。 git log --no-merges <tag>..HEAD 输出不为空。
  5. 上一个 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。

展示,然后发布

向用户展示说明和将要打标签的提交。只有当用户要求发布此版本,并且已经看过这些说明,或表示无需审核即可发布时,才进行发布。已发布的说明文件之后绝不编辑:它就是存档。

  1. 在 main 分支上仅提交说明文件,提交风格参照之前的说明提交(git log --oneline -- <notes folder>),然后推送该分支。这是普通的快进推送,绝不强制推送。
  2. 再次检查 main 没有变动且状态仍为绿色,然后将标签移到该提交,并强制推送: git tag -f nightly && git push -f origin nightly。滚动标签适合强制推送,但仅限该标签。

监视并验证

  1. 找到标签推送启动的运行(gh run list --workflow <file>),并监视它(gh run watch <id>)。如果已有运行在进行中,本次运行会等待。
  2. 运行成功后,检查发布本身(gh release view nightly):它仍是预发布版,包含本次构建的程序包、签名和更新清单,不包含任何旧内容,并且文本是新的说明。
  3. 报告运行和发布的链接、版本或构建编号,以及检查发现的任何问题。

如果构建失败

如果工作流按安全顺序发布(新程序包,然后是清单,最后才删除旧内容),发布页面会保留上一个构建。阅读失败的步骤并报告。

  • 暂时性故障(运行器故障、网络超时):重新运行失败的运行(gh run rerun <id> --failed)。标签没有移动,因此运行会使用相同的说明。
  • 需要修复代码的故障:再次移动标签前先询问用户。构建会从标签上一个位置到新位置之间的提交中选取说明,因此如果标签从失败的提交移到修复提交,就找不到新说明并会停止。建议用户选择:为修复后的构建创建第二个说明文件;或者先将标签移回上一次已发布的提交(按设计,该运行会在构建前失败),然后再移到修复提交。

评论

支持 Markdown