wp-playground

Vue d'ensemble de wp-playground

wp-playground est le skill à utiliser pour créer et utiliser des instances WordPress Playground quand vous avez besoin d’un environnement jetable, reproductible, plutôt que d’une pile WordPress locale complète. Le skill wp-playground convient particulièrement aux développeurs de plugins et de thèmes, aux testeurs QA et aux développeurs backend qui veulent reproduire un bug, tester des versions ou partager une configuration exécutable dans le navigateur ou via @wp-playground/cli.

L’essentiel, c’est le problème qu’il résout : faire tourner un site WordPress rapidement, avec le bon code monté, la bonne version de WP/PHP sélectionnée, et assez de contrôle pour déboguer ou empaqueter le résultat. Ce n’est pas un skill générique du type « écris-moi un prompt WordPress » ; c’est un wp-playground guide pratique pour les environnements contrôlés, les blueprints, les snapshots et les tests isolés.

Le meilleur choix pour des workflows WordPress jetables

Utilisez wp-playground quand vous devez :

• lancer un site WordPress temporaire pour valider une modification de plugin ou de thème,
• tester avec une version précise de WordPress ou de PHP,
• exécuter un blueprint ou générer un snapshot à partager,
• déboguer un comportement en isolation sans toucher à la production ni à une base locale.

Ce qui le différencie

Ses principaux atouts sont le workflow CLI, la prise en charge des blueprints et un runtime éphémère prévisible. wp-playground est particulièrement adapté quand la reproductibilité compte plus qu’une interface soignée. Il faut aussi garder en tête que l’environnement repose sur SQLite et WebAssembly, ce qui change à la fois les performances et les contraintes par rapport à une installation serveur traditionnelle.

Contraintes importantes à connaître dès le départ

Ce skill n’est adapté que si vous pouvez travailler dans un environnement jetable. Il n’est pas fait pour les données de production, l’état local à long terme ni les workflows qui exigent une pile WordPress classique basée sur MySQL. Pour de bons résultats, considérez-le comme un banc d’essai contrôlé, pas comme un remplacement de votre environnement de dev principal.

Comment utiliser le skill wp-playground

Installer et ouvrir les fichiers source

Commencez par le chemin standard wp-playground install pour votre outil de gestion de répertoires, puis lisez les fichiers source du skill avant de lui demander de travailler. Les fichiers clés de ce dépôt sont SKILL.md, references/blueprints.md, references/cli-commands.md et references/debugging.md. Ils indiquent quels inputs le skill attend et quels flags CLI sont importants.

Transformer un objectif vague en prompt exploitable

Un prompt faible dit : « Configure WordPress Playground pour mon plugin. »
Un prompt plus solide dit : « Utilise wp-playground pour créer une instance locale jetable pour le plugin dans packages/my-plugin, monte automatiquement le projet, teste avec WP 6.9 et PHP 8.3, et donne-moi la commande CLI exacte ainsi que les ajustements éventuels du montage ou du blueprint. »

Pour wp-playground usage, incluez :

• le chemin du projet,
• si vous voulez server, run-blueprint ou build-snapshot,
• les versions de WordPress et de PHP,
• si le code doit se monter automatiquement,
• si vous avez besoin d’Xdebug ou d’un fichier blueprint.

Choisir d’abord le bon workflow

Utilisez server --auto-mount quand vous voulez une instance interactive pour des tests en direct. Utilisez run-blueprint quand vous avez besoin d’une configuration scriptée qui démarre puis s’arrête. Utilisez build-snapshot quand vous voulez un artefact réutilisable que vous pourrez transmettre ou relancer plus tard. Si votre objectif est le débogage backend, décrivez précisément le mode d’échec et demandez des étapes adaptées à Xdebug plutôt que de demander seulement une commande de lancement.

Lire le dépôt dans cet ordre

Un bon wp-playground guide commence par SKILL.md, puis references/cli-commands.md pour la forme des commandes, ensuite references/blueprints.md si vous avez besoin d’automatiser l’installation, et enfin references/debugging.md si la tâche implique des breakpoints, des montages ou des exécutions bloquées. Cet ordre limite les suppositions et évite de passer à côté de flags comme --mount-before-install ou --blueprint-may-read-adjacent-files.

FAQ du skill wp-playground

wp-playground sert-il seulement aux démos frontend ?

Non. Le skill wp-playground est particulièrement utile pour le développement de plugins, de thèmes et de backend quand vous avez besoin d’un comportement WordPress isolé, de versions reproductibles ou de sessions de débogage. Il sert moins à faire des démonstrations visuelles qu’à exécuter des scénarios maîtrisés.

Faut-il d’abord une pile WordPress locale complète ?

En général, non. L’intérêt de wp-playground install est justement de fournir un environnement rapide sans provisionner une pile traditionnelle. Si vous avez déjà une stack locale, wp-playground reste utile lorsque vous avez besoin d’un point de comparaison propre ou d’une combinaison WP/PHP précise.

Quand ne faut-il pas l’utiliser ?

Ne l’utilisez pas pour des données de production, du travail sur du contenu persistant ou des workflows qui dépendent d’un comportement spécifique à MySQL. Si votre plugin dépend de services externes, de la persistance du système de fichiers ou d’un état de longue durée, wp-playground peut être le mauvais choix par défaut, sauf si vous pouvez modéliser explicitement ces dépendances dans un blueprint.

Est-ce adapté aux débutants ?

Oui, si la tâche est simple et que vous suivez les exemples CLI de près. Le principal point de défaillance, c’est une saisie trop vague : si vous ne précisez pas le chemin du projet, les versions visées ou le besoin éventuel d’un blueprint, le résultat sera moins utile. Les débutants obtiennent les meilleurs résultats en demandant un seul workflow clair à la fois.

Comment améliorer le skill wp-playground

Donnez au skill les variables exactes de configuration

Le gain de qualité le plus net vient du fait de préciser la racine du projet, les versions WP/PHP souhaitées et la question du montage automatique ou explicite du code. Par exemple, « Utilise wp-playground pour tester plugins/contact-form avec WP 6.9 et PHP 8.3 en --auto-mount » est bien plus efficace que « fais que ça marche ».

Décrivez le mode d’échec, pas seulement l’objectif

Si vous faites du débogage, dites ce qui casse : l’installation échoue, un hook de plugin ne se déclenche pas, une réponse REST est incorrecte, ou une régression spécifique à une version n’apparaît qu’en PHP 8.3. Cela permet au skill de choisir entre server, run-blueprint et build-snapshot, et rend tout workflow wp-playground for Backend Development beaucoup plus utile.

Surveillez les erreurs de montage et de blueprint

Les problèmes fréquents concernent les chemins de montage relatifs, les fichiers qui doivent exister avant l’installation et les blueprints qui doivent lire des fichiers locaux adjacents. Si le premier essai échoue, améliorez le prompt en ajoutant des chemins absolus, en précisant si --mount-before-install est nécessaire, et en indiquant si le blueprint lit des assets locaux. Pour le débogage, demandez les détails de configuration Xdebug et le mapping IDE attendu.

Itérez en ne changeant qu’une variable à la fois

Si la première sortie est presque bonne mais pas tout à fait, ne modifiez qu’un seul élément : la version de WP, la version de PHP, le mode de montage ou la source du blueprint. Cela facilite l’identification du problème : est-ce le choix de l’environnement, les flags de commande ou la recette de configuration elle-même ?