makepad-2.0-events

makepad-2.0-events skill の概要

makepad-2.0-events ができること

makepad-2.0-events skill は、Makepad 2.0 のイベント処理とアクション処理を、コールバックの形や state の流れ、レンダリングのタイミングを推測せずに扱うための skill です。Splash の UI 操作を Rust 側のロジックにつなぎたいときや、イベントが発火しない・伝播しない・ビューが更新されない理由を調べているときに特に役立ちます。

こんな人に向いています

makepad-2.0-events skill は、Makepad のフロントエンド UI を新規構築したり保守したりしている人に向いています。とくに on_click, on_render, on_return, on_startup, MatchEvent, script_eval! に依存するコンポーネント駆動のアプリには相性が良いです。Frontend Development の中でも、難しいのが構文そのものではなく、ロジックを Splash に置くべきか Rust に置くべきか、それとも両者をつなぐ橋渡し層に置くべきかを判断する場面で強みがあります。

ほかと何が違うのか

この skill は、Makepad の 2 層モデルを軸にしています。つまり、ローカルな UI 挙動は Splash のインラインハンドラーで、アプリ全体のロジック、非同期処理、外部 state は Rust のイベントマッチで扱います。この分離こそが導入判断の要です。単に「イベントを処理する」ための一般的なプロンプトでは、Makepad 固有のルールを取りこぼしやすいですが、この skill ならどの層を使うべきかを見極め、正しく配線できます。

makepad-2.0-events skill の使い方

インストールして最初に読む場所

通常の skill コマンドで makepad-2.0-events skill をインストールしたら、まず SKILL.md を開き、次に references/event-patterns.md を確認してください。この repo では、この 2 つのファイルが makepad-2.0-events usage を最短で実用レベルに乗せる入口になります。特に reference ファイルには、ゼロから書き直すのではなく流用できる実践パターンがまとまっています。

あいまいな目的を使えるプロンプトに変える

最も良い結果を得るには、少なくとも 3 つを明示してください。対象の widget かイベント発生源、期待する state 変更、そして更新をどこで起こしたいかです。弱い依頼は「ボタンを動くようにして」です。より強いプロンプトは「makepad-2.0-events を使って、Splash の Button クリックを state.counter の更新に結びつけ、script_eval! と .render() でラベルも再描画して」です。これだけ構造があれば、skill はインラインハンドラー、Rust のマッチング、実行時のパッチ適用のどれを使うべきか判断しやすくなります。

repo のどこを見るべきか

まずは references/event-patterns.md を見て、ボタンクリック、起動時の描画、state 駆動の UI 更新といった完全なフローを確認してください。そのうえで、SKILL.md のイベント関連セクションを見て、ハンドラー名、ブリッジ用マクロ、スコープ境界を把握します。自分のアプリに合わせてパターンを応用するなら、新しい流れを思いつきで作る前に、近い既存のイベント経路を探すのが先です。

実務で役立つ使い方のコツ

できるだけ小さく完結するイベントチェーン、つまり source event、handler、state mutation、re-render の最短経路を優先してください。Makepad 2.0 では、ロジックを誤った層に置くことと、state 変更後の render を忘れることが、導入時のつまずきの大半です。Frontend Development で makepad-2.0-events skill を使うときは、回答を Splash のままにしたいのか、Rust に移したいのか、それとも script_eval! や script_apply_eval! で bridge をまたぐのかを、プロンプトで明確に指定してください。

makepad-2.0-events skill FAQ

これは Makepad 2.0 の UI イベント専用ですか？

はい。makepad-2.0-events skill は、一般的なフロントエンドのイベントシステムではなく、Makepad 2.0 のイベント処理とアクション処理に特化しています。React や Vue、ほかのフレームワークを使っている場合、考え方の参考にはなっても、コードをそのまま移すことはできません。

使う前に Makepad を知っている必要がありますか？

基本的な Makepad の知識があるとより使いやすいですが、フレームワークを学びながら event flow を理解したい場合にも、この skill は十分役立ちます。とくに、UI に何をさせたいかは分かっているのに、on_click、MatchEvent、ブリッジ用マクロのどれを書けばよいか迷っているときに有効です。

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

作業の中心がレイアウト、スタイリング、またはイベントと関係のないアプリ構成なら、makepad-2.0-events skill を使う必要はありません。さらに、問題がイベント駆動ではない場合も対象外です。この skill は、インタラクション処理、コールバックの挙動、state 更新に最適化されています。

一般的なプロンプトより何が優れているのですか？

一般的なプロンプトでもイベントの説明はできますが、makepad-2.0-events skill は Makepad の実際の制御フロー、命名、コードの形に合わせて調整されています。必要なのが概念的な説明ではなく、実際に動くイベント経路なら、この差は大きいです。

makepad-2.0-events skill の改善方法

交互作用の全体経路を伝える

makepad-2.0-events usage を最大化するには、イベントの発生源、期待する出力、state の所有者をはっきり指定することが重要です。たとえば、「TextInput が変化したら、Splash で state.query を更新し、debounce は Rust 側だけで行い、filtered list を再描画して」といった形です。単に「入力変更を処理して」より強いのは、ロジックをどこに置くのか、何を成功条件とみなすのかまで伝わるからです。

いま起きている失敗パターンを含める

デバッグ目的なら、症状をそのまま書いてください。たとえば、callback が呼ばれない、state は変わるのに UI が更新されない、action は Rust に届くのに widget tree に反映されない、などです。こうした情報があると、makepad-2.0-events skill は handler の配線ミス、bridge の使い方、render タイミングの問題を切り分けやすくなります。

動くパターンを起点に反復する

reference の例を土台にして、widget type、event type、state update path のどれか 1 つだけを変えていくのが効果的です。そうすると推測が減り、問題が構文なのか、スコープなのか、ライフサイクルなのかを見つけやすくなります。makepad-2.0-events では、これが出力品質を上げる最短ルートであることが多いです。

本当に必要な層を指定する

ローカルな UI 挙動だけなら、Splash だけで完結する解決策を求めてください。業務ロジック、非同期処理、外部連携が必要なら、Rust 側の MatchEvent フローを依頼してください。どの層を使うかを明確にすることが、この skill で最も効く品質向上策です。不要な責務を混ぜ込んだ複雑な回答を避けることにもつながります。