makepad-2.0-dsl

makepad-2.0-dsl 技能概覽

makepad-2.0-dsl 是一個專注於 Makepad 2.0 DSL 的技能，特別適合你要撰寫、閱讀或修正 script_mod! UI 程式碼，並避免掉進 1.x 語法習慣裡。它最適合前端開發者、Rust UI 作者，以及需要一份實用 makepad-2.0-dsl 指南來處理屬性指派、命名 widget、合併行為與 Rust 綁定模式的代理。

這個技能能幫你做什麼

它的主要工作，是把粗略的 UI 意圖轉成可用的 Makepad 2.0 DSL：選擇 : 而不是 =、在命名實例上使用 :=，以及正確套用合併語法。這很重要，因為很多失敗都出在語法層面，而不是設計層面；一般的提示詞協助常常抓不到 Makepad 真正要求的運算子。

為什麼值得安裝

當輸出的正確性取決於細小 DSL 規則時，makepad-2.0-dsl 最有價值：兄弟項之間不能加逗號、dot-path 覆寫、let 綁定，以及會影響版面或繪製的屬性分類。如果你需要可預期的程式碼生成，或需要 Makepad 2.0 的程式碼審查支援，這個技能能減少反覆試錯。

最適合的使用情境

當你在做 Makepad 應用、把舊的 live_design! 範例轉成新語法，或檢查 widget tree 在執行時是否會正確運作時，就很適合用它。如果你只想要一個通用的 UI 提示詞，不需要精準的 Makepad 語法，那它的幫助就比較有限。

如何使用 makepad-2.0-dsl 技能

正確安裝並觸發它

使用以下指令安裝：

npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-dsl

當你的需求明確提到 Makepad 2.0 DSL、script_mod!、屬性系統問題，或命名 widget 問題時，就該觸發 makepad-2.0-dsl 技能。如果你是要讓代理幫忙，最好直接說出目標與失敗模式：「把這段舊版 Makepad 範例轉成 2.0 DSL」就比「幫我整理一下」更有效。

提供 DSL 真的用得上的輸入

高品質輸入會描述 widget 結構、版面意圖，以及哪些部分必須能從 Rust 存取。例如，請明確指出子項是否需要 id、父層是否是 Fit，以及哪些屬性應該繼承、哪些應該被覆寫。差的提示詞只會說「讓它更好看」；更好的提示詞會說：「做一個雙欄面板，右側有命名的送出按鈕、固定的標頭高度，並繼承背景樣式。」

先閱讀這些檔案

先從 SKILL.md 開始，再查看 references/dsl-syntax-reference.md 和 references/property-system.md。這兩份參考資料涵蓋最容易卡住採用流程的規則：語法形式、合併語義、版面預設值，以及 height: Fit 這個陷阱，它可能會讓巢狀容器看起來像消失了一樣。

產出品質更好的工作流程

用一個簡短循環：先描述 widget 目標，請求一份 Makepad 2.0 DSL 草稿，再在套用前對照語法參考檢查結果。使用 makepad-2.0-dsl 時，要特別注意回答是否把 width、height、flow 與 draw_* 放在正確的屬性分類裡，因為放錯位置通常代表版面或樣式會壞掉。

makepad-2.0-dsl 技能 FAQ

這只適用於 Makepad 2.0 專案嗎？

是。這個 makepad-2.0-dsl 技能是針對 2.0 DSL 與 script_mod! 工作流程設計的，不是舊的 live_design! 巨集風格。如果你的程式碼庫還在 1.x 慣例上，它比較適合當作遷移輔助，而不是直接可替換的方案。

它比一般提示詞更好嗎？

通常是，因為這裡的價值在於語法精準度，而不是創意。一般提示詞可以描述 UI，但 makepad-2.0-dsl 更有機會保住 Makepad 真正會強制執行的冒號語法、命名實例與合併規則。

初學者也能用嗎？

可以，只要他們有具體的目標 widget 或版面。初學者通常在提供粗略草圖、預期的子項名稱，以及是否需要透過 id! 或 ids! 從 Rust 存取元素時，最容易得到好結果。

什麼情況下不該用它？

如果你不是在寫 Makepad UI 程式碼，或者你只需要廣泛的前端建議、沒有 DSL 限制，就不適合用它。當需求太模糊，無法對應到 widget tree、屬性集合或綁定模式時，它也不太合適。

如何改進 makepad-2.0-dsl 技能

先提供最重要的限制條件

最大的品質提升，來自一開始就把版面與所有權細節講清楚：父層尺寸行為、命名子項，以及模板應該合併還是替換。對 makepad-2.0-dsl for Frontend Development 來說，這些限制往往比視覺風格偏好更重要。

避開常見失敗模式

最常見的錯誤包括使用 =、忘了兄弟屬性之間是用空白分隔，以及在 Fit 裡放入容器卻沒有設 height: Fit。另一個常見問題是要求命名 widget，卻忘了 := 會改變實例的儲存與存取方式。

依照你需要的輸出形式來要求

如果你要可重用的程式碼，就直接說明，並要求 let 為基礎的模板或已註冊 widget 的範例。如果你要的是直接補丁，就只要求變動過的區塊，並標明確切的屬性路徑，例如 draw_bg.color 或 title.text，這樣回覆會更容易直接套用。

一次只測一條規則，逐步迭代

當第一次輸出已經接近，但還是不對時，用最小的變更去修正提示詞：調整一條版面規則、一個綁定目標，或一條合併路徑。這樣能讓 makepad-2.0-dsl 指南始終聚焦在真正失敗的地方，通常比整個 UI 重新生成更快。