makepad-2.0-app-structure

makepad-2.0-app-structure 技能概覽

這個技能能做什麼

makepad-2.0-app-structure 技能能幫你用正確的 Rust + Splash 結構來建立或調整 Makepad 2.0 應用，而不是靠猜測 boilerplate。當你需要可正常運作的 app shell、事件路由、hot reload 設定，或真的符合 Makepad 模式的 Rust 與 Splash 整合時，這個技能最有用。

適合誰使用

如果你正在建立新的 Makepad app、整理既有專案，或想搞清楚 App::run、app_main!、MatchEvent、ScriptVm 和 from_script_mod 的位置與作用，就該使用 makepad-2.0-app-structure 技能。它特別適合 Makepad 裡偏前端式的 UI 開發，尤其在 app 結構、腳本和執行階段動作比一般 Rust 建議更重要的情境。

它最擅長什麼

這個技能最強的是 app scaffolding、template 選擇，以及會阻礙導入的整合決策：Cargo 設定、最小可運作結構、hot reload/live reload，還有 Splash 腳本如何連到 Rust 邏輯。當你需要解讀 repo 的參考文件，而不是盲目複製 snippet 時，makepad-2.0-app-structure 技能也很有幫助。

如何使用 makepad-2.0-app-structure 技能

正確安裝與觸發

安裝方式：
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-app-structure

接著用一段明確描述目標、目前檔案與目標執行環境的提示詞來觸發 makepad-2.0-app-structure 技能。好的觸發內容會提到像是 makepad new project、Cargo.toml setup、--hot、wasm deploy，或是如果你的 app 需要音訊，也可以一併說明。

提交需求時要提供什麼

這個技能在你提供 app 類型、目前資料夾結構，以及你希望輸出結果是什麼時最有效：starter app、遷移計畫、UI shell，或 Rust/Splash 接線。如果你已經有程式碼，請附上相關的 Cargo.toml、app entry file，以及任何既有的 widget 或 script module 名稱，這樣技能才能依照實際結構來對應，而不是憑空生出一套。

先讀哪些檔案

先看 SKILL.md，再讀 references/app-boilerplate.md 取得最小可運作範本，接著看 references/rust-splash-integration.md 理解溝通模式。這兩份檔案會回答最常卡住安裝決策的實務問題：app 怎麼啟動、腳本放在哪裡，以及 UI callback 怎麼回到 Rust 業務邏輯。

能產出更好結果的工作流程

有效的 makepad-2.0-app-structure usage 工作流程是：1) 描述目標 app，2) 確認你要的是 Rust-only 邏輯、Splash 主導 UI，或兩者都要，3) 要求精確的檔案結構與啟動順序，4) 在要程式碼前先請對方給簡短實作計畫。比如說：我需要一個 Makepad 2.0 桌面計數器 app，支援 hot reload、單一視窗，以及 Rust action handler；請列出檔案結構與最小的 App::run 路徑。

makepad-2.0-app-structure 技能 FAQ

這只適用於 Makepad 2.0 嗎？

是。makepad-2.0-app-structure 技能是針對 Makepad 2.0 的 app 結構與 Rust 整合，不是一般 Rust UI framework。如果你沒有使用 Makepad 的 app lifecycle、script module 和 widget refs，那麼一般提示詞通常就已經夠用。

我需要是專家才能用嗎？

不用。只要你能清楚說明目標並提供部分檔案樹，這個技能對初學者也很友善。初學者常見的陷阱是只說「做一個 app」，卻沒有交代你要的是 template、migration，還是整合範例；當需求有清楚起點時，這個技能表現會更好。

什麼情況不該用它？

如果你只需要單獨的 Rust 語法協助、你的 app 根本沒有 Splash scripting，或你要的是與 Makepad 結構無關的設計建議，就不要用 makepad-2.0-app-structure。當你需要的其實是超出 app bootstrapping 與 UI-action wiring 的深層產品架構時，它也不是好選擇。

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

一般提示詞可能會給你看起來合理的 Makepad 程式碼，但這個技能是依照 repo 的實際結構、參考資料與整合模式來調整的。當你想讓 makepad-2.0-app-structure 指南減少對 template、事件處理和 module 註冊的猜測時，這一點特別重要。

如何改進 makepad-2.0-app-structure 技能

給這個技能正確的限制條件

要讓結果更快變好，最直接的方法就是明確說出哪些條件不能改：edition、目標平台、對 hot reload 的期待、既有 module 名稱，或你是否使用 App::run 搭配 ScriptVm。限制條件越精準，makepad-2.0-app-structure skill 回傳看起來合理、但其實不適合你專案的結構機率就越低。

提供更強的起始素材

不要只說「幫我做一個 Makepad app」，請直接提供目前的 Cargo.toml、src/ entry file，以及一個具代表性的 UI module 或 action handler。如果你是在做 migration，也要說清楚哪些已經正常、哪些壞掉了，例如：「視窗可以顯示，但 handle_actions 從來收不到按鈕點擊。」

留意常見失敗模式

最常見的失敗，是把 Rust 端邏輯與 Splash 端 UI 職責混在一起，最後寫出來的程式不是很難編譯，就是很難延伸。另一個失敗是沒有說清楚 app 應該是最小化、multi-module，還是要對 hot reload 友善，這會導致走到錯的 template 路徑。

先從小而可運作的切片開始

先請技能給你最小可開機的結構，等 base app 穩定後，再逐步加上 multi-module composition、腳本 callback，或音訊／媒體整合。對 makepad-2.0-app-structure usage 來說，這種分段式做法通常比一次要求完整最終 app，更容易產生乾淨的結果。