用途：为 Shopify Hydrogen 提供逐版本升级指南，覆盖破坏性变更、必需代码更新与分步 diff，并包含 Weaverse 相关注意事项。
主要能力：列出多个版本跳跃的升级指南，例如 2024.4.7→2024.7.1（乐观变体、新 session commit 模式、Layout 组件重构、VariantSelector 改进）、2024.10.1→2025.1.0（v3_lazyRouteDiscovery 标志、样式表 link 标签修复）、2025.1.0→2025.1.1（v3_singleFetch、nonce 支持、json/defer 弃用、B2B 稳定化）、2025.1.2→2025.1.3（v3_routeConfig、Layout 导出移至独立文件、routes.ts 配置）、2025.1.3→2025.1.4（session 登出修复、VariantSelector 弃用、产品查询更新、ProductForm 重构）、2025.5.0→2025.7.0（React Router 7.9.x 迁移、context 创建、入口点更新）、2025.7.0→2026.1.0（@react-router 7.12、@shopify/hydrogen 2026.1.0、Storefront API 2026-01、新购物车 mutation）、2026.1.0→2026.4.7（Storefront API 2026-04、强制同源 Storefront API 代理、Customer Privacy API 同意迁移、React Router ~7.16）。
使用方式：先运行官方升级工具 npx shopify hydrogen upgrade，它会自动升级并安装依赖，并生成列出所需源码修改的 Markdown 文件，需手动应用后验证，不会直接改源码。再按当前版本匹配对应指南，跨多版本时按顺序逐个应用。升级后运行 npm run codegen 重新生成类型，不要直接编辑生成的 .d.ts 文件。文档检索脚本需在技能自身目录运行，依赖同级的 shopify-hydrogen 技能；若单独安装本技能，需先执行 npx skills add Weaverse/shopify-hydrogen-skills --skill shopify-hydrogen，否则命令会报 MODULE_NOT_FOUND。也可使用 references/ 文件作为离线回退。检索示例：node ../shopify-hydrogen/scripts/search_shopify_docs.mjs "hydrogen upgrade <version>"，以及 "hydrogen breaking changes"、"hydrogen migration"。
适用场景：升级 Shopify Hydrogen 项目、排查版本间破坏性变更、准备迁移代码差异。
限制：指南仅覆盖所列版本区间；官方最新信息需通过检索脚本或 Shopify 文档获取；脚本依赖同级技能目录；资料未提供具体收费、平台支持范围与效果保证。