wp-project-triage

Visão geral da skill wp-project-triage

O que a wp-project-triage faz

A skill wp-project-triage é um inspector rápido e determinístico de primeira passada para repositórios WordPress. Ela identifica o tipo provável de projeto, detecta ferramentas e testes, aponta indícios de versão e retorna um relatório estruturado para você escolher o fluxo certo sem adivinhar. Se você precisa da wp-project-triage para Workflow Automation, este é o tipo de skill que ajuda um agente a decidir o que fazer em seguida antes de editar qualquer coisa.

Quem deve usar

Use a wp-project-triage skill quando você cair de paraquedas em uma base de código WordPress e precisar saber se ela é um plugin, tema, block theme, site, WP core ou um repositório relacionado ao Gutenberg. Ela é especialmente útil para agentes e mantenedores que querem uma etapa de triagem repetível antes de implementação, revisão ou testes.

Por que ela é diferente

O principal valor da wp-project-triage não é resumir em texto; é apoiar decisões. Ela lê os sinais do repositório, aplica guardrails e entrega um relatório JSON em que você pode confiar mais do que em um prompt genérico. Isso a torna mais adequada do que pedir para um LLM “descobrir o repo” a partir de alguns nomes de arquivo.

Como usar a skill wp-project-triage

Instale e aponte para a raiz do repositório

Para wp-project-triage install, adicione a skill ao workspace do seu agente com o comando padrão de skills e depois execute-a a partir da raiz do repositório, para que o detector consiga inspecionar o layout real do projeto. A skill espera um ambiente baseado em filesystem com bash e Node disponíveis; alguns fluxos também dependem de WP-CLI.

Leia estes arquivos primeiro

Comece com skills/wp-project-triage/SKILL.md e depois confira references/triage.schema.json para entender a estrutura do relatório. O repositório também inclui scripts/detect_wp_project.mjs, que é o arquivo-chave se você quiser entender como funcionam a classificação e a detecção de sinais. Esses três arquivos dizem mais do que uma passada superficial pela árvore de diretórios.

Transforme um objetivo vago em um prompt útil

Um prompt forte de wp-project-triage usage diz o que você quer decidir, não apenas que quer uma varredura. Por exemplo: “Execute wp-project-triage neste repositório e me diga se ele parece um plugin ou block theme, quais ferramentas estão presentes e quais guardrails devo seguir antes de alterar o código.” Isso dá à skill contexto suficiente para gerar um relatório de triagem acionável.

Use o relatório para escolher o próximo fluxo

Depois que o detector rodar, use a saída para decidir se vale inspecionar a configuração de build, a preparação de testes, as restrições de versão ou a estrutura de conteúdo. Se o relatório disser unknown, trate isso como um sinal para verificar se você está na raiz correta ou se o repositório precisa de regras de detecção melhores, em vez de forçar um palpite. Rode o detector novamente após mudanças estruturais, como adicionar theme.json, block.json ou tooling de build.

FAQ da skill wp-project-triage

A wp-project-triage é só para repositórios WordPress?

Sim, esse é o encaixe pretendido. O wp-project-triage guide foi pensado para formas de projeto WordPress como plugins, temas, block themes, repositórios de site, core e Gutenberg. Se você não está trabalhando nesse ecossistema, uma varredura genérica de filesystem ou outro classificador de repositório costuma ser a melhor opção.

Preciso de WP-CLI para usar?

Nem sempre. A skill ainda pode ajudar em um ambiente apenas com filesystem, mas alguns fluxos posteriores podem esperar WP-CLI ou tooling próximo ao WordPress. O objetivo da wp-project-triage é dizer o que está presente para que você saiba se essas etapas seguintes são viáveis.

Isso é melhor do que pedir para uma IA inspecionar o repositório diretamente?

Normalmente, sim, pelo menos na primeira passada. Um prompt comum pode deixar passar indícios de versão, ignorar sinais ou inventar estrutura quando a árvore é ambígua. A wp-project-triage oferece um caminho repetível de instalação e execução, um contrato de saída definido e uma tarefa mais restrita: classificar primeiro, agir depois.

Quando eu não devo usar?

Não use como substituto de code review, auditoria de segurança ou análise profunda de arquitetura. Ela é uma camada de triagem, não um diagnóstico completo. Se você já sabe o tipo exato de projeto e precisa de uma tarefa de código bem direcionada, talvez não precise dessa etapa.

Como melhorar a skill wp-project-triage

Dê a ela condições iniciais mais limpas

A forma mais eficaz de melhorar os resultados da wp-project-triage é executá-la a partir da verdadeira raiz do repositório e evitar checkouts parciais ou diretórios de trabalho aninhados. Se o detector estiver analisando a pasta errada, o relatório perde utilidade imediatamente. Isso importa mais do que caprichar no prompt.

Forneça contexto que mude a decisão

Se você quer um melhor wp-project-triage usage, mencione o resultado específico que precisa: classificação entre plugin e tema, detecção de build tooling ou prontidão para testes. Isso ajuda a avaliar se o relatório está completo o suficiente para o próximo passo. Um bom prompt de acompanhamento pode pedir “o caminho de edição mínima e segura” em vez de “resuma tudo”.

Fique atento aos modos de falha mais comuns

O principal modo de falha é uma classificação unknown ou mal especificada causada por sinais ausentes, layout de repositório incomum ou diretórios ignorados. Outro é confiar demais no primeiro relatório quando o repo tem arquivos gerados, mas poucos indícios de código-fonte. Se isso acontecer, melhore as entradas do detector ou amplie as regras de ignore em vez de improvisar.

Itere depois da primeira execução

Use o primeiro relatório para identificar lacunas e depois rode a wp-project-triage novamente após adicionar indícios que faltam, como theme.json, block.json, configuração de testes ou metadados de versão. A skill funciona melhor como um guardrail iterativo: detectar, verificar, ajustar e detectar de novo.