wp-abilities-api

Vue d’ensemble de la skill wp-abilities-api

À quoi sert wp-abilities-api

La skill wp-abilities-api vous aide à travailler de bout en bout avec l’WordPress Abilities API : enregistrer des abilities et des catégories en PHP, les exposer via REST, puis les consommer avec @wordpress/abilities. Elle est particulièrement utile quand vous avez besoin d’un workflow fiable pour wp-abilities-api, au lieu de deviner l’ordre des hooks, la visibilité REST ou le comportement des permissions.

Cas d’usage les plus adaptés

Utilisez cette skill pour des tâches de développement backend où une ability doit être découvrable par des clients, apparaître dans /wp-json/wp-abilities/v1/*, ou être enregistrée proprement dans un plugin, un thème, un mu-plugin ou un checkout WordPress core. C’est un très bon choix si vous corrigez un problème du type « l’ability n’apparaît pas », si vous branchez de nouvelles abilities côté serveur, ou si vous vérifiez qu’un client peut réellement voir ce que le serveur a enregistré.

Ce qui compte le plus

L’intérêt principal de wp-abilities-api est de réduire les erreurs de cycle de vie. Le dépôt insiste sur le moment d’enregistrement, l’analyse de la source et les vérifications d’exposition REST, ce qui est plus important qu’un simple travail de formulation de prompt, parce que l’API est facile à câbler de travers même quand le code semble correct.

Comment utiliser la skill wp-abilities-api

Installez-la et placez-la dans son contexte

Installez-la avec npx skills add WordPress/agent-skills --skill wp-abilities-api. Ensuite, pointez l’agent vers la racine du dépôt et précisez si le travail relève du core, d’un plugin, d’un thème ou d’un mu-plugin. Pour les décisions d’wp-abilities-api install, indiquez aussi la version cible de WordPress, car la prise en charge de WP 6.9+ change selon qu’on peut s’appuyer sur le comportement du core ou qu’il faut passer par la voie plugin/package.

Donnez à la skill les bonnes entrées

Le meilleur wp-abilities-api usage commence par une tâche précise, pas par un objectif vague. Une bonne consigne nomme l’ID de l’ability, l’ID de la catégorie, le libellé souhaité, la forme du callback et le fait qu’elle doive ou non être visible dans REST. Par exemple : « Ajoute une ability site/clear-cache dans ce plugin, expose-la dans REST et assure-toi que le client peut la lister. » C’est mieux que « mets en place des abilities », parce que cela indique à la skill quel résultat doit exister et où il doit apparaître.

Lisez d’abord ces fichiers

Commencez par SKILL.md, puis consultez references/php-registration.md et references/rest-api.md. Ces deux fichiers font ressortir les points les plus décisifs pour l’arbitrage : l’enregistrement des catégories avant les abilities, les hooks requis et les routes REST à vérifier. Si vous évaluez si le wp-abilities-api guide s’applique à une base de code existante, cherchez d’abord wp_register_ability(, wp_register_ability_category(, wp_abilities_api_init, wp_abilities_api_categories_init, wp-abilities/v1 et @wordpress/abilities.

Adoptez un workflow qui évite les faux positifs

Un workflow pratique pour wp-abilities-api consiste à : vérifier la compatibilité de version, repérer les enregistrements existants, ajouter les catégories avant les abilities, puis valider l’exposition REST et la visibilité côté client. Si la qualité du livrable compte, demandez à l’agent d’indiquer les chemins de fichiers exacts modifiés, le hook utilisé pour chaque enregistrement et la manière dont il a confirmé que l’ability apparaît dans wp-abilities/v1/abilities ou wp-abilities/v1/categories.

FAQ sur la skill wp-abilities-api

wp-abilities-api est-elle réservée au backend ?

Non, mais elle est surtout forte pour le développement backend. Le cas d’usage wp-abilities-api for Backend Development est celui où elle excelle : enregistrement en PHP, hooks de cycle de vie, exposition REST et vérifications de type capability. Si vous n’avez besoin que d’un prompt ponctuel pour l’interface ou d’un extrait de code statique, un prompt générique peut suffire.

En quoi est-ce différent d’écrire mon propre prompt ?

Un prompt générique peut décrire l’objectif, mais wp-abilities-api fournit un workflow ciblé pour les contraintes propres à WordPress : timing des hooks, visibilité REST, compatibilité de version et nécessité d’examiner les enregistrements existants avant d’en ajouter de nouveaux. Cela réduit les essais-erreurs quand une ability existe dans le code mais pas dans REST.

Les débutants doivent-ils connaître les internals de WordPress ?

Une base de connaissances aide, mais la skill reste utilisable si vous savez identifier la racine du dépôt et repérer où se trouve le code du plugin ou du thème. Le principal piège pour un débutant est d’omettre les entrées obligatoires : version de WordPress, type de projet et emplacement du changement. Sans cela, l’agent peut choisir le mauvais chemin d’enregistrement.

Quand ne faut-il pas utiliser cette skill ?

N’utilisez pas wp-abilities-api si votre tâche n’a rien à voir avec les abilities WordPress, si le projet est en dessous de WP 6.9 et que vous ne pouvez pas ajouter le chemin package/plugin requis, ou si vous n’avez pas besoin d’un enregistrement d’ability visible côté client. Dans ces cas-là, la skill ajoute de la complexité sans apport suffisant.

Comment améliorer la skill wp-abilities-api

Indiquez la cible d’enregistrement exacte

Les meilleurs résultats viennent d’un cadrage explicite de l’ID de l’ability, de la catégorie et de l’exposition attendue. Au lieu de « ajoute une ability d’administration », dites « enregistre acme/reindex-search sous acme-tools, expose-la dans REST et rends-la disponible aux clients JS ». Cela donne à la skill wp-abilities-api assez de structure pour éviter un résultat flou ou mal aligné.

Ajoutez les contraintes qui changent l’implémentation

Mentionnez la version de WordPress, le fait que ce soit du core ou un plugin/thème, et la disponibilité de WP-CLI. Ces détails influencent le chemin d’installation, l’usage des hooks et les étapes de validation. Si vous les omettez, l’agent peut produire un code qui semble correct mais échoue dans votre environnement.

Demandez une vérification, pas seulement du code

Les échecs les plus fréquents sont un mauvais ordre des hooks, l’absence de meta.show_in_rest et l’hypothèse qu’une ability apparaîtra sans contrôle du route REST. Demandez à l’agent de valider wp-abilities/v1/abilities et d’expliquer pourquoi un enregistrement appartient à wp_abilities_api_categories_init ou à wp_abilities_api_init. Cela transforme le wp-abilities-api guide en workflow vérifiable.

Itérez à partir des preuves du dépôt

Si le premier passage est incomplet, renvoyez l’agent vers les fichiers existants exacts et demandez-lui de s’aligner dessus plutôt que de tout réécrire. Par exemple : « Utilise le pattern d’enregistrement existant dans includes/abilities.php, conserve la cohérence de nommage des catégories, et ne change le flag de visibilité REST que si nécessaire. » C’est la manière la plus rapide d’améliorer le wp-abilities-api usage sans dériver de la base de code.