makepad-2.0-migration

Aperçu du skill makepad-2.0-migration

Ce que fait ce skill

Le skill makepad-2.0-migration vous aide à migrer des projets Makepad de la version 1.x vers la 2.0 avec moins d’hésitations. Il est pensé pour celles et ceux qui ont besoin d’un chemin concret pour quitter l’ancien modèle live_design! et passer au workflow plus récent basé sur script_mod!, y compris les mises à jour de syntaxe, les renommages de macros derive et les nouveaux patterns de scripting à l’exécution.

À qui il s’adresse

Utilisez le skill makepad-2.0-migration si vous mettez à jour une base de code existante, si vous passez en revue des breaking changes ou si vous essayez de traduire d’anciennes définitions de widgets vers la nouvelle syntaxe. Il est particulièrement utile pour les mainteneurs, les responsables d’outils côté backend qui prennent en charge du code UI, et les développeurs qui ont besoin d’un guide de migration plus proche d’une checklist d’implémentation que d’un tutoriel général.

Pourquoi il est différent

Ce skill est centré sur le mappage exact et le workflow de migration, pas sur l’apprentissage de Makepad depuis zéro. Sa valeur principale est de réduire les erreurs de traduction : les chevrons deviennent des accolades, Live devient Script, LiveHook devient ScriptHook, apply_over devient script_apply_eval, avec les changements associés de cycle de vie et de thème. Cela rend makepad-2.0-migration plus utile pour la prise de décision qu’une invite générique lorsque vous avez déjà du code legacy sous la main.

Comment utiliser le skill makepad-2.0-migration

Installer et déclencher le skill correctement

Installez le skill makepad-2.0-migration avec la commande standard du répertoire de skills, puis invoquez-le lorsque votre tâche concerne clairement une conversion de Makepad 1.x vers 2.0. Une invite de déclenchement efficace indique la version source, la version cible et le type de fichier à migrer, par exemple : Migrate this Makepad 1.x widget file to 2.0 script_mod syntax and preserve behavior.

Fournir les bons inputs

Le skill donne les meilleurs résultats quand vous fournissez des extraits représentatifs, pas seulement une demande de haut niveau. Incluez le bloc live_design! d’origine, les déclarations #[derive(...)], les méthodes de cycle de vie et l’état du widget que vous voulez conserver. Si vous vous contentez de dire « upgrade my UI », le skill doit trop deviner ; si vous collez la syntaxe exacte d’origine, il peut mapper chaque construction directement.

Lire ces fichiers en premier

Commencez par SKILL.md pour le cadrage de la migration, puis ouvrez references/migration-guide.md pour le tableau de syntaxe détaillé et les exemples. Ces deux fichiers donnent le chemin le plus court vers un flux de travail makepad-2.0-migration usage concret, surtout quand vous devez confirmer s’il s’agit d’un renommage, d’une réécriture structurelle ou d’un changement de pattern d’exécution.

Un bon workflow

Utilisez le skill en trois passes : identifiez l’ancienne construction, convertissez-la à l’aide du tableau de correspondance, puis vérifiez les changements sémantiques comme la syntaxe des références d’état et le comportement de fusion des propriétés. Pour les migrations plus volumineuses, procédez fichier par fichier afin de pouvoir valider le résultat après chaque conversion, au lieu de demander une réécriture de tout le dépôt en une seule étape.

FAQ du skill makepad-2.0-migration

Ce skill sert-il seulement aux mises à niveau de Makepad 1.x vers 2.0 ?

Oui. Le skill makepad-2.0-migration est destiné au travail de migration, pas à la conception générale d’applications Makepad. Si vous démarrez un nouveau projet en 2.0, une invite neuve ou un guide centré sur la 2.0 sera souvent plus adapté.

Dois-je connaître la nouvelle syntaxe avant de l’utiliser ?

Non, mais vous devez fournir suffisamment de code ancien pour que le skill puisse traduire avec précision. Les débutants peuvent l’utiliser, mais les meilleurs résultats arrivent quand vous collez un extrait concret et demandez une migration directe plutôt qu’une explication abstraite.

En quoi est-il meilleur qu’une invite normale ?

Une invite normale rate souvent les renommages exacts et les changements structurels qui cassent les migrations Makepad. Le makepad-2.0-migration skill apporte un cadre de conversion plus serré, ce qui lui permet mieux de détecter les dérives de syntaxe, les renommages de cycle de vie et les différences de mise à jour des propriétés qui comptent pendant une montée de version.

Quand ne faut-il pas l’utiliser ?

Ne l’utilisez pas pour des refactorings Rust sans rapport, du nettoyage générique d’interface ou une planification large de l’architecture Makepad. Si votre tâche ne relève pas spécifiquement d’un travail de mise à niveau de type makepad-2.0-migration install, le skill sera moins utile qu’une invite ciblée sur votre stack réelle.

Comment améliorer le skill makepad-2.0-migration

Fournir les contraintes source et cible

Les meilleurs résultats viennent des indications sur ce qui doit rester inchangé : comportement des widgets, noms d’état, intention du thème ou organisation des fichiers. Si vous avez des contraintes du type « garder l’API publique stable » ou « éviter de modifier le flux d’événements », dites-le dès le départ pour que la sortie de migration n’optimise pas uniquement la syntaxe.

Inclure d’abord les lignes les plus délicates

Le principal mode d’échec dans une migration Makepad, c’est la mauvaise prise en charge des parties difficiles : frontières des macros, définitions imbriquées de widgets et hooks de cycle de vie. Collez d’abord les lignes qui utilisent live_design!, les attributs derive, les références d’état ou le comportement de fusion, car ce sont elles qui déterminent la qualité de makepad-2.0-migration usage.

Demander une migration vérifiée, pas seulement une conversion

Une demande plus solide serait : Convert this file to Makepad 2.0, list any behavior changes, and flag any syntax that needs manual verification. Ce format aide le skill à produire un résultat plus sûr pour les équipes makepad-2.0-migration for Backend Development qui ont besoin de notes de migration fiables, pas seulement de code transformé.

Itérer sur un fichier, puis généraliser

Après la première réponse, comparez-la avec references/migration-guide.md et testez le fichier converti dans son contexte. Si quelque chose échoue, renvoyez l’erreur de compilation exacte ou l’écart à l’exécution, puis demandez une correction plus ciblée. Cette boucle donne de meilleurs résultats que de redemander sans cesse une réécriture complète sans diagnostic.