makepad-2.0-migration

makepad-2.0-migration skill の概要

この skill でできること

makepad-2.0-migration skill は、Makepad プロジェクトを 1.x から 2.0 へ、試行錯誤を減らしながら移行するための skill です。旧来の live_design! モデルから、新しい script_mod! ベースのワークフローへ移るときに必要な、構文更新、derive macro の名称変更、ランタイムスクリプティングのパターンまで、実務寄りに案内します。

どんな人向けか

既存コードベースの更新、破壊的変更の確認、古い widget 定義の新しい構文への置き換えを進めているなら、makepad-2.0-migration skill が向いています。特に、保守担当者、UI コードを支えるバックエンド側のツール担当、そして幅広い入門ではなく実装チェックリストに近い移行ガイドを必要としている開発者に有用です。

何が違うのか

この skill は Makepad をゼロから学ぶためではなく、正確な対応付けと移行ワークフローに焦点を当てています。主な価値は変換ミスを減らすことです。たとえば、< > を { } に、Live を Script に、LiveHook を ScriptHook に、apply_over を script_apply_eval に置き換えるほか、関連するライフサイクルやテーマの変更も整理できます。そのため、既にレガシーコードを手元に持っている場合は、一般的な prompt よりも makepad-2.0-migration のほうが判断材料として使いやすいです。

makepad-2.0-migration skill の使い方

正しくインストールして起動する

ディレクトリ標準の skill コマンドで makepad-2.0-migration skill をインストールし、対象タスクが Makepad 1.x から 2.0 への変換であると明確なときに呼び出します。強いトリガー文は、元のバージョン、移行先のバージョン、そして移行するファイル種別をはっきり示します。たとえば: Migrate this Makepad 1.x widget file to 2.0 script_mod syntax and preserve behavior.

適切な入力を渡す

この skill は、高レベルの依頼だけでなく、代表的な断片を渡したときに最もよく働きます。古い live_design! ブロック、#[derive(...)] 宣言、ライフサイクルメソッド、保持したい widget state を含めてください。単に「UI をアップグレードして」とだけ伝えると、skill 側が推測しすぎることになります。古い構文をそのまま貼れば、各構文要素を直接対応付けできます。

まず読むべきファイル

最初に SKILL.md で移行の考え方を確認し、次に references/migration-guide.md を開いて、詳細な構文表と例を見てください。この 2 つのファイルが、実践的な makepad-2.0-migration usage の流れに入る最短ルートです。特に、変更が単なる rename なのか、構造の書き換えなのか、ランタイムのパターン変更なのかを見分けたいときに役立ちます。

おすすめの進め方

skill は 3 段階で使うと効率的です。まず旧構文を特定し、次に対応表で変換し、最後に state 参照の構文や property merge の挙動など意味論の変更を確認します。大きな移行では、リポジトリ全体を一気に書き換えるよう頼むより、ファイル単位で進めて、各変換のたびに出力を確認するほうが安全です。

makepad-2.0-migration skill の FAQ

これは Makepad 1.x から 2.0 へのアップグレード専用ですか？

はい。makepad-2.0-migration skill は移行作業向けであり、一般的な Makepad アプリ設計向けではありません。新規に 2.0 でプロジェクトを始めるなら、ゼロからの prompt か 2.0 に特化したガイドのほうが合っている場合があります。

新しい構文を先に知っている必要がありますか？

いいえ。ただし、skill が正確に変換できるだけの古いコードは必要です。初心者でも使えますが、抽象的な説明を求めるより、具体的な snippet を貼って直接移行を依頼したほうが結果はよくなります。

通常の prompt より何が優れていますか？

通常の prompt では、Makepad の移行で壊れやすい正確な rename や構造変更を見落としがちです。makepad-2.0-migration skill は変換の枠組みがより厳密なので、アップグレード時に重要な構文のずれ、ライフサイクル名の変更、property 更新の違いを拾いやすくなります。

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

Makepad とは関係のない Rust リファクタリング、一般的な UI 整理、広い意味での Makepad アーキテクチャ設計には使わないでください。タスクが makepad-2.0-migration install のようなアップグレード作業に明確に当てはまらないなら、そのスタックに合わせた targeted prompt のほうが有効です。

makepad-2.0-migration skill を改善するには

移行元と移行先の制約を伝える

最も良い結果は、skill に「何を変えてはいけないか」を明示したときに得られます。widget の挙動、state 名、theme の意図、ファイル構成などです。public API を維持したい、event flow は変えたくない といった制約があるなら、最初に伝えてください。構文だけを最適化してしまうのを防げます。

難しい行を先に含める

Makepad 移行で失敗しやすいのは、難所の扱いが不十分なことです。特に、macro の境界、入れ子になった widget 定義、ライフサイクル hook が要注意です。live_design!、derive attribute、state 参照、merge 動作を使っている行を先に貼ってください。makepad-2.0-migration usage の品質は、まさにその部分で決まります。

単なる変換ではなく、確認付きの移行を依頼する

より強い依頼文は、Convert this file to Makepad 2.0, list any behavior changes, and flag any syntax that needs manual verification. です。この形にすると、makepad-2.0-migration for Backend Development チームが必要とするような、変換済みコードだけでなく安全性の高い移行メモも返しやすくなります。

1 ファイルずつ進めてから一般化する

最初の回答を得たら、references/migration-guide.md と照らし合わせ、変換後ファイルを実際の文脈で試してください。失敗したら、出た compiler error や runtime mismatch をそのまま返し、より狭い修正を依頼します。このループのほうが、診断情報なしで全体を書き直させ続けるより、ずっと良い結果につながります。