rp-target-wix — Adaptateur cible Wix pour les migrations
Ce skill fait partie du sous-système wix-replatform du repo wix/skills, qui regroupe l'ensemble des skills d'agents pour la plateforme Wix. rp-target-wix n'est pas un squelette : il s'agit d'un skill substantiel et pleinement rédigé qui joue le rôle d'adaptateur cible dans la chaîne de migration. Son rôle est de posséder et de centraliser tout ce qui concerne l'écriture vers Wix, de sorte que les autres composants de la migration (codegen, setup, exécution) ne réinventent pas — et ne cassent pas — ces mécaniques chacun de leur côté.
Ce que ce skill contient
Le SKILL.md expose une documentation technique très détaillée organisée autour de plusieurs axes :
- Surface d'écriture vérifiée : un tableau d'endpoints Wix (Blog, Stores, CMS, Contacts, eCom, médias, notifications…) avec leur statut
VERIFIEDouUNVERIFIED, les pièges connus, et les dates de vérification live. Les formes marquéesVERIFIEDont été validées par un appel réel contre un site live, pas seulement lues dans la documentation. - Runtime d'exécution partagé : contrats pour
executeWriteSpec,executeSetupPlan,WriteExecutionReport, les politiques de retry/throttling, le mode dry-run, les logs d'audit en NDJSON, et les artefacts de complétion. - Connaissance des entités de domaine : un système de fichiers
domains/interrogeable viascripts/domain-knowledge.js, avec validation de graphe de dépendances et CLI dédiée. - Règles de politique : gestion des médias par type d'entité, préservation des URLs, mode safe-mode pour les contacts, politique sur Catalog V3 (V1 non supporté), et ladder de fallback quand aucun writer dédié n'existe.
Comment ce skill est utilisé dans la chaîne de migration
Ce skill n'est pas une étape séquentielle du flux de migration — c'est une référence et une bibliothèque partagée consultée par d'autres skills. rp-import-codegen vend lib/wix-writers.js dans chaque projet et génère des transforms qui appellent ces primitives. rp-setup-discovery et rp-execute-setup s'appuient sur les notes de provisioning et les endpoints vérifiés ici. Parce que la surface Wix est identique quel que soit le système source, ajouter un nouveau connecteur source (Shopify, etc.) ne nécessite aucune modification de ce skill.
Périmètre et couverture
La couverture est demand-driven : seules les entités Wix effectivement nécessitées par des migrations réelles disposent d'un writer dédié. Pour les entités natives Wix sans writer dédié, le codegen émet un appel REST natif via sendDirectRest, le marque UNVERIFIED, et appelle notifyMissingWriter — aucun write silencieux n'est autorisé sans consentement explicite de l'opérateur. Le SKILL.md documente également les contract tests (tests/target-wix/contract-test.js) qui valident les shapes de requête contre un site sandbox et détectent les dérives d'API.