rp-target-wix
Ce skill constitue l'adaptateur cible Wix du pipeline de migration replatform hébergé dans le repository wix/skills. Il ne représente pas une étape d'exécution autonome, mais une ressource partagée et un référentiel de primitives consulté par les autres skills du pipeline — notamment rp-import-codegen, rp-setup-discovery et rp-execute-setup.
Son rôle central est de centraliser la surface d'écriture Wix : requêtes vérifiées vers les API Wix (Blog, Stores, CMS, Contacts, Members, Coupons, eCom…), runtime d'exécution partagé, politique de retry et de throttling, gestion des checkpoints, journaux d'audit, et helpers de préservation d'URL. L'idée directrice est de vérifier ces primitives une seule fois ici, afin que le codegen par projet n'ait jamais à les ré-implémenter — ni à en redécouvrir les pièges.
Ce que ce skill expose concrètement
Le skill documente et doit implémenter plusieurs couches :
lib/wix-writers.js: constructeurs de requêtes (build*Request) et exécuteurs, avec un statut expliciteVERIFIEDouUNVERIFIEDpour chaque endpoint. Les formes marquéesVERIFIEDont été validées par un appel réel sur un site live ; les formesUNVERIFIEDsont des primitives bootstrap issues de la documentation ou du MCP Wix, à promouvoir via un test de contrat avant tout usage en production silencieux.- Runtime d'exécution partagé :
executeWriteSpec/executeSetupPlan, gestion des dry-runs, émission de rapports de complétion (completion-report.json), résumés Markdown, et logs d'audit NDJSON append-only. lib/ndjson.js: lecture/écriture en streaming de fichiers NDJSON, batching par nombre ou par coût, cursoring — utilisé par tous les flux de données de migration.domains/etscripts/domain-knowledge.js: base de connaissance machine-readable sur les entités Wix cibles (adéquation, contrats de champs, identifiants de writers), interrogeable de façon déterministe par le codegen.- Safe-mode et helpers de préservation d'URL, politique media par entité cible, et CLI de vérification live (
scripts/verify-stores.js).
Comment ce skill s'intègre dans le pipeline
Le skill rp-import-codegen vend (vendor) les modules de rp-target-wix dans chaque projet de migration, puis génère des transforms et write specs minces qui appellent ces primitives sans en réimplémenter la logique Wix. Ajouter un nouveau système source (Shopify, WooCommerce…) ne nécessite aucune modification de cet adaptateur : la surface Wix est identique pour toutes les sources.
Les skills rp-setup-discovery et rp-execute-setup consultent les notes sur les endpoints vérifiés et la mécanique de provisioning (installation d'apps, activation de Wix Data, version du catalogue Stores V3 vs V1) documentées ici.
Points d'attention notables documentés dans le skill
Le SKILL.md contient une documentation opérationnelle dense : pièges d'API vérifiés en production (ex. plugins Ricos en MAJUSCULES, treeReference top-level pour les catégories Stores, comportement des query* qui discardent le curseur), politique de catalogue V3 obligatoire, règles de safe-mode pour les données de contact, et contrats de test (tests/target-wix/contract-test.js). Ces informations sont destinées à guider l'agent et le codegen, et constituent le cœur de valeur de cette ressource dans l'écosystème replatform.