用途
init-vercel-shop 用于从 vercel/shop 模板初始化一个新的 Vercel Shop 店面项目。当用户希望创建、搭建、启动或初始化 Vercel Shop 店面时,可以使用该技能。
主要能力
- 通过 create-next-app 脚手架生成 Vercel Shop 项目。
- 检查目标目录状态,避免覆盖已有项目或非空目录。
- 验证生成的项目结构是否完整。
- 在依赖安装失败时提供重试指引。
- 可选引导连接现有 Shopify 商店并配置 Storefront token。
使用方式
- 如果用户未提供目标目录,技能会主动询问,并且始终显式传入该目录。
- 检查目标目录:如果已包含 Vercel Shop 项目,则停止并改用相关的店面技能;如果是非空目录,则要求用户提供其他目标目录,而不是覆盖文件。
- 运行命令:
pnpm create next-app@latest <target-directory> --example https://github.com/vercel/shop
该模板固定使用 pnpm 12 和 Node.js 24。
- 确认生成的项目包含以下内容:AGENTS.md、.agents/skills/、app/、components/、lib/shopify/、package.json。
- 在进行进一步更改之前,阅读生成的 AGENTS.md。
- 如果依赖安装失败,保留生成的项目,并显示从项目根目录运行的重试命令:
pnpm install
- 询问一个可选的后续问题:是否现在连接现有的 Shopify 商店?
- 如果选择是,只询问商店的管理 URL 或 .myshopify.com 域名,然后阅读 references/storefront-token.md 并遵循其自动化 Shopify CLI 流程。在要求用户访问 Headless 渠道之前,尝试复用或创建公共 Storefront token。
- 如果选择否,则以正常的环境设置作为下一步结束。
适用场景
- 需要快速搭建 Vercel Shop 店面原型或新项目。
- 希望基于官方 vercel/shop 模板开始开发。
- 需要将新店面连接到现有 Shopify 商店。
限制
- 目标目录不能是已包含 Vercel Shop 项目的目录,也不能是非空目录。
- 模板固定使用 pnpm 12 和 Node.js 24。
- 依赖安装可能失败,需要手动重试。
- 连接 Shopify 商店需要提供管理 URL 或 .myshopify.com 域名。
- 返回信息包括:生成的项目路径、是否连接了 Shopify 商店、依赖安装是否需要重试。