用途：把 Weaverse 集成进当前未使用它的 Shopify Hydrogen 项目，按“分析现有项目→安装并配置 SDK→把现有组件转换为 Weaverse 区块→迁移路由→验证”的顺序进行。核心原则是尊重现有项目，沿用其编码风格与约定，不重构已可用的部分，只做扩展。
主要能力：
- 分析项目：先检测框架版本，判断使用 React Router v7（Hydrogen 2025.5.0+，对应 @weaverse/hydrogen@latest v5）还是 Remix（对应 @weaverse/hydrogen@4）；梳理依赖、root、入口、服务端、路由、组件、样式、vite、env、tsconfig 等，记录组件写法、导出方式、样式方案、数据获取与命名等约定，并筛选可转换组件（如 Hero、精选集合、评价、订阅、促销、页脚等），布局原语、购物车结账、埋点和服务端工具不转换。
- 安装配置：用项目现有包管理器安装 SDK，配置 WEAVERSE_PROJECT_ID、WEAVERSE_API_KEY 等环境变量与类型定义；新建 app/weaverse/ 下的 schema.server.ts、style.tsx、components.ts、index.tsx、csp.ts；在服务端上下文加入 WeaverseClient；在 root 用 withWeaverse 包裹默认导出并加入 GlobalStyle；在 entry.server 合并 Weaverse CSP，不替换原有配置。
- 组件转换：保留原 JSX 与样式，仅扩展 HydrogenComponentProps、在根元素展开 {...rest}、渲染 children，并用 createSchema 导出 schema，按内容/设计/高级分组；数据获取改用 Weaverse loader，复用项目已有 GraphQL 查询；components.ts 中必须用 import * as X 命名空间导入注册。
- 路由迁移：将需要可视化编辑的路由改为 Weaverse 内容渲染。
限制：该技能本身没有 references 目录，离线指导即上述阶段；文中实时文档命令依赖同包内的 shopify-hydrogen 脚本，单独安装时会报 MODULE_NOT_FOUND，需先执行 npx skills add Weaverse/shopify-hydrogen-skills --skill shopify-hydrogen。其余细节官方资料暂未提供。