wordpress-router

Visão geral da skill wordpress-router

A skill wordpress-router é uma ferramenta de triagem para WordPress que ajuda um agente a classificar rapidamente um repositório e escolher o fluxo de trabalho correto antes de fazer mudanças. Ela é mais útil quando o pedido do usuário é amplo ou quando a base de código pode ser um plugin, um tema clássico, um block theme, um pacote do Gutenberg, um checkout do WordPress core ou um repositório de site completo.

Para que esta skill serve

A skill wordpress-router serve para roteamento, não para edição. O objetivo dela é reduzir o chute inicial identificando o tipo de repositório, as ferramentas disponíveis, os testes mais prováveis e a skill de domínio mais relevante para usar em seguida.

Quem deve instalá-la

Instale wordpress-router se você trabalha com frequência em bases de código WordPress e precisa que um agente decida se deve tratar um repositório como trabalho de blocks, theme.json, REST, WP-CLI, segurança, testes ou empacotamento de release. Ela é especialmente útil para orquestrar agentes em repositórios WordPress mistos.

Por que isso importa

Sem um roteador, os agentes costumam cair no modelo mental errado: lógica de tema clássico para um block theme, suposições de plugin para um repositório de site ou edições genéricas em vez do fluxo correto do WordPress. Esta skill adiciona uma etapa prática de classificação que melhora a qualidade do prompt seguinte e reduz a chance de mudanças desnecessárias.

Como usar a skill wordpress-router

Instale e encontre o caminho de decisão

Use o caminho de instalação documentado para a skill wordpress-router e comece por SKILL.md. O repositório também aponta para references/decision-tree.md, que é a leitura complementar mais útil para decisões de roteamento.

Forneça as entradas certas para a skill

A skill wordpress-router funciona melhor quando você informa:

• a raiz do repositório ou o diretório de trabalho atual,
• a intenção real do usuário,
• restrições de versão, como alvos de WordPress ou exigências do WP.com,
• quaisquer limites rígidos de ferramentas, processo de release ou testes.

Um pedido fraco como “corrija este repositório WordPress” é mais difícil de rotear bem. Um pedido mais forte se parece com: “Este é um repositório de wp-content; determine se devemos tratá-lo como um block theme ou como um plugin e, então, planeje o caminho mais seguro para uma mudança de template com os testes já existentes.”

Fluxo sugerido para o primeiro uso

1. Execute a etapa de triagem do projeto descrita em SKILL.md.
2. Leia a saída da triagem para identificar o tipo de projeto, as ferramentas e a cobertura de testes.
3. Abra references/decision-tree.md para mapear a intenção ao próximo fluxo de trabalho.
4. Aplique as convenções do repositório antes de editar, especialmente os comandos existentes de build e teste.

O que verificar primeiro no repositório

Para o guia wordpress-router, priorize:

• SKILL.md para o procedimento de roteamento e as proteções,
• references/decision-tree.md para o roteamento baseado na intenção,
• qualquer documentação específica do repositório só depois de saber o tipo de projeto.

Essa ordem importa porque a skill foi criada para estreitar o caminho antes de você inspecionar o restante.

FAQ da skill wordpress-router

A skill wordpress-router substitui skills de domínio?

Não. Ela é uma skill de decisão na frente da orquestração de agentes. Ela ajuda a escolher o fluxo correto do WordPress, mas não substitui uma skill de blocks, tema, plugin ou testes depois que o repositório já foi classificado.

Quando eu não devo usar wordpress-router?

Evite usá-la quando a tarefa já for estreita e óbvia, como uma edição em um único arquivo conhecido dentro de um fluxo de trabalho claramente identificado. Ela agrega menos valor quando não há ambiguidade de roteamento.

Vale a pena instalar wordpress-router para iniciantes?

Sim, se iniciantes provavelmente vão trabalhar com vários tipos de repositório WordPress. Ela oferece um ponto de partida mais seguro do que um prompt genérico, mas ainda espera que o usuário forneça intenção e restrições com clareza.

Em que isso é melhor do que um prompt simples?

Um prompt simples pode pedir uma mudança; wordpress-router primeiro pergunta que tipo de sistema WordPress é esse e qual fluxo de trabalho deve reger a mudança. Essa etapa extra de classificação é a principal vantagem da skill wordpress-router.

Como melhorar a skill wordpress-router

Forneça uma intenção mais clara, não apenas uma tarefa

As melhores entradas nomeiam o resultado desejado e o contexto do repositório. Por exemplo, em vez de “deixe isso mais rápido”, use “este é um repositório de plugin WordPress; determine se o trabalho de performance deve seguir fluxos de plugin, REST ou blocks e, então, sugira o ponto de partida mais seguro”.

Adicione restrições que afetam o roteamento

A skill funciona melhor quando você inclui alvos de versão do WordPress, exigências de release e limites de ferramentas. Esses detalhes ajudam a decidir se o repositório deve ser tratado como trabalho de core, site, tema, plugin ou orientado ao Gutenberg.

Fique atento aos modos de falha mais comuns

O problema mais comum é o contexto pouco especificado. Se o agente não consegue saber se está lidando com um block theme, tema clássico, plugin ou repositório de site, o próximo fluxo de trabalho pode sair errado. Outro modo de falha é pular a árvore de decisão e ir direto para as edições.

Itere depois da primeira classificação

Depois da primeira passagem, peça para o agente reexplicar:

• o tipo de repositório,
• a skill de downstream mais provável,
• os arquivos usados para decidir,
• a principal incerteza que ainda ficou em aberto.

Isso torna wordpress-router mais útil para Agent Orchestration, porque você pode corrigir o roteiro antes de começar as mudanças no código.