SuperAPI AI 工具集

init-vercel-shop

前端与建站

查看项目

更新于 10-16 03:58

技能介绍

用途

init-vercel-shop 用于从 vercel/shop 模板初始化一个新的 Vercel Shop 店面项目。当用户希望创建、搭建、启动或初始化 Vercel Shop 店面时,可以使用该技能。

主要能力

  • 通过 create-next-app 脚手架生成 Vercel Shop 项目。
  • 检查目标目录状态,避免覆盖已有项目或非空目录。
  • 验证生成的项目结构是否完整。
  • 在依赖安装失败时提供重试指引。
  • 可选引导连接现有 Shopify 商店并配置 Storefront token。

使用方式

  1. 如果用户未提供目标目录,技能会主动询问,并且始终显式传入该目录。
  2. 检查目标目录:如果已包含 Vercel Shop 项目,则停止并改用相关的店面技能;如果是非空目录,则要求用户提供其他目标目录,而不是覆盖文件。
  3. 运行命令:
pnpm create next-app@latest <target-directory> --example https://github.com/vercel/shop

该模板固定使用 pnpm 12 和 Node.js 24。

  1. 确认生成的项目包含以下内容:AGENTS.md、.agents/skills/、app/、components/、lib/shopify/、package.json。
  2. 在进行进一步更改之前,阅读生成的 AGENTS.md。
  3. 如果依赖安装失败,保留生成的项目,并显示从项目根目录运行的重试命令:
pnpm install
  1. 询问一个可选的后续问题:是否现在连接现有的 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 商店、依赖安装是否需要重试。