makepad-2.0-migration

makepad-2.0-migration 技能概覽

這個技能能做什麼

makepad-2.0-migration 技能可協助你將 Makepad 專案從 1.x 遷移到 2.0，減少猜測成本。它是為了需要把舊的 live_design! 模型實際轉換成較新的 script_mod! 工作流程的讀者而設計的，包含語法更新、derive macro 重新命名，以及 runtime scripting 模式等內容。

適合誰使用

如果你正在更新既有 codebase、檢視 breaking changes，或想把舊的 widget 定義翻成新語法，就適合使用 makepad-2.0-migration 技能。它特別適合維護者、支援 UI code 的後端側工具負責人，以及需要一份更像實作清單、而不是大而泛教學的 migration guide 的開發者。

為什麼它不一樣

這個技能聚焦在精準對應與遷移流程，而不是從零學 Makepad。它最大的價值在於降低轉譯錯誤：尖括號改成大括號、Live 對應 Script、LiveHook 對應 ScriptHook、apply_over 對應 script_apply_eval，以及相關的生命週期與 theme 變動。當你手上已經有舊程式碼時，makepad-2.0-migration 會比一般通用提示更能支援決策。

如何使用 makepad-2.0-migration 技能

正確安裝並觸發

先用目錄中一般的技能指令安裝 makepad-2.0-migration 技能，接著在你的任務明確涉及 Makepad 1.x 到 2.0 轉換時再呼叫它。好的觸發提示會清楚寫出來源版本、目標版本和你要遷移的檔案型別，例如：Migrate this Makepad 1.x widget file to 2.0 script_mod syntax and preserve behavior.

提供對的輸入

這個技能在你提供具代表性的片段時效果最好，而不只是高層級需求。請包含舊的 live_design! 區塊、任何 #[derive(...)] 宣告、生命週期方法，以及你希望保留的 widget state。若你只說「幫我升級 UI」，技能就必須猜測太多；但如果你貼出精確的舊語法，它就能逐一對應每個結構。

先讀這些檔案

先從 SKILL.md 開始了解遷移脈絡，再打開 references/migration-guide.md 查看詳細的語法對照表與範例。這兩個檔案能讓你最快進入實用的 makepad-2.0-migration usage 工作流程，尤其是在你需要確認某個變更到底是重新命名、結構重寫，還是 runtime 模式轉換時。

一個好的工作流程

建議把技能分成三輪使用：先辨識舊結構，再用 mapping table 轉換，最後檢查像 state 引用語法、property merge 行為這類語意變動。若是較大型的遷移，最好逐檔處理，這樣你可以在每次轉換後驗證輸出，而不是一次要求整個 repo 全部重寫。

makepad-2.0-migration 技能 FAQ

這只適用於 Makepad 1.x 升級到 2.0 嗎？

是。makepad-2.0-migration 技能是為遷移工作設計的，不是用來做一般 Makepad 應用設計的。如果你是從零開始做 2.0 新專案，重新寫一個提示詞，或使用更偏向 2.0 的指南，通常會更合適。

我需要先懂新語法嗎？

不需要，但你必須提供足夠的舊程式碼，技能才能準確翻譯。初學者也能用，不過最好的結果通常來自你貼出具體片段，並要求直接遷移，而不是抽象說明。

它比一般提示詞好在哪裡？

一般提示詞常常會漏掉 Makepad 遷移時最容易出錯的精確重新命名與結構變動。makepad-2.0-migration skill 提供更緊密的轉換框架，因此在升級工作中更擅長抓出語法漂移、生命週期重新命名，以及 property 更新差異這些真正重要的問題。

什麼情況下不該用？

不要把它用在無關的 Rust 重構、一般 UI 清理，或大方向的 Makepad 架構規劃上。若你的任務並不是明確屬於 makepad-2.0-migration install 這類升級工作，這個技能就不會比針對你實際技術棧的精準提示更有幫助。

如何改進 makepad-2.0-migration 技能

提供來源與目標限制

最好的結果通常來自你先說清楚哪些東西不能變：widget 行為、state 名稱、theme 意圖，或檔案結構。如果你有像「維持公開 API 穩定」或「不要改事件流」這類限制，請一開始就講明，這樣遷移輸出才不會只為了語法而過度最佳化。

先貼最難的幾行

Makepad 遷移最常見的失敗模式，是沒有完整處理最棘手的部分：macro 邊界、巢狀 widget 定義，以及生命週期 hooks。請優先貼出使用 live_design!、derive attributes、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 團隊，而不只是轉好的程式碼。

先單檔迭代，再擴大套用

拿到第一次答案後，請對照 references/migration-guide.md，並在實際情境中測試轉換後的檔案。若有問題，把精確的 compiler error 或 runtime 不一致回饋回去，再要求更小範圍的修正。這種迴圈通常比反覆要求整份重寫、卻沒有任何診斷資訊，能產出更好的結果。