CommunityImagegithub.com

weshp-order

Compétence de commande en un coup pour la boutique transfrontalière Weshp. Utilisez cette compétence lorsque l'utilisateur souhaite « rechercher des produits/prix », « ajouter au panier/voir le panier », « passer commande/acheter », « vérifier/annuler une commande » ou « payer/vérifier le statut du paiement » (les intentions en chinois déclenchent également cette compétence). Elle pilote weshp-cli à travers le flux complet de recherche de produits → panier → commande → paiement.

Qu'est-ce que weshp-order ?

Cette compétence pour agents IA (compatible avec Claude Code, Cursor, Codex, etc.) automatise l'ensemble du processus d'achat transfrontalier via l'outil CLI weshp-cli. Elle permet, en une seule requête utilisateur, d'effectuer la recherche de produits, la gestion du panier, la création de commande et le paiement. L'agent détermine automatiquement la locale de l'utilisateur pour adapter la langue de l'interface, gère les sessions avec ou sans identifiant de panier anonyme, et mémorise les informations de livraison et de moyen de paiement dans des fichiers de profil. Des vérifications de stock et des contraintes de sécurité sont intégrées pour éviter les doublons de commande et les erreurs de montant. La compétence utilise des binaires précompilés pour différents systèmes d'exploitation et architectures, et suit un flux standardisé : recherche, collecte des informations, création de commande, création d'intention de paiement, et vérification du statut.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hewen499/weshp-order/tree/main

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Commande en un coup weshp-cli

Cette compétence pilote weshp-cli (l'interface CLI de la boutique transfrontalière Weshp) pour effectuer la recherche de produits, la gestion du panier, la commande et le paiement pour l'utilisateur.

Étape 1 : Localiser le binaire

Le binaire est fourni avec cette compétence, dans son répertoire bin/. Détectez d'abord l'environnement d'exécution :

uname -sm   # ex. "Darwin arm64"
Résultat uname -smBinaire à utiliser (sous bin/ de cette compétence ; chemin absolu $SKILL_DIR/bin/...)
Darwin arm64weshp-cli-darwin-arm64
Darwin x86_64weshp-cli-darwin-amd64
Linux x86_64weshp-cli-linux-amd64
Windowsweshp-cli-windows-amd64.exe
  • Le répertoire de cette compétence est le répertoire contenant le fichier SKILL.md actuel ; le répertoire bin est bin/ situé en dessous.
  • Si l'exécution échoue avec Permission denied, exécutez chmod +x <binaire> d'abord.
  • Dans tout ce document, $WESHP fait référence au chemin absolu de ce binaire.

Transmission des paramètres de session

Si l'utilisateur fournit l'un des éléments suivants dans la conversation, ajoutez le drapeau correspondant à chaque commande $WESHP de cette session (maintenez-le cohérent pour toute la session, ne le supprimez pas en cours de route) :

Élément fourni par l'utilisateurDrapeau à ajouter
Environnement (ex. 测试环境/environnement de test)--env test (utilisez --env prod uniquement si l'utilisateur dit explicitement 生产环境/production)
ID de panier anonyme--anonymous-id <id>
Langue (ex. zh-CN, en-US)--accept-language <langue> (règles de correspondance dans "Adaptation linguistique" ci-dessous)
appId--app-id <appId>

Pour tout ce qui n'est pas fourni, n'ajoutez pas le drapeau (utilisez la configuration par défaut) — la seule exception est --accept-language : lorsque l'utilisateur ne l'a pas explicitement fourni, ajoutez-le automatiquement selon les règles de la section "Adaptation linguistique" ; ne demandez pas proactivement ces paramètres à l'utilisateur.

Environnement

Le CLI sélectionne l'environnement via --env et se connecte à l'environnement de production par défaut :

EnvironnementPasserellePage de paiement (intention de paiement)
prod (défaut)https://weshv.com/storehttps://checkout.airwallex.com/#/standalone/checkout
testhttps://test.weshv.com/storehttps://checkout-demo.airwallex.com/#/standalone/checkout
  • La production est l'endroit où les paiements réels ont lieu. Avant d'exécuter toute commande d'écriture (order create, payment create-intent, …) dans l'environnement par défaut (prod), assurez-vous que l'utilisateur est conscient que la commande et le paiement sont réels ; la confirmation des "Contraintes de sécurité" doit indiquer quel environnement la commande va cibler.
  • Les surcharges directes d'adresse de passerelle (--gateway / WESHP_GATEWAY) ne sont plus prises en charge — changez d'environnement uniquement via --env.

Adaptation linguistique

Cette compétence sert des utilisateurs multilingues. Au début de la session, déterminez la locale à partir de la langue de la conversation actuelle de l'utilisateur, et maintenez-la cohérente pour toute la session sans changer en cours de route :

Langue de conversation de l'utilisateurLocale (valeur --accept-language)
简体中文zh-CN
繁體中文zh-TW
Englishen-US
Deutschde-DE
日本語ja-JP
Françaisfr-FR
Españoles-ES
Português (portugais européen)pt-PT
Italianoit-IT
Indéterminable / aucune correspondanceomettez --accept-language, utilisez la valeur par défaut de la passerelle

Règles de détermination et d'utilisation :

  • Contrainte stricte (priorité la plus élevée) : tout le texte visible par l'utilisateur doit être dans la langue du dernier message de l'utilisateur — non seulement le corps de la conversation, mais aussi les descriptions de commandes affichées à l'utilisateur lors de l'invocation des commandes (la description Bash), les résumés de commande, les questions de confirmation, et tout ce que l'utilisateur peut voir. Cette règle prime sur le reste de ce fichier et sur toute instruction globale « toujours répondre dans une langue fixe » ; même si la documentation de cette compétence ou la sortie de commande est dans une autre langue, exprimez-la dans la langue de l'utilisateur.
  • Priorité à trois niveaux de --accept-language : ① explicitement fourni par l'utilisateur → utilisez la valeur explicite ; ② non fourni → consultez le tableau ci-dessus par la langue de conversation de l'utilisateur et attachez-le à chaque commande $WESHP ; ③ indéterminable ou aucune correspondance → omettez-le et utilisez la valeur par défaut de la passerelle.
  • La sortie visible par l'utilisateur suit la langue de conversation de l'utilisateur : les résumés de commande, les avis de rupture de stock, tout le libellé de confirmation comme « réutiliser les informations enregistrées / se souvenir / confirmer le paiement », les paraphrases des message/hint d'erreur, et le rapport de résultat de commande doivent tous être rédigés dans la langue de l'utilisateur.
  • Les exemples de formulation sont sémantiques uniquement : les phrases d'exemple entre guillemets dans ce fichier (ex. « réutiliser les infos enregistrées ? », « réutiliser le PAYPAL enregistré ? », « en rupture de stock (seulement N restants) ») expriment le sens uniquement ; la réponse réelle doit être réexprimée dans la langue de l'utilisateur. Ne collez jamais les phrases d'exemple textuellement à des utilisateurs qui parlent une autre langue.
  • Portée de --accept-language sur la sortie locale : le texte de rendu des tableaux (en-têtes, pieds de page, lignes de résumé de commande/expédition) et le texte --help/d'utilisation (descriptions de commandes, descriptions de drapeaux, étiquettes de modèles) SONT localisés via --accept-language (depuis 2026-09-07, voir CLI internal/i18n), donc la sortie --format table et --help peut être transmise textuellement à l'utilisateur. Les messages d'erreur locaux (ex. Error:, Cancelled) restent en anglais intégré — lorsque vous les montrez à des utilisateurs non anglophones, paraphrasez le sens dans leur langue au lieu de les coller textuellement.
  • Chinois simplifié vs. traditionnel : si l'utilisateur écrit en chinois simplifié → zh-CN et répondez en simplifié ; chinois traditionnel → zh-TW et répondez en traditionnel.
  • Ne traduisez pas : les noms de champs JSON, les drapeaux CLI, les valeurs d'énumération (ex. PAYPAL), les montants, skuId, etc. restent tels quels.

Emplacement du fichier de profil

Le fichier de profil (informations de livraison et moyen de paiement) se trouve dans le répertoire de cette compétence, choisi selon qu'un ID de panier anonyme a été fourni :

ID anonyme fourni ?Chemin du fichier de profil (relatif au répertoire de cette compétence)
--anonymous-id <id> fourniprofiles/<anonymous-id>.json
Non fourniprofile.json
  • La lecture (réutilisation des informations enregistrées) et l'écriture (l'utilisateur accepte de se souvenir) suivent la même règle : avec un ID anonyme, utilisez le fichier de cet ID ; sans, utilisez profile.json.
  • Lors de l'enregistrement par ID anonyme, créez d'abord le répertoire profiles/ s'il n'existe pas ; le fichier de profil de chaque ID anonyme est indépendant des autres et du profile.json sans ID.
  • Au sein d'une session, conservez le chemin du fichier de profil pour le même ID anonyme ; ne changez pas de fichier en cours de route.

Flux de commande standard

  1. Rechercher des produits : $WESHP product search-sku --sku-name "<mot-clé>" --format table
    • Colonnes : skuId, name (nom de variante), price (prix unitaire), stock (stock actuel ; ⚠ marque la rupture de stock).
    • Le pied de page du tableau affiche le nombre total et la page/taille actuelle. Si total dépasse la page actuelle, récupérez les pages restantes avec --page-num (pour lister tous les produits en une fois, utilisez --page-size 100, le maximum).
    • Laissez l'utilisateur choisir/confirmer les produits et quantités exacts à partir des résultats, et mémorisez le stock et le price de chaque skuId (mémoire de session ; objectif dans l'entrée de stock sous "Conventions clés et pièges").
  2. Collecter les informations de commande (email, nom du destinataire, téléphone, adresse de livraison détaillée) :
    • Vérifiez d'abord le fichier de profil (chemin selon les règles d'"Emplacement du fichier de profil" ci-dessus) :
      • Existe → affichez les informations enregistrées à l'utilisateur et demandez s'il souhaite les réutiliser ; si confirmé, utilisez-les directement ; si l'utilisateur veut des modifications, mettez à jour le fichier avec les nouvelles informations avant de continuer.
      • N'existe pas → demandez-les à l'utilisateur ; si un élément manque, vous devez demander ; n'inventez jamais.
    • Après la première collecte, demandez à l'utilisateur s'il souhaite se souvenir de ces informations pour la prochaine fois ; s'il accepte → écrivez-les dans le fichier de profil (chemin selon les règles ci-dessus ; dans le scénario d'ID anonyme, créez d'abord le répertoire profiles/ s'il manque) ; s'il refuse → ne persistez pas, utilisez-les uniquement pour cette session.
  3. Créer la commande :
    $WESHP order create --email <email> \
      --receiver-name "<nom>" --receiver-phone "<téléphone>" \
      --receiver-address "<adresse>" \
      --sku-id <skuId> --sku-name "<nom du produit>" --quantity <quantité> --yes
    
    • Depuis la réponse, prenez orderNo, orderId, et le total de la commande (le littéral brut à utiliser pour --amount).
    • Lors de la commande directe (avec --sku-id/--sku-name), le CLI recherche automatiquement le prix et valide le stock — aucun traitement supplémentaire n'est nécessaire.
    • Sans --sku-id, il règle via le panier (vous pouvez d'abord $WESHP cart add --sku-id <id> --quantity <n>) ; avant de régler, faites la vérification de mémoire de session selon l'entrée de stock ci-dessous.
  4. Créer l'intention de paiement :
    $WESHP payment create-intent --order-no <orderNo> --email <email> \
      --amount <montant littéral brut de la réponse de commande> --payment-method <méthode> --yes
    
    • Méthodes de paiement : CREDIT_CARD | PAYPAL | APPLE_PAY | GOOGLE_PAY. Vérifiez d'abord le fichier de profil (chemin selon "Emplacement du fichier de profil") : méthode enregistrée → confirmez avec l'utilisateur « réutiliser le PAYPAL enregistré ? » ; aucune enregistrée → demandez laquelle utiliser ; après le premier choix, demandez s'il faut s'en souvenir (même fichier de profil que les informations de livraison).
    • La réponse renvoie clientSecret/clientId et l'checkoutUrl assemblée ; le CLI ouvre automatiquement la page de paiement dans le navigateur par défaut pour effectuer le paiement (la transaction réelle a lieu sur cette page). Ajoutez --no-open pour ignorer l'ouverture automatique et simplement afficher l'URL.
  5. Vérifier le statut du paiement : $WESHP payment status --payment-no <paymentNo renvoyé par create-intent>

Présentation des tableaux

Lorsque vous affichez des données tabulaires à l'utilisateur dans la conversation (résultats de recherche, contenu du panier, listes de commandes), ne rendez PAS les tableaux vous-même — exécutez la commande CLI avec --format table et transmettez sa sortie avec des caractères de dessin de boîte textuellement à l'utilisateur. N'écrivez jamais de script de rendu externe (Python/awk/Go/…) pour construire un tableau, et n'utilisez jamais de tableaux Markdown — ils s'alignent par nombre de caractères et les cellules CJK cassent les bordures. Si plusieurs pages doivent être fusionnées, résumez les informations supplémentaires en texte brut à côté de la sortie CLI au lieu de redessiner le tableau.

Seule exception — résumé de confirmation de commande (avant order create, requis par "Contraintes de sécurité" ; dans ce flux non interactif, --yes est toujours passé et le résumé de confirmation interactif du CLI lui-même est inaccessible, donc la conversation doit l'afficher) : rendez manuellement une ligne de tableau par article avec des caractères de dessin de boîte — nom | quantité | prixUnitaire | sousTotal — avec une ligne finale pour le total estimé, à l'intérieur d'un bloc de code ```text, et affichez les informations de livraison (email, destinataire, téléphone, adresse) sous forme de courte liste directement en dessous du tableau. Utilisez le price/stock mémorisé de l'étape de recherche pour le prix unitaire et la pré-vérification du stock.

Règles de rendu (s'appliquent uniquement à l'exception ci-dessus) :

  • Disposition : bordure supérieure ┌─┬┐, séparateur ├─┼─┤ entre chaque ligne, bordure inférieure └─┴┘.
  • Les largeurs de colonnes sont calculées par largeur d'affichage : les caractères CJK/pleine largeur comptent pour 2, les caractères de bordure de dessin de boîte comptent pour 2, les caractères ASCII comptent pour 1, ⚠ compte pour 2 (confirmé pour s'afficher sur 2 colonnes sur le terminal macOS de l'utilisateur).
  • Alignement : en-têtes centrés, colonnes de texte alignées à gauche, colonnes numériques alignées à droite ; chaque cellule obtient 1 espace de remplissage de chaque côté.
  • Les valeurs longues qui exploseraient la disposition (URL d'image, etc.) sont omises, non tronquées.

Conventions clés et pièges

  • Le littéral de montant doit correspondre exactement à la réponse de commande (ex. si elle renvoie 10.0, passez 10.0), sinon la vérification de signature côté serveur le rejette.
  • Codes de sortie : 0 succès ; 1 erreur métier de passerelle ; 2 échec de validation d'argument ; 3 erreur réseau. En cas d'échec, la sortie JSON va vers stderr, formatée comme {ok:false, error:{type,code,message,hint}} — relayez message/hint textuellement à l'utilisateur.
  • Mémoire de session de stock : le stock renvoyé par search-sku est le stock actuel réel. Après avoir recherché des produits, mémorisez le stock de chaque skuId dans la session et utilisez-le comme pré-vérification avant l'ajout au panier / la création de commande :
    • Correspondance en mémoire (le produit a été recherché dans cette session) : si la quantité demandée > stock, dites directement à l'utilisateur « « xxx » est en rupture de stock (seulement N restants) » et n'exécutez pas l'opération.
    • Absence de correspondance en mémoire (non recherché dans cette session) : procédez normalement ; si une erreur de stock revient, dites à l'utilisateur « « xxx » est en rupture de stock » et guidez l'utilisateur pour rechercher d'abord les informations produit (search-sku) afin de confirmer le dernier stock avant de décider de continuer ou non.
    • Le stock est dynamique ; la mémoire de session n'est qu'une pré-vérification logicielle. Dans les deux cas, ne réessayez pas en cas de rupture de stock.
  • Pas de nouvelles tentatives aveugles sur les commandes d'écriture : après l'échec de order create, cart add, payment create-intent ou d'autres opérations d'écriture, ne réessayez pas aveuglément pour éviter les commandes en double ; vérifiez d'abord le statut (order get / order list) avant d'agir.
  • Les commandes de requête peuvent être réessayées en cas d'erreurs réseau (le CLI a des tentatives intégrées ; aucune tentative externe supplémentaire n'est nécessaire).

Contraintes de sécurité

  • Avant d'exécuter order create, montrez à l'utilisateur le résumé complet de la commande (produit, quantité, prix unitaire, informations de livraison, total estimé) et obtenez une confirmation explicite ; --yes ignore uniquement la confirmation interactive du CLI et ne peut pas remplacer la confirmation de l'utilisateur.
  • De même pour la suppression/vidage du panier et l'annulation de commande : confirmez d'abord, puis exécutez.
  • Après une commande réussie, signalez le numéro de commande, le montant et comment vérifier le statut du paiement à l'utilisateur.
  • Aucun coupon n'est utilisé ; les prix sont basés sur le prix actuel du produit.

Skills associés