makepad-2.0-theme

makepad-2.0-theme 技能概覽

什麼是 makepad-2.0-theme

makepad-2.0-theme 技能可協助你以維持設計 token 一致性的方式，處理 Makepad 2.0 主題系統。當你需要套用 theme.* 變數、在深色與淺色主題之間切換，或理解 Makepad 的 theme globals 如何影響 widget 與整體 App 樣式時，它特別有用。

適合誰使用

如果你正在建置或維護 Makepad UI，尤其在意可擴充的產品樣式、內部工具，或 makepad-2.0-theme for Design Systems，就很適合使用 makepad-2.0-theme 技能。當硬寫色彩、間距或字型值會讓不同畫面之間產生樣式漂移時，它特別派得上用場。

它解決什麼問題

它的核心工作，是把模糊的視覺意圖轉成符合主題感知的實作。這個技能不會讓你憑空猜哪些值該寫進程式碼，而是幫你把像是「深色模式要更強的對比」或「緊湊面板需要更密集的間距」這類需求，對應到 Makepad 預期的主題變數。

為什麼值得安裝

makepad-2.0-theme 技能不只是一般的樣式提示詞：它聚焦在 Makepad 的主題載入順序、變數命名，以及語意化 theme 值與直接數值字面量之間的差異。當你需要讓輸出能和實際的 Makepad runtime 相容時，這能有效降低導入風險。

如何使用 makepad-2.0-theme 技能

正確安裝並觸發

執行 makepad-2.0-theme install 時，先依照 repo 的安裝指令把技能加入你的 skills 集合，並在你的需求提到主題變數、widget 樣式、主題切換，或 Makepad 的色彩／字型／間距決策時呼叫它。如果你的提示只寫「讓它更漂亮」，這個技能的指定會太模糊。

從正確的輸入開始

最好的結果通常來自包含以下資訊的提示：

• 你要的主題模式：dark、light 或 skeleton
• 你正在調整的畫面或元件
• 你想改動哪些 token：color、font、space、radius、contrast
• 變更是否必須保留既有 widget 行為

較弱的需求是「改善主題」。較強的需求則像是：「使用 makepad-2.0-theme 調整一個深色模式的精簡 inspector panel，保留排版不變，提高間距辨識度，並避免硬編碼值。」

先讀對的檔案

在實際使用 makepad-2.0-theme 時，先從 SKILL.md 開始，再打開 references/theme-variables.md。這份參考文件是最快理解可用 token、全域調整參數，以及哪些值應該以語意而非字面值呈現的方式。

遵循 theme 載入流程

這裡最關鍵的實作細節是順序：theme 定義必須在 widgets 參照之前載入。使用這個技能時，請特別注意 App::run 中的設定流程，然後把那個模式套到你的專案，而不是把值直接照貼進去。若漏掉這一步，最容易卡住導入。

makepad-2.0-theme 技能 FAQ

這只是深色模式樣式的提示詞嗎？

不是。makepad-2.0-theme 技能涵蓋的是更完整的 Makepad 2.0 theme 系統，包括 theme 變數、間距、排版、widget 狀態樣式與主題切換。深色模式只是其中一個常見使用情境。

我一定要先很懂 Makepad 嗎？

不一定。只要你能描述想改哪個 UI，這個技能就很容易上手。你不需要背熟每個 token，但至少要能說清楚元件、視覺目標，以及對硬編碼值的限制。

什麼情況下不該用它？

如果你不是在 Makepad 環境中工作、你的設計系統根本不使用 theme token，或你只需要一次性的視覺 mockup、沒有實作限制，那就不該用 makepad-2.0-theme。這些情況下，一般的樣式提示詞就夠了。

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

一般提示詞可能只是在提供視覺想法，但 makepad-2.0-theme 更適合處理依賴 Makepad 慣例的實作決策。當你需要的結果要符合 repo 的 theme 變數結構，而不是自己發明一套新的樣式規則時，它尤其有用。

如何改進 makepad-2.0-theme 技能

提供具體的視覺目標

想要讓 makepad-2.0-theme 的輸出更準，最快的方法就是把你要的實際取捨說清楚。可以直接講「提高資訊密集儀表板的文字對比」、「降低 skeleton 狀態的視覺噪音」，或「讓間距更緊湊，但不要把可讀性字級縮小」。這類限制比空泛形容詞更能有效引導 token 選擇。

補上現有的 theme 背景

如果你的專案已經在用 theme.* 變數，請貼一小段目前的用法，並指出問題出在哪裡。可以說是 token 選擇、載入順序、間距不一致，或深淺模式之間不匹配。這能幫技能產出修正方案，而不是整套重做。

留意常見失敗模式

最常見的錯誤包括：硬編碼數值、在 widgets 載入之後才設定 theme、以及只改局部顏色卻沒檢查語意 token 的級聯影響。如果第一次結果不太對，與其要求整體視覺重寫，不如請它做 token 層級修正。例如：「保留版面，但重新平衡 color_contrast，並稍微提高 space_factor。」

從輸出一路迭代到實作

第一次產出後，先在 app 裡實測，再用一個窄範圍的追問去修正。如果感覺太平，請它調整調色盤對比；如果看起來太擁擠，請它調整間距與 radius；如果主題切換失效，就把重點放在載入順序與目前的 mod.theme 選擇。這是在真實專案中使用 makepad-2.0-theme for Design Systems 最有效的方法。