rp-source-wordpress

rp-source-wordpress

Ce skill fait partie du workflow replatform du repository wix/skills, le dépôt officiel de skills Wix pour agents IA. Il joue le rôle d'adaptateur source dédié à WordPress (API REST wp/v2) et WooCommerce (wc/v3) : il centralise tout ce qui est spécifique à ces plateformes afin que les autres skills du workflow restent agnostiques.

Rôle dans le workflow de migration

Ce skill n'est pas une étape autonome dans le pipeline de migration — il est consulté par deux autres skills :

• rp-discovery s'y réfère pour la section Capture : comment échantillonner la source WordPress, détecter les entités disponibles et produire les artefacts canoniques source-profile.md et source-schema.json.
• rp-import-codegen s'y réfère pour la section Read contract : comment générer un reader capable d'extraire en masse les données WordPress/WooCommerce (auth, pagination, gestion des espaces de noms) vers des fichiers locaux durables.

Le skill rp-execute-import ne le consulte jamais : à l'étape d'exécution, la logique WordPress est déjà intégrée dans le code généré.

Ce que couvre ce skill

Le SKILL.md documente en détail plusieurs domaines techniques :

• Détection de la plateforme : identification via l'index REST /wp-json/, présence ou non de WooCommerce.
• Capture (discovery-time) : script wp-discovery.js fourni dans le dossier du skill, gestion des credentials via un fichier .env dédié, distinction entre données publiques et données authentifiées, traitement des sources localhost, mapping des plugins connus.
• Contrat de lecture (codegen-time) : réutilisation du module partagé lib/wp-http.js pour le transport HTTP (auth, throttling, retry), pagination via les headers X-WP-TotalPages/X-WP-Total, résolution des relations _links/_embed, pièges documentés à partir de cas réels (encodage HTML dans les champs texte, valeurs d'attributs de variations WooCommerce, doubles prefixes /wp-json).
• Forme du schéma : source-schema.example.json fourni comme gabarit pour l'émission du source-schema.json par rp-discovery.

Comment l'utiliser

Ce skill est activé automatiquement par les autres skills du workflow dès que la plateforme source est identifiée comme WordPress ou WooCommerce. Un utilisateur souhaitant migrer un site WordPress vers Wix installe le skill replatform (via npx skills add wix/skills/replatform) et déclenche rp-discovery : c'est ce dernier qui consulte rp-source-wordpress pour obtenir les instructions spécifiques à la plateforme, sans que l'utilisateur ait à interagir directement avec ce skill.