wp-abilities-api

Visão geral do skill wp-abilities-api

Para que serve o wp-abilities-api

O skill wp-abilities-api ajuda você a trabalhar com a WordPress Abilities API de ponta a ponta: registrando abilities e categorias em PHP, expondo tudo via REST e consumindo isso a partir de @wordpress/abilities. Ele é mais útil quando você precisa de um fluxo confiável de wp-abilities-api em vez de tentar adivinhar ordem de hooks, visibilidade no REST ou comportamento de permissões.

Casos de uso ideais

Use este skill em tarefas de backend em que uma ability precisa ser descoberta por clientes, aparecer em /wp-json/wp-abilities/v1/* ou ser registrada corretamente em um plugin, tema, mu-plugin ou no checkout do WordPress core. Ele encaixa muito bem quando você está corrigindo problemas de “a ability não aparece”, conectando novas abilities do lado do servidor ou validando se um cliente realmente enxerga o que o servidor registrou.

O que mais importa

O principal valor do wp-abilities-api é reduzir erros de ciclo de vida. O repositório dá bastante ênfase ao momento do registro, à varredura de origem e às verificações de exposição no REST — e isso pesa mais do que dicas genéricas de prompt, porque a API é fácil de configurar errado mesmo quando o código parece certo.

Como usar o skill wp-abilities-api

Instale e coloque em contexto

Instale com npx skills add WordPress/agent-skills --skill wp-abilities-api. Depois, aponte o agente para a raiz do repositório e diga se o trabalho pertence ao core, a um plugin, a um tema ou a um mu-plugin. Para decisões de wp-abilities-api install, informe também a versão-alvo do WordPress, porque o suporte a WP 6.9+ muda se o skill pode confiar no comportamento do core ou se precisa seguir o caminho de plugin/pacote.

Dê a entrada certa para o skill

O uso mais forte de wp-abilities-api começa com uma tarefa específica, não com um objetivo genérico. Uma boa entrada nomeia o ID da ability, o ID da categoria, o rótulo desejado, a forma do callback e se ela precisa ficar visível no REST. Por exemplo: “Adicione uma ability site/clear-cache neste plugin, exponha no REST e garanta que o cliente consiga listá-la.” Isso é melhor do que “configure abilities”, porque diz ao skill qual saída deve existir e onde ela deve aparecer.

Leia estes arquivos primeiro

Comece com SKILL.md e depois examine references/php-registration.md e references/rest-api.md. Esses dois arquivos trazem os detalhes mais críticos para decisão: registro da categoria antes da ability, hooks obrigatórios e rotas de REST que você deve validar. Se estiver decidindo se o wp-abilities-api guide se aplica a uma base existente, procure primeiro por wp_register_ability(, wp_register_ability_category(, wp_abilities_api_init, wp_abilities_api_categories_init, wp-abilities/v1 e @wordpress/abilities.

Use um fluxo que evite falso sucesso

Um fluxo prático de wp-abilities-api é: confirmar suporte de versão, localizar registros existentes, adicionar categorias antes das abilities e, por fim, verificar a exposição no REST e a visibilidade para o cliente. Se a qualidade da entrega importar, peça ao agente que inclua os caminhos exatos dos arquivos alterados, o hook usado em cada registro e como ele confirmou que a ability aparece em wp-abilities/v1/abilities ou wp-abilities/v1/categories.

FAQ do skill wp-abilities-api

O wp-abilities-api é só para backend?

Não, mas ele é mais forte para desenvolvimento de backend. O caso de uso wp-abilities-api for Backend Development é onde ele realmente brilha: registro em PHP, hooks de ciclo de vida, exposição no REST e verificações de estilo capability. Se você só precisa de um prompt pontual para UI ou de um snippet estático, um prompt genérico pode ser suficiente.

Em que isso é diferente de escrever meu próprio prompt?

Um prompt genérico pode descrever o objetivo, mas o wp-abilities-api oferece um fluxo focado nas restrições específicas do WordPress: tempo dos hooks, visibilidade no REST, compatibilidade de versão e a necessidade de inspecionar registros existentes antes de adicionar novos. Isso reduz tentativa e erro quando a ability existe no código, mas não aparece no REST.

Iniciantes precisam conhecer internals do WordPress?

Uma familiaridade básica ajuda, mas o skill ainda é útil se você conseguir identificar a raiz do repositório e souber onde fica o código do plugin ou do tema. O principal erro de quem está começando é pular as entradas obrigatórias: versão do WordPress, tipo de projeto e onde a mudança deve viver. Sem isso, o agente pode escolher o caminho errado de registro.

Quando não devo usar este skill?

Não use wp-abilities-api se a tarefa não tiver relação com abilities do WordPress, se o projeto estiver abaixo do WP 6.9 e você não puder adicionar o caminho de pacote/plugin necessário, ou se você não precisar de registro de abilities visível para o cliente. Nesses casos, o skill adiciona overhead de processo sem retorno suficiente.

Como melhorar o skill wp-abilities-api

Informe o alvo exato do registro

Os melhores resultados vêm de nomear antecipadamente o ID da ability, a categoria e a exposição desejada. Em vez de “adicione uma ability de admin”, diga “registre acme/reindex-search em acme-tools, exponha no REST e torne-a disponível para clientes JS”. Isso dá ao skill wp-abilities-api estrutura suficiente para evitar saídas vagas ou desalinhadas.

Inclua restrições que mudam a implementação

Mencione a versão do WordPress, se isso é core ou plugin/tema, e se o WP-CLI está disponível. Esses detalhes afetam o caminho de instalação, o uso de hooks e as etapas de validação. Se você omitir isso, o agente pode gerar código que parece correto, mas falha no seu ambiente.

Peça validação, não só código

Os modos de falha mais comuns são ordem errada de hooks, meta.show_in_rest ausente e a suposição de que a ability vai aparecer sem checar a rota REST. Peça ao agente para validar contra wp-abilities/v1/abilities e explicar por que um registro deve ficar em wp_abilities_api_categories_init ou wp_abilities_api_init. Isso transforma o wp-abilities-api guide em um fluxo verificável.

Itere com base em evidências do repositório

Se a primeira passada vier incompleta, aponte ao agente os arquivos existentes exatos e peça para ele se alinhar a eles em vez de reescrever do zero. Por exemplo: “Use o padrão de registro existente em includes/abilities.php, mantenha a consistência na nomenclatura da categoria e só altere o flag de visibilidade no REST se for necessário.” Essa é a forma mais rápida de melhorar o wp-abilities-api usage sem criar desvio em relação à base de código.