wp-performance

Visão geral do skill wp-performance

Para que serve o wp-performance

O skill wp-performance ajuda você a investigar e melhorar o desempenho do WordPress pelo backend, sem depender da interface do navegador. Ele foi pensado para casos em que você precisa sair do “este site está lento” até uma correção medida e comprovável, especialmente em trabalhos de Performance Optimization em ambientes WordPress 6.9+.

Quem deve instalar

Use o skill wp-performance se você trabalha com requisições lentas no frontend, páginas do admin, rotas REST ou atividade do WP-Cron e quer um fluxo guiado para profiling, diagnóstico e validação segura. Ele é especialmente útil quando você pode usar WP-CLI, logs e requisições HTTP diretas, mas não tem uma sessão completa de depuração no navegador.

Onde ele funciona melhor

Os pontos mais fortes do skill wp-performance são a triagem orientada por medição e as correções de backend para consultas ao banco de dados, opções autoloaded, cache de objetos, cron e chamadas HTTP remotas. Ele também indica a ferramenta certa para cada situação, incluindo wp profile, wp doctor, Query Monitor via headers de REST e Server-Timing quando disponíveis.

Como usar o skill wp-performance

Instale e defina o escopo corretamente

Execute o fluxo wp-performance install na coleção WordPress/agent-skills com o slug do skill wp-performance e, antes de pedir a análise, confirme o contexto do site alvo. O skill funciona melhor quando você informa --path=<path> para a raiz do WordPress e, em instalações multisite ou roteadas, --url=<url> para o site ou endpoint exato que deseja avaliar.

Dê ao skill as entradas de que ele realmente precisa

Um prompt forte para wp-performance usage inclui sintoma, escopo e ambiente. Por exemplo: “Site de staging, sem permissão para gravações, dashboard admin lento para usuário logado, usar wp-performance para perfilar o caminho principal de consulta e sugerir primeiro verificações seguras somente leitura.” Isso é melhor do que “o site está lento”, porque diz ao skill o que medir e quais restrições considerar.

Leia primeiro os arquivos certos

Comece por SKILL.md e depois leia references/measurement.md, references/database.md, references/autoload-options.md, references/object-cache.md, references/cron.md e references/http-api.md, conforme o sintoma. Se você precisar de Query Monitor headless ou checagens orientadas por comando, também vale inspecionar references/query-monitor-headless.md, references/wp-cli-profile.md, references/wp-cli-doctor.md e scripts/perf_inspect.mjs em busca de pistas de fluxo.

Use um fluxo guiado por medição

O melhor fluxo de wp-performance guide é: capturar uma linha de base, testar uma única URL ou rota REST reproduzível, inspecionar a camada de maior custo e depois validar após uma mudança pontual. Mantenha o cenário fixo entre execuções, compare várias amostras em vez de um único pico e evite pedir ações destrutivas a menos que você as tenha autorizado explicitamente.

FAQ do skill wp-performance

O wp-performance é só para agentes de backend?

Sim. Este skill foi projetado para investigação apenas no backend, usando WP-CLI, headers, logs e requisições HTTP. Se você precisa de interação com o navegador, análise visual de waterfall ou testes de clique, wp-performance não é a ferramenta principal mais adequada.

Em que ele é diferente de um prompt genérico?

Um prompt genérico pode dizer para “otimizar o WordPress”, mas o wp-performance traz um fluxo restrito para medição, proteções e domínios de falha específicos do WordPress. Isso importa porque a correção depende de saber se o gargalo está em consultas ao banco, excesso de autoload, cron ou chamadas HTTP remotas.

Ele é amigável para iniciantes?

Sim, desde que você descreva o sintoma e forneça o contexto de instalação. O skill ajuda iniciantes porque restringe as primeiras verificações, mas você ainda precisa informar uma URL ou rota alvo clara e dizer se gravações, instalação de plugins ou flush de cache são permitidos.

Quando não devo usá-lo?

Não use wp-performance se o problema não estiver ligado à execução do WordPress, como roteamento de CDN, falha de DNS ou um gargalo puramente de JavaScript no frontend. Ele também é uma escolha ruim quando você não consegue acessar o servidor, não pode executar WP-CLI e não tem como inspecionar respostas HTTP ou logs.

Como melhorar o skill wp-performance

Forneça evidências iniciais mais fortes

A entrada mais útil é um alvo concreto combinado com um padrão de sintoma: https://example.com/wp-json/..., “só fica lento para editores logados”, “TTFB dispara a cada 5 minutos” ou “a página do admin trava depois do login”. Isso ajuda o wp-performance a escolher entre caminhos de medição, em vez de adivinhar.

Diga que tipo de mudança é permitido

Se você quer uma primeira passagem segura, diga isso explicitamente. Por exemplo: “apenas diagnóstico, sem gravações”, “sem flush de cache” ou “somente staging, pode alterar options”. Isso melhora o wp-performance skill porque o fluxo pode evitar verificações arriscadas e permanecer dentro dos seus limites operacionais.

Peça o caminho da correção, não só o diagnóstico

Os melhores resultados de wp-performance usage aparecem quando você pede tanto o gargalo quanto o próximo passo de verificação. Por exemplo: “Identifique a camada mais lenta, nomeie a causa provável e forneça o comando ou request exato de acompanhamento para confirmar a melhora.” Isso mantém a saída acionável.

Itere com base no primeiro relatório

Se a primeira análise apontar para queries, devolva a tabela lenta, o hook ou a rota e peça um plano de query mais estreito. Se apontar para opções autoloaded, cache de objetos, cron ou chamadas da HTTP API, peça a menor remediação segura e um plano de medição antes/depois. É aí que o skill wp-performance entrega mais valor em trabalhos de Performance Optimization.