makepad-2.0-migration

Visão geral do skill makepad-2.0-migration

O que este skill faz

O skill makepad-2.0-migration ajuda você a migrar projetos Makepad da versão 1.x para a 2.0 com menos tentativa e erro. Ele foi pensado para quem precisa sair do modelo antigo live_design! e adotar o fluxo mais novo baseado em script_mod!, incluindo atualizações de sintaxe, renomeações de derive macros e padrões de scripting em runtime.

Para quem ele é indicado

Use o skill makepad-2.0-migration se você estiver atualizando uma base de código existente, revisando breaking changes ou tentando converter definições antigas de widgets para a nova sintaxe. Ele é especialmente útil para maintainers, responsáveis por ferramentas no lado backend que dão suporte a código de UI e desenvolvedores que precisam de um guia de migração mais parecido com uma checklist de implementação do que com um tutorial amplo.

Por que ele é diferente

Este skill é focado em mapeamento exato e em fluxo de migração, não em aprender Makepad do zero. O principal valor está em reduzir erros de conversão: < e > virando chaves, Live virando Script, LiveHook virando ScriptHook, apply_over virando script_apply_eval, além de mudanças relacionadas ao ciclo de vida e ao tema. Isso torna o makepad-2.0-migration mais útil para decisão do que um prompt genérico quando você já tem código legado em mãos.

Como usar o skill makepad-2.0-migration

Instale e acione do jeito certo

Instale o skill makepad-2.0-migration com o comando normal de skills do diretório e depois invoque-o quando a tarefa envolver claramente conversão de Makepad 1.x para 2.0. Um bom prompt de disparo informa a versão de origem, a versão de destino e o tipo de arquivo que você está migrando; por exemplo: Migrate this Makepad 1.x widget file to 2.0 script_mod syntax and preserve behavior.

Forneça a entrada certa

O skill funciona melhor quando você fornece trechos representativos, e não só um pedido de alto nível. Inclua o bloco antigo live_design!, quaisquer declarações #[derive(...)], métodos de lifecycle e o estado do widget que você quer preservar. Se você disser apenas “atualize minha UI”, o skill precisa inferir demais; se você colar a sintaxe antiga exata, ele consegue mapear cada construção diretamente.

Leia estes arquivos primeiro

Comece com SKILL.md para entender o enquadramento da migração e depois abra references/migration-guide.md para ver a tabela detalhada de sintaxe e os exemplos. Esses dois arquivos dão o caminho mais rápido para o fluxo prático de makepad-2.0-migration usage, especialmente quando você precisa confirmar se uma mudança é renomeação, reescrita estrutural ou alteração de padrão em runtime.

Um bom fluxo de trabalho

Use o skill em três passadas: identifique a construção antiga, converta-a com a tabela de mapeamento e depois verifique mudanças semânticas, como a sintaxe de referência de estado e o comportamento de merge de propriedades. Em migrações maiores, trabalhe arquivo por arquivo para conseguir validar a saída após cada conversão, em vez de pedir uma reescrita do repositório inteiro de uma vez.

Perguntas frequentes sobre o skill makepad-2.0-migration

Isso serve só para upgrades de Makepad 1.x para 2.0?

Sim. O skill makepad-2.0-migration foi criado para trabalho de migração, não para design geral de aplicações em Makepad. Se você está começando um projeto novo em 2.0, um prompt novo ou um guia focado em 2.0 pode ser uma opção melhor.

Preciso conhecer a nova sintaxe antes?

Não, mas você precisa fornecer código antigo suficiente para que o skill traduza com precisão. Iniciantes podem usá-lo, mas os melhores resultados aparecem quando você cola um trecho concreto e pede uma migração direta, em vez de uma explicação abstrata.

Em que ele é melhor do que um prompt normal?

Um prompt comum muitas vezes deixa passar as renomeações exatas e as mudanças estruturais que quebram migrações no Makepad. O makepad-2.0-migration skill acrescenta um enquadramento de conversão mais rígido, então ele detecta melhor drift de sintaxe, renomeações de lifecycle e diferenças na atualização de propriedades que importam durante o upgrade.

Quando eu não devo usá-lo?

Não use para refatorações Rust sem relação com migração, limpeza genérica de UI ou planejamento amplo de arquitetura no Makepad. Se a sua tarefa não for especificamente um tipo de upgrade makepad-2.0-migration install, o skill será menos útil do que um prompt direcionado ao stack real que você está usando.

Como melhorar o skill makepad-2.0-migration

Informe as restrições de origem e destino

Os melhores resultados vêm quando você diz ao skill o que precisa permanecer inalterado: comportamento do widget, nomes de estado, intenção do tema ou layout dos arquivos. Se houver restrições como “mantenha a API pública estável” ou “evite mudar o fluxo de eventos”, deixe isso explícito desde o início para que a saída da migração não otimize só a sintaxe.

Inclua primeiro as linhas mais difíceis

O principal ponto de falha na migração para Makepad é o tratamento incompleto das partes mais delicadas: limites de macro, definições aninhadas de widgets e hooks de lifecycle. Cole primeiro as linhas que usam live_design!, atributos de derive, referências de estado ou comportamento de merge, porque é aí que a qualidade do makepad-2.0-migration usage realmente é decidida.

Peça uma migração verificada, não apenas conversão

Um pedido mais forte é: Convert this file to Makepad 2.0, list any behavior changes, and flag any syntax that needs manual verification. Esse formato ajuda o skill a entregar um resultado mais seguro para equipes de makepad-2.0-migration for Backend Development que precisam de notas confiáveis de migração, e não apenas de código transformado.

Itere em um arquivo e depois generalize

Depois da primeira resposta, compare com references/migration-guide.md e teste o arquivo convertido no contexto real. Se algo falhar, devolva o erro exato do compilador ou a divergência em runtime e peça uma correção mais específica. Esse ciclo produz saídas melhores do que pedir repetidamente uma reescrita completa sem diagnósticos.