makepad-2.0-splash

makepad-2.0-splash 技能概覽

makepad-2.0-splash 的用途

makepad-2.0-splash 技能是用來處理 Makepad 2.0 Splash，也就是在 script_mod!{} 內使用的執行期 UI 腳本語言。它可以幫你產生或調整 Splash 程式碼，適合互動式 UI、有狀態的 widgets、hot reload 流程，以及以 Canvas 驅動的應用程式，而且不必靠零散範例去反推語法。

誰適合使用

如果你是在 Rust 裡做 Makepad UI，並且需要可靠的 Splash 語法、狀態處理、事件綁定，或 render/update 模式，那就適合使用 makepad-2.0-splash 技能。它特別適合前端開發工作，像是即時 UI 行為、分頁切換、計時器、文字更新，或需要第一次產出就能直接通過語法檢查的應用外殼。

它和一般提示詞有什麼不同

和泛用的 Makepad 提示詞不同，這個技能是建立在真正的 Splash 規則上：以空白分隔的語法、use mod.prelude.widgets.*、script_mod!{}、mod.state，以及 on_render/fn tick() 這類互動模式。當你的卡關點不是設計，而是要把腳本結構和執行期模型寫對時，makepad-2.0-splash 就特別有用。

如何使用 makepad-2.0-splash 技能

依正確順序安裝與閱讀

要安裝 makepad-2.0-splash，先走 repository 提供的 skill 安裝流程，接著先讀 skills/makepad-2.0-splash/SKILL.md。之後再看 references/splash-language-reference.md 了解語法規則，接著讀 references/splash-scripting-patterns.md 看實際可用的應用模式；如果你的 app 是透過 Canvas 或 POST /splash 工作流程驅動，則一定要再看 references/canvas-splash-patterns.md。這個順序能讓你最快從安裝走到可用的 makepad-2.0-splash usage。

把模糊需求改寫成好提示詞

makepad-2.0-splash 最好的安裝與使用成果，來自於你提供具體的 UI 任務，而不是一句模糊的「做一個 Splash app」。好的輸入會清楚寫出 widget tree、state 和互動模型，例如：「做一個雙分頁的 Splash UI，包含 counter state、分頁切換，以及啟動時的 render。」不好的輸入會省略限制，逼模型去猜 widget 結構、更新路徑，還有程式該用 script_eval!、on_render 還是 fn tick()。

依 repository 的模式做，不只看標題

在 makepad-2.0-splash usage 上，重點要放在影響正確性的模式：先宣告 let bindings 再使用、保持 state 局部且明確，並遵循互動發生在 Splash 內部的執行模型，而不是一再重新 POST 程式碼。如果你要產生 Canvas 程式，canvas-splash-patterns.md 是最重要的決策指南，因為它會說明何時只要 POST 一次、如何刷新資料，以及為什麼 loop-posting 會破壞 widget state。

讓輸出更好的實作流程

一個實用的 makepad-2.0-splash guide 工作流程是：先描述 UI 目標、再指出持久化 state、接著選定事件來源，最後要求輸出符合 repository 語法的程式碼。如果你需要的是可直接貼進 Rust 的結果，請明確說明你要的是只有 Splash 區塊，還是完整的 script_mod!{} 包裝。另外也要說清楚你是否需要 hot reload 相容、Canvas 相容，或是最小範例，因為這些限制都會改變產生出來的腳本結構。

makepad-2.0-splash 技能 FAQ

makepad-2.0-splash 只適用於 Makepad 2.0 嗎？

是的。這個技能是以 Makepad 2.0 Splash 為中心，而不是舊的 live_design! 工作流程或泛用 UI 腳本。如果你的 codebase 還依賴編譯期 UI macros，這個技能也許能幫你理解遷移概念，但不能取代完整的遷移計畫。

安裝前一定要先懂 Splash 嗎？

不用，但你還是要知道自己想要的 app 結果。這個技能對有結構的 UI 任務很友善，因為它會把語法和工作模式講清楚；不過它也預設你能清楚描述 widget tree、state 變化，或事件流程，讓 makepad-2.0-splash 產出真的能用的程式碼。

什麼情況下不適合用？

如果你只是需要一般 Rust 協助、類 CSS 的樣式建議，或只想要一段沒有 Makepad 背景的「frontend development」提示詞，就不適合用 makepad-2.0-splash。如果任務主要是架構設計，而且其實不是在處理 Splash 語法、執行期 state，或 Canvas 執行規則，它也不是好選擇。

跟一般提示詞相比有什麼差別？

一般提示詞也能產出看似合理的答案，但更容易漏掉 Splash 專屬限制，例如空白分隔語法、widget scope，或執行期更新模型。makepad-2.0-splash skill 在你重視正確性勝過發想時更合適，尤其是你要立刻拿去執行的程式碼。

如何改善 makepad-2.0-splash 技能

補上缺少的 state model

提升品質最明顯的方法，是直接把 state 命名出來。不要只說「做一個 dashboard」，而是提供像 selected_tab、elapsed、items、connected 這類欄位，並說明每個欄位怎麼變化。這樣 makepad-2.0-splash 才能產出更容易 render、更新和除錯的程式。

先定義互動邊界

告訴技能在啟動時、點擊時、tick 時，或資料刷新時應該發生什麼事。很多失敗都來自事件歸屬不清，最後產出的程式只能 render 一次，卻無法正確更新。對 makepad-2.0-splash 來說，你越早把 event loop 定義清楚，後面第一次輸出之後要收拾的地方就越少。

依需要要求完整度

如果你只需要片段，就直接說。如果你需要可以直接貼上的區塊，就要求完整的 script_mod!{} 結構，並註明是否要包含 Rust boilerplate。這樣可以避免拿到看起來單獨成立、但其實不符合你專案結構的半成品輸出。

先修語法，再調行為

如果第一版已經接近正確但還不能用，先修 syntax 問題，再加新功能。接著再微調 layout、state 和 event flow。對 makepad-2.0-splash 來說，最常見的改善循環就是：先修正 widget scope、確認 render/update 模式，然後再針對實際 app 需求優化 UI 結構。