makepad-2.0-dsl

makepad-2.0-dsl skill の概要

makepad-2.0-dsl は、Makepad 2.0 DSL を扱うための特化型スキルです。特に、script_mod! の UI コードを 1.x の構文感覚に引きずられずに書く・読む・修正する必要があるときに役立ちます。フロントエンド開発者、Rust の UI 作者、そしてプロパティ代入、名前付きウィジェット、マージ挙動、Rust バインディングのパターンまで含めた実用的な makepad-2.0-dsl ガイドを必要とするエージェントに最適です。

このスキルでできること

主な役割は、曖昧な UI の意図を正しい Makepad 2.0 DSL に落とし込むことです。たとえば、= ではなく : を選ぶ、名前付きインスタンスには := を使う、マージ構文を正しく適用する、といった部分です。ここが重要なのは、失敗の多くがデザインではなく構文に起因し、一般的なプロンプト支援では Makepad が期待する演算子を正確に外してしまいやすいからです。

インストールする価値がある理由

makepad-2.0-dsl skill が特に力を発揮するのは、出力の正しさが細かな DSL ルールに左右される場面です。兄弟要素の間にカンマを入れないこと、dot-path のオーバーライド、let バインディング、レイアウトや描画に影響するプロパティ分類などがその例です。Makepad 2.0 で予測可能なコード生成やコードレビュー支援が必要なら、このスキルは試行錯誤を減らしてくれます。

最適な用途

Makepad アプリを構築しているとき、古い live_design! の例を移植しているとき、あるいはウィジェットツリーが実行時に正しく振る舞うか確認したいときに使ってください。逆に、一般的な UI プロンプトだけ欲しく、Makepad の厳密な構文までは必要ないなら、あまり向きません。

makepad-2.0-dsl skill の使い方

正しくインストールしてトリガーする

以下でインストールします。

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

Makepad 2.0 DSL、script_mod!、プロパティシステムの問題、名前付きウィジェットの問題が明確に含まれるときに、makepad-2.0-dsl skill をトリガーしてください。エージェントに手伝わせるなら、目的と失敗モードをはっきり書くほうが有効です。「古い Makepad の断片を 2.0 DSL に変換して」は、「これをきれいにして」よりずっと良い指示です。

DSL が実際に使える入力を渡す

良い入力には、ウィジェット構造、レイアウトの意図、Rust からどの部分を参照可能にする必要があるかが含まれます。たとえば、子要素に id が必要か、親が Fit か、どのプロパティを継承しどれを置き換えるのかを明示してください。弱いプロンプトは「見た目をもっと良くして」です。強いプロンプトは「名前付きの送信ボタン、固定ヘッダー高、背景スタイルは継承する 2 カラムのパネルを作って」です。

先に読むべきファイル

まず SKILL.md を読み、その後 references/dsl-syntax-reference.md と references/property-system.md を確認してください。この 2 つの参照には、導入を阻む可能性が高いルール、つまり構文形式、マージの意味、レイアウトのデフォルト、そしてネストしたコンテナが見えなくなることがある height: Fit の落とし穴がまとまっています。

より良い出力を得るワークフロー

短いループで進めるのが有効です。ウィジェットの目的を説明し、Makepad 2.0 DSL のドラフトを依頼し、その結果を syntax reference と照らし合わせてから適用します。makepad-2.0-dsl の利用では、回答が width、height、flow、draw_* を正しいプロパティカテゴリに置いているかを特に確認してください。配置がずれると、レイアウトやスタイルが壊れることが多いからです。

makepad-2.0-dsl skill の FAQ

これは Makepad 2.0 プロジェクト専用ですか？

はい。makepad-2.0-dsl skill は 2.0 DSL と script_mod! のワークフローを対象にしており、旧来の live_design! マクロスタイル向けではありません。コードベースがまだ 1.x の慣習にあるなら、直接置き換えるものではなく、移行補助として使ってください。

一般的なプロンプトより優れていますか？

通常ははいです。ここでの価値は創造性ではなく、構文の正確さにあるからです。一般的なプロンプトでも UI の説明はできますが、makepad-2.0-dsl のほうが、Makepad が実際に強制するコロン構文、名前付きインスタンス、マージルールを保ちやすいです。

初心者でも使えますか？

はい。ただし、具体的な対象ウィジェットやレイアウトがある場合に限ります。初心者が最も良い結果を得やすいのは、ざっくりしたスケッチ、期待する子要素名、そして id! や ids! を通じて Rust から要素にアクセスする必要があるかどうかを一緒に伝えたときです。

使わないほうがいいのはどんなときですか？

Makepad の UI コードを書いていない場合や、DSL 制約なしで広い意味のフロントエンド助言だけ欲しい場合は使わないでください。また、ウィジェットツリー、プロパティ集合、バインディングパターンに落とし込めないほど要望が曖昧なときも、相性はよくありません。

makepad-2.0-dsl skill の改善方法

重要な制約を先に渡す

品質を大きく上げるには、レイアウトと所有関係の情報を最初に共有することです。親のサイズ挙動、名前付き子要素、テンプレートをマージするのか置き換えるのか、という点が特に重要です。makepad-2.0-dsl for Frontend Development では、こうした制約は見た目の好みよりずっと大切なことがよくあります。

よくある失敗を避ける

典型的なミスは、= を使ってしまうこと、兄弟プロパティが空白区切りであることを忘れること、そして Fit の中にコンテナを置くのに height: Fit を付けないことです。もう 1 つよくあるのは、名前付きウィジェットを依頼しているのに、:= によってインスタンスの保存方法と参照方法が変わる点を見落とすことです。

必要な形で出力を依頼する

再利用可能なコードが欲しいなら、その旨を伝えて let ベースのテンプレートか、登録済みウィジェットの例を求めてください。直接の差分が欲しいなら、変更ブロックだけを依頼し、draw_bg.color や title.text のように正確なプロパティパスを明記すると、適用しやすい回答になります。

1 つずつ試して調整する

最初の出力が惜しいけれど正確ではない場合は、プロンプトを最小限だけ修正してください。レイアウト 1 つ、バインディング先 1 つ、マージパス 1 つだけを調整します。そのほうが、makepad-2.0-dsl guide が本当に失敗した箇所に集中できるので、UI 全体を再生成するより早いことが多いです。