Pular para o conteúdo principal

Usando a Skill de Agente do WordPress Playground

Quer um assistente de IA que já saiba como iniciar instâncias do WordPress, executar Blueprints e depurar plugins? A skill de agente wp-playground ensina aos agentes de codificação os fluxos de trabalho do CLI e navegador do WordPress Playground. Você descreve o que precisa em linguagem natural. O agente cuida dos comandos.

Seu agente de codificação lê a referência da skill — um documento com flags do CLI, procedimentos e etapas de solução de problemas — antes de responder. Isso garante que os comandos do Playground sejam executados corretamente.

Pré-requisitos​

Antes de instalar a skill, confirme que você tem:

RequisitoVersão mínimaComando de verificação
Node.js20.18node -v
npm / npxIncluído com Node.jsnpx --version

Você também precisa de um agente de codificação que suporte skills de agente: Antigravity, Claude Code, Codex, Copilot, Cursor ou Gemini CLI. Certifique-se de que seu CLI ou IDE execute a versão mais recente. A qualidade da saída depende do modelo escolhido.

Instalação​

1. Instalar via terminal​

Instale a skill usando o CLI npx skills:

npx skills add wordpress/agent-skills --skill wp-playground

2. Instalar manualmente​

# Clone agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills

# Construir a distribuição
node shared/scripts/skillpack-build.mjs --clean

# Instalar no seu projeto WordPress
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor,antigravity,gemini

Isso copia as skills para:

  • .github/skills/ para VS Code / GitHub Copilot
  • .claude/skills/ para Claude Code
  • .cursor/skills/ para Cursor
  • .agent/skills/ para Antigravity
  • .gemini/skills/ para Gemini CLI
  • .codex/skills/ para Codex

Verifique a instalação conferindo se o diretório da skill existe para seu agente:

AgenteDiretório da skill
Claude Code.claude/skills/wp-playground/
Gemini CLI.gemini/skills/wp-playground/
GitHub Copilot.github/skills/wp-playground/
Cursor.cursor/skills/wp-playground/
Antigravity.agent/skills/wp-playground/
Codex.codex/skills/wp-playground/

Alguns agentes também suportam listar skills diretamente:

# Claude Code
claude /skills

# Gemini CLI
gemini /skills list

Usar a skill no terminal​

Com a skill instalada, descreva seu ambiente WordPress para seu agente de codificação. O agente constrói o Blueprint, executa os comandos do CLI e inicia o servidor.

Abra seu agente de codificação no terminal e digite sua solicitação:

> Execute uma instância WordPress com meu plugin montado

O agente lê a referência da skill, detecta o layout do seu projeto e executa server --auto-mount. A instância inicia em http://localhost:9400.

Gerando conteúdo dinamicamente​

Precisa de dados de exemplo para testes ou demonstração? Descreva a estrutura de conteúdo que você quer:

> Execute um WordPress com 10 posts publicados

O agente cria um Blueprint com um passo runPHP que gera os posts usando wp_insert_post().

Mais exemplos:

> Execute um WordPress com 3 usuários onde cada usuário tem 3 posts
> Inicie uma instância WordPress com 5 páginas e um menu personalizado linkando todas elas
> Crie um site WordPress com 20 posts em 4 categorias

Cada prompt produz um Blueprint completo que roda localmente, gerenciando criação de usuários, atribuição de funções, geração de posts e configuração de taxonomias através dos passos do Blueprint.

Testes de compatibilidade de versão​

Seu plugin funciona em versões mais antigas do PHP? Pergunte diretamente:

> Teste meu plugin no WordPress 6.3 com PHP 7.4
> Execute meu tema no último WordPress nightly com PHP 8.5

O agente adiciona as flags --wp e --php para corresponder à sua solicitação. Combinações comuns:

CenárioO que pedir
Última estável"Execute uma instância WordPress" (padrão: último WP, PHP 8.3)
Mínima suportada"Teste meu plugin no WordPress 6.3 com PHP 7.4"
Próximo lançamento"Execute o WordPress nightly build"
PHP legado"Inicie WordPress com PHP 7.4"

Cenários complexos​

Combine múltiplos requisitos em um único prompt:

> Crie um site WordPress com WooCommerce, 3 categorias de produtos,
  10 produtos de exemplo e 2 contas de clientes — rodando no PHP 8.2
> Execute uma instância WordPress com meu plugin montado, modo debug habilitado
  e 5 posts de teste que incluam imagens destacadas

O agente divide isso na sequência correta de passos do Blueprint e flags do CLI. Cada solicitação produz uma instância totalmente configurada e em execução.

Como a skill funciona​

A skill wp-playground é um conjunto de arquivos Markdown que seu agente de codificação carrega em seu contexto quando sua solicitação corresponde a padrões relacionados ao Playground. A skill inclui:

  • SKILL.MD — O procedimento principal: guardrails, fluxos de trabalho passo a passo, verificações e modos de falha.
  • references/cli-commands.md — Uma cheatsheet do CLI com todas as flags e valores padrão.
  • references/blueprint.md — Estrutura do Blueprint, passos comuns e dicas de criação.
  • references/debugging.md — Configuração do Xdebug, mapeamento de caminhos e etapas de solução de problemas.

Seu agente de codificação lê esses arquivos antes de gerar comandos, garantindo flags corretas e alertando sobre armadilhas comuns.

Próximos passos​