SuperAPI AI 工具集

hydrogen-release-process

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:本技能是 Shopify Hydrogen 框架的发布流程指南,用于指导开发者与维护者完成从 PR 到 npm 发布的完整流程。相关规则另见 CLAUDE.md(每个 PR 适用的 changeset 规则)与 hydrogen-versioning 技能(CalVer 与版本语义)。

主要流程:PR 若改动 packages//src/** 或 packages//package.json,需运行 pnpm run changeset add 创建 changeset(人工)。合并到 main 后并行发生两件事:一是 next-release 任务自动发布快照版本 0.0.0-next-{SHA}-{timestamp},所有包以 next 标签发布;二是若存在 changeset,release 任务自动创建或更新 CI release PR,标题为 [ci] release {latestVersion},该 PR 会累积所有已合并 PR 的 changeset。发布是批量进行的,由维护者决定何时合并该 Version PR,合并后自动以 latest 标签发布到 npm,仅含 changeset 的包获得新版本。

发布后:需人工更新 docs/changelog.json(含版本、依赖、功能、修复、升级步骤),否则 h2 upgrade 命令无法识别新版本。h2 upgrade 会从 hydrogen.shopify.dev 获取 changelog.json,对比版本并在 .hydrogen/ 生成本地升级说明。

其他发布类型:在 PR 上评论 /snapit 可创建快照版本用于测试;推送 calver 分支(如 2025-01)触发 backfix-release。back-fix 需从目标大版本最新补丁新建分支(如 git checkout -b 2024-10 @shopify/hydrogen@2024.10.1),并把该分支加入 release.yml 的 on.push.branches,仅 back-fix 分支做此改动,绝不在 main 上改。

限制与注意:合并 Version PR 前需同时核对标题与描述中的版本号;发布后约 1 小时 npm 缓存可能导致脚手架仍用旧版本;back-fix 分支命名必须匹配大版本,否则文档更新会静默失败;发布失败恢复需谨慎,必要时求助 #help-eng-infrastructure。资料未提供具体收费标准等信息。