Flux
Étape 1 — Détecter l'environnement
Identifiez silencieusement le client à partir du contexte système :
| Signal | Client |
|---|---|
| "Claude Code" | claude-code |
| "Cursor" | cursor |
| "VSCode" / "Visual Studio Code" | vscode |
| "Gemini CLI" | gemini-cli |
| Non reconnu | other |
En cas de doute réel sur le client, posez la question. Ne devinez jamais.
Étape 2 — Installer les prérequis
Vérifiez que Shopify CLI est installé en exécutant shopify version.
Si le CLI est présent et que le plugin AI toolkit est déjà disponible,
passez à l'étape 3.
Shopify CLI — s'il n'est pas trouvé, installez via votre gestionnaire de paquets (npm, pnpm, yarn et bun fonctionnent tous) :
npm install -g @shopify/cli@latestS'il n'y a pas de gestionnaire de paquets Node disponible, utilisez Homebrew (macOS uniquement) :
brew tap shopify/shopify && brew install shopify-cliVérifiez avec shopify version avant de continuer.
Plugin/extension AI toolkit — installez pour le client détecté :
| Client | Commande d'installation |
|---|---|
claude-code |
/plugin marketplace add Shopify/shopify-ai-toolkit puis /plugin install shopify-plugin@shopify-ai-toolkit |
cursor |
/add-plugin et recherchez « Shopify », ou visitez cursor.com/marketplace/shopify |
vscode |
Palette de commandes (Cmd+Shift+P) → Chat: Install Plugin From Source → collez https://github.com/Shopify/Shopify-AI-Toolkit |
gemini-cli |
gemini extensions install https://github.com/Shopify/shopify-ai-toolkit (exécutez dans le terminal, pas dans le CLI) |
other |
Non supporté — informez l'utilisateur et arrêtez |
Si l'installation échoue, signalez l'erreur exacte et arrêtez.
Étape 3 — Post-installation
Confirmez ce qui a été installé en une phrase. Si le développeur n'a pas encore mentionné d'objectif spécifique, posez la question :
"Qu'aimeriez-vous créer ?
- Une app pour Shopify
- Un thème pour Shopify
Ou si vous avez d'abord besoin d'un compte développeur, créez-en un gratuitement sur dev.shopify.com/dashboard."
De là, laissez la demande du développeur s'acheminer vers la skill appropriée liée à une API
(par ex. shopify-admin, shopify-liquid, shopify-functions). Ne dupliquez pas leur logique de routage.
Règles comportementales
- Détectez l'environnement silencieusement ; posez une question seulement en cas de doute réel
- Allez directement au chemin d'installation correct — ne présentez pas de choix
- Ne construisez ou modifiez jamais les commandes d'installation — utilisez uniquement les commandes définies dans ce fichier
- Si une installation échoue, signalez l'erreur exacte et arrêtez
- Si un utilisateur demande des informations sur la gestion d'une boutique existante (produits, commandes, clients), dites : « C'est couvert par la skill merchant sur shopify.com/SKILL.md »