Back to Details

shopify-onboarding-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Flow

流程

Step 1 — Detect environment

步骤1 — 检测环境

Silently identify the client from system context:
SignalClient
"Claude Code"
claude-code
"Cursor"
cursor
"VSCode" / "Visual Studio Code"
vscode
"Gemini CLI"
gemini-cli
Unrecognized
other
If genuinely uncertain about client, ask. Never guess.
从系统上下文自动识别客户端：
信号客户端
"Claude Code"
claude-code
"Cursor"
cursor
"VSCode" / "Visual Studio Code"
vscode
"Gemini CLI"
gemini-cli
无法识别
other
如果确实无法确定客户端，请询问用户，切勿猜测。

Step 2 — Install prerequisites

步骤2 — 安装前置依赖

Check if Shopify CLI is installed by running 
shopify version
. If the CLI is present and the AI toolkit plugin is already available, skip to Step 3.
Shopify CLI — if not found, install using your package manager (npm, pnpm, yarn, and bun all work):
npm install -g @shopify/cli@latest
If no Node package manager is available, use Homebrew (macOS only):
brew tap shopify/shopify && brew install shopify-cli
Verify with 
shopify version
before continuing.
AI toolkit plugin/extension — install for the detected client:
ClientInstall command
claude-code
/plugin marketplace add Shopify/shopify-ai-toolkit
then 
/plugin install shopify-plugin@shopify-ai-toolkit
cursor
/add-plugin
and search for "Shopify", or visit 
cursor.com/marketplace/shopify
vscode
Command Palette (Cmd+Shift+P) → Chat: Install Plugin From Source → paste 
https://github.com/Shopify/Shopify-AI-Toolkit
gemini-cli
gemini extensions install https://github.com/Shopify/shopify-ai-toolkit
(run in terminal, not inside CLI)
other
Not supported — inform the user and stop
If install fails, report the exact error and stop.
通过运行
shopify version
检查是否已安装Shopify CLI。 如果CLI已存在且AI toolkit插件已可用， 直接跳至步骤3。
Shopify CLI — 若未找到，使用你的包管理器（npm、pnpm、yarn和bun均支持）进行安装：
npm install -g @shopify/cli@latest
如果没有Node包管理器，可使用Homebrew（仅适用于macOS）：
brew tap shopify/shopify && brew install shopify-cli
继续操作前，请通过
shopify version
验证安装。
AI toolkit插件/扩展 — 为检测到的客户端进行安装：
客户端安装命令
claude-code
/plugin marketplace add Shopify/shopify-ai-toolkit
然后 
/plugin install shopify-plugin@shopify-ai-toolkit
cursor
/add-plugin
并搜索“Shopify”，或访问
cursor.com/marketplace/shopify
vscode
命令面板（Cmd+Shift+P）→ Chat: Install Plugin From Source → 粘贴
https://github.com/Shopify/Shopify-AI-Toolkit
gemini-cli
gemini extensions install https://github.com/Shopify/shopify-ai-toolkit
（在终端中运行，而非CLI内部）
other
不支持 — 告知用户并停止操作
如果安装失败，报告确切错误并停止操作。

Step 3 — Post-install

步骤3 — 安装后操作

Confirm what was installed in one sentence. If the developer hasn't mentioned a specific goal yet, ask:
"What would you like to build?
  1. An app for Shopify
  2. A theme for Shopify
Or if you need a developer account first, create one free at dev.shopify.com/dashboard."
From here, let the developer's request flow to the appropriate API-specific skill (e.g. 
shopify-admin
, 
shopify-liquid
, 
shopify-functions
). Do not duplicate their routing logic.
用一句话确认已安装的内容。如果开发者尚未提及具体目标，请询问：
“你想要构建什么？
  1. Shopify应用
  2. Shopify主题
或者如果你需要先创建开发者账户，可免费在dev.shopify.com/dashboard创建。”
从这里开始，根据开发者的需求引导至对应的API专属技能（例如
shopify-admin
、
shopify-liquid
、
shopify-functions
）。请勿重复它们的路由逻辑。

Behavioral rules

行为规则

  • Detect environment silently; only ask if genuinely uncertain
  • Proceed directly to the correct installation path — don't present choices
  • Never construct or modify install commands — only use commands defined in this file
  • If an install fails, report the exact error and stop
  • If a user asks about managing an existing store (products, orders, customers), say: "That's covered by the merchant skill at shopify.com/SKILL.md"
  • 自动检测环境；仅在确实不确定时才询问用户
  • 直接进入正确的安装路径 — 不要提供选择项
  • 切勿自行构造或修改安装命令 — 仅使用本文档中定义的命令
  • 如果安装失败，报告确切错误并停止操作
  • 如果用户询问管理现有店铺的相关问题（商品、订单、客户），请回复：“该内容由商家技能覆盖，详情见shopify.com/SKILL.md”