makepad-2.0-dsl

Vue d’ensemble du skill makepad-2.0-dsl

makepad-2.0-dsl est un skill ciblé pour travailler avec le Makepad 2.0 DSL, surtout lorsque vous devez écrire, lire ou corriger du code UI script_mod! sans retomber dans les réflexes syntaxiques de la version 1.x. Il est particulièrement adapté aux développeurs frontend, aux auteurs d’interfaces Rust et aux agents qui ont besoin d’un guide pratique sur makepad-2.0-dsl pour l’affectation de propriétés, les widgets nommés, le comportement de fusion et les patterns de liaison Rust.

Ce que ce skill vous aide à faire

Son rôle principal est de transformer une intention UI approximative en Makepad 2.0 DSL valide : choisir : plutôt que =, utiliser := pour les instances nommées et appliquer correctement la syntaxe de fusion. C’est important, parce que beaucoup d’échecs viennent de la syntaxe, pas de la conception, et l’aide générique de prompt rate souvent les opérateurs exacts attendus par Makepad.

Pourquoi l’installer

Le skill makepad-2.0-dsl est surtout utile quand la justesse du résultat dépend de règles DSL fines : pas de virgules entre les éléments frères, remplacements via des chemins avec points, liaisons let et catégories de propriétés qui influencent la mise en page ou le dessin. Si vous avez besoin d’une génération de code prévisible ou d’un support de revue de code pour Makepad 2.0, ce skill réduit fortement les essais-erreurs.

Cas d’usage les plus adaptés

Utilisez-le lorsque vous construisez une application Makepad, que vous traduisez d’anciens exemples live_design! ou que vous vérifiez si un arbre de widgets se comportera correctement à l’exécution. Il est moins utile si vous cherchez seulement un prompt UI général sans besoin de syntaxe Makepad exacte.

Comment utiliser le skill makepad-2.0-dsl

Installez-le et déclenchez-le correctement

Installez avec :

npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-dsl

Déclenchez le skill makepad-2.0-dsl lorsque votre demande mentionne clairement le Makepad 2.0 DSL, script_mod!, un problème de système de propriétés ou un souci de widget nommé. Si vous demandez de l’aide à un agent, formulez l’objectif et le mode d’échec : « Convertis ce snippet Makepad hérité vers le DSL 2.0 » est bien meilleur que « nettoie ça ».

Donnez une entrée que le DSL peut vraiment exploiter

Les bonnes demandes décrivent la structure des widgets, l’intention de mise en page et les éléments qui doivent rester accessibles depuis Rust. Par exemple, précisez si un enfant doit avoir un id, si le parent est en Fit, et quelles propriétés doivent être héritées ou remplacées. Une demande faible dit « rends ça plus joli » ; une demande plus solide dit « construis un panneau en deux colonnes avec un bouton d’envoi nommé, une hauteur d’en-tête fixe et un style d’arrière-plan hérité ».

Lisez d’abord ces fichiers

Commencez par SKILL.md, puis examinez references/dsl-syntax-reference.md et references/property-system.md. Ces deux références couvrent les règles les plus susceptibles de bloquer l’adoption : formes de syntaxe, sémantique de fusion, valeurs par défaut de mise en page et le piège height: Fit qui peut faire disparaître des conteneurs imbriqués.

Le workflow qui donne de meilleurs résultats

Suivez une boucle courte : décrivez l’objectif du widget, demandez un brouillon en Makepad 2.0 DSL, puis vérifiez le résultat avec la référence syntaxique avant de l’appliquer. Pour l’usage de makepad-2.0-dsl, faites attention à l’emplacement de width, height, flow et draw_* dans la bonne catégorie de propriétés, car un mauvais placement provoque généralement une mise en page ou un style cassés.

FAQ du skill makepad-2.0-dsl

Est-ce réservé aux projets Makepad 2.0 ?

Oui. Ce skill makepad-2.0-dsl vise le DSL 2.0 et son workflow script_mod!, pas l’ancien style de macro live_design!. Si votre base de code est encore sur les conventions 1.x, utilisez-le comme aide à la migration plutôt que comme solution prête à l’emploi.

Est-ce mieux qu’un prompt générique ?

En général oui, parce que sa valeur tient à la précision syntaxique, pas à la créativité. Un prompt générique peut décrire l’UI, mais makepad-2.0-dsl a plus de chances de conserver la syntaxe avec :, les instances nommées et les règles de fusion réellement imposées par Makepad.

Les débutants peuvent-ils l’utiliser ?

Oui, à condition d’avoir une cible concrète, widget ou mise en page. Les débutants obtiennent généralement de meilleurs résultats lorsqu’ils fournissent un croquis sommaire, les noms attendus des enfants et précisent s’ils ont besoin d’un accès Rust aux éléments via id! ou ids!.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas ce skill si vous n’écrivez pas de code UI Makepad ou si vous avez seulement besoin de conseils frontend généraux sans contrainte de DSL. Il est aussi mal adapté lorsque la demande est trop vague pour être reliée à un arbre de widgets, à un ensemble de propriétés ou à un pattern de liaison.

Comment améliorer le skill makepad-2.0-dsl

Fournissez dès le départ les contraintes vraiment importantes

Les gains de qualité les plus nets viennent du partage anticipé des détails de mise en page et de propriété : comportement de taille du parent, enfants nommés et indication claire sur le fait qu’un template doit être fusionné ou remplacé. Pour makepad-2.0-dsl en développement frontend, ces contraintes comptent souvent plus que les préférences de style visuel.

Évitez les modes d’échec les plus courants

Les erreurs les plus fréquentes consistent à utiliser =, à oublier que les propriétés de frères sont séparées par des espaces, et à placer un conteneur dans Fit sans height: Fit. Un autre problème récurrent est de demander un widget nommé tout en oubliant que := change la façon dont l’instance est stockée et référencée.

Demandez une sortie au format dont vous avez besoin

Si vous voulez du code réutilisable, dites-le et demandez un modèle basé sur let ou un exemple de widget enregistré. Si vous voulez un correctif direct, demandez uniquement le bloc modifié et mentionnez le chemin exact de la propriété, par exemple draw_bg.color ou title.text, pour que la réponse soit plus simple à appliquer.

Itérez en testant une règle à la fois

Quand la première sortie est proche mais pas juste, réécrivez la demande avec le plus petit changement possible : ajustez une seule règle de mise en page, une seule cible de liaison ou un seul chemin de fusion. Cela permet au guide makepad-2.0-dsl de rester centré sur le point qui a réellement échoué, ce qui est généralement plus rapide que de régénérer toute l’UI.