rp-discovery

Par wix · skills

Skill de découverte du schéma source pour les projets de migration vers Wix : inspecte la plateforme d'origine, documente ses entités, champs et relations, et produit les artefacts canoniques pour l'étape de mapping.

npx skills add https://github.com/wix/skills --skill rp-discovery

rp-discovery

Ce skill fait partie du sous-système wix-replatform du repo wix/skills, un ensemble de skills expérimentaux conçus pour assister les agents IA dans des tâches liées à la plateforme Wix. rp-discovery couvre spécifiquement la phase de découverte d'un projet de migration : avant de pouvoir migrer un site (WordPress, WooCommerce, Shopify, CMS custom, fichiers CSV…), il faut capturer et normaliser la structure de la plateforme source.

Ce que fait ce skill

Le skill orchestre un processus de découverte en deux temps. D'abord, il s'appuie sur un source adapter spécialisé (par exemple rp-source-wordpress pour WordPress/WooCommerce, rp-source-csv pour les exports fichiers) qui effectue la capture brute des données de la plateforme source — routes, entités, auth, pagination, rate limits. Ensuite, rp-discovery synthétise cette capture brute en deux artefacts canoniques transmis aux étapes suivantes du pipeline : source-profile.md (description opérationnelle de la source) et source-schema.json (schéma machine-readable des entités et de leurs champs).

Le skill gère également des logiques transversales : vérification des fichiers de config et secrets avant capture, détection automatique de la plateforme source depuis une URL, gestion des plugins WordPress (couverture, entités dérivées, statuts de migration), et signalement des contraintes particulières comme l'inaccessibilité de médias hébergés en localhost pour l'import Wix.

Séparation des responsabilités

rp-discovery est délibérément platform-agnostic : il définit le contrat de sortie (forme des artefacts, règles de qualité, traceabilité) mais délègue tout ce qui est spécifique à une plateforme — modèle d'auth, quirks d'API REST, scripts de capture — aux adapters source. Pour ajouter le support d'une nouvelle plateforme, on crée un adapter frère (ex. rp-source-shopify) sans modifier ce skill.

Usage dans un projet de migration

Ce skill s'utilise en invoquant l'agent sur le projet actif sous migrations/<project>/. Il produit un ensemble d'artefacts dans migrations/<project>/discovery/ et met à jour les checkpoints d'orchestration. Les skills aval (rp-mapper, rp-import-codegen) consomment source-schema.json et source-profile.md comme point d'entrée sans avoir à relire la capture brute.

Skills similaires