wp-block-development

Visão geral da skill wp-block-development

O que o wp-block-development faz

wp-block-development é uma skill prática para criar e corrigir blocos Gutenberg do WordPress, especialmente quando o problema está em block.json, no registro do bloco, no markup salvo ou nas ferramentas de build. A skill wp-block-development é mais indicada para quem precisa entregar um bloco com segurança, e não apenas entender a superfície da API.

Casos de uso mais indicados

Use este guia de wp-block-development quando estiver criando um bloco novo, atualizando um bloco existente, diagnosticando um bloco inválido ou migrando um bloco para renderização dinâmica. Ele também é útil para trabalhos de Frontend Development que tocam em viewScript, viewScriptModule, supports, output do wrapper ou paridade entre frontend e editor.

O que torna a skill diferente

Esta skill é orientada a decisões: ela ajuda você a escolher o padrão certo de bloco, identificar mudanças que quebram compatibilidade antes que cheguem em produção e evitar armadilhas comuns do WordPress, como fontes de atributos frágeis ou caminhos de depreciação ausentes. O principal valor do wp-block-development é reduzir o chute em registro, serialização e compatibilidade.

Como usar a skill wp-block-development

Instale e delimite o escopo corretamente

Instale a skill wp-block-development com npx skills add WordPress/agent-skills --skill wp-block-development. Depois, delimite a tarefa antes de fazer o prompt: informe a raiz do repositório, o namespace do bloco, o caminho do bloco se já souber, e o intervalo de versões do WordPress. Esse contexto importa porque o comportamento de wp-block-development muda com apiVersion, módulos e suporte a server rendering.

Comece pelos arquivos certos

Leia primeiro SKILL.md e, em seguida, examine os arquivos de referência mais relevantes para a sua tarefa: references/block-json.md, references/attributes-and-serialization.md, references/creating-new-blocks.md, references/dynamic-rendering.md, references/deprecations.md e references/debugging.md. Se precisar localizar blocos rapidamente, use scripts/list_blocks.mjs para encontrar a raiz de block.json em vez de adivinhar.

Faça um prompt que possa ser executado

Um bom prompt de uso de wp-block-development nomeia o objetivo, a falha atual e as restrições. Por exemplo: “Atualize my-plugin/blocks/cta para que o ícone do botão continue persistindo após o save, mantenha os posts existentes válidos e ofereça suporte ao WordPress 6.9+.” Isso é melhor do que “corrija meu bloco”, porque deixa claro para a skill se ela deve alterar o markup, adicionar deprecated ou ajustar o registro.

Use um fluxo que combine com o tipo de bloco

Para blocos estáticos, foque nas fontes de atributos, no markup serializado e em save(). Para blocos dinâmicos, foque em render.php, render_callback e nos atributos do wrapper. Para blocos de container, verifique a estrutura de InnerBlocks antes de mexer nas regras de template. Este padrão de instalação do wp-block-development funciona melhor quando você lê a raiz do bloco e depois testa uma pequena mudança antes de partir para refatorações maiores.

FAQ da skill wp-block-development

O wp-block-development serve só para criar blocos Gutenberg?

Não. A skill wp-block-development também é adequada para troubleshooting e manutenção: conteúdo inválido, estilos do editor ausentes, falhas de registro, deprecations e divergência no output do frontend. Se o seu trabalho toca em metadados do bloco ou serialização, a skill é relevante.

Preciso dessa skill se já conheço WordPress?

Se você já conhece WordPress, mas quer cometer menos erros na implementação de blocos, sim. Prompts genéricos costumam ignorar o trabalho oculto de compatibilidade no desenvolvimento de blocos, enquanto o wp-block-development direciona você para os arquivos e decisões que realmente afetam o conteúdo salvo e o comportamento do editor.

Quando não devo usar wp-block-development?

Não use para arquitetura geral de plugins em PHP, estilização de tema ou trabalho JavaScript de aplicativo que não tenha relação com blocos. Ela é mais útil quando o problema está em registro de bloco, markup de bloco, renderização dinâmica ou comportamento do editor do WordPress.

O wp-block-development é amigável para iniciantes?

Sim, se a tarefa for bem delimitada. A skill ajuda iniciantes indicando os arquivos exatos que importam e separando padrões de blocos estáticos, dinâmicos e aninhados. Ela é menos útil se você não conseguir identificar a raiz do bloco ou não souber se ele salva markup ou renderiza no servidor.

Como melhorar a skill wp-block-development

Traga os dados do bloco logo de início

Os melhores resultados com wp-block-development vêm de entradas que incluam o nome do bloco, a pasta, se ele é estático ou dinâmico e a versão do WordPress que precisa ser suportada. Se você puder colar o block.json atual, a estrutura de edit/save ou o markup que está falhando, a skill consegue raciocinar sobre compatibilidade em vez de chutar.

Descreva o modo de falha, não só o recurso

Diga o que quebra: “os atributos são redefinidos após a atualização”, “o editor mostra bloco inválido”, “o CSS do frontend não carrega no iframe” ou “o novo markup não pode quebrar posts antigos”. Esses detalhes determinam se o wp-block-development deve recomendar uma migração, uma correção de registro, uma alteração de wrapper ou uma mudança no build.

Proteja o conteúdo existente

O hábito de melhoria mais importante é preservar posts antigos. Se o HTML salvo mudar, peça um caminho com deprecated e um plano de migração. Se os atributos vêm de seletores frágeis, forneça o HTML atual e a saída esperada para que o guia de wp-block-development possa sugerir uma origem mais segura.

Itere com um ciclo de teste estreito

Depois da primeira resposta, teste um bloco, um post e uma versão do WordPress por vez. Se o resultado ainda estiver errado, devolva o aviso exato do console, a mensagem de conteúdo inválido ou o diff do HTML renderizado. Isso torna a próxima iteração de wp-block-development muito mais precisa e normalmente evita refatorações desnecessárias.