makepad-2.0-performance
作者 ZhangHanDongmakepad-2.0-performance 是一份聚焦於 Makepad 2.0 效能與除錯的實用指南。它可協助診斷 draw batching、render triggers、GC 行為、隱形文字、UI 凍結與捲動卡頓等問題。當你需要與真實渲染問題直接相關的 makepad-2.0-performance 使用方式、安裝與疑難排解步驟時，這份內容特別適合參考。
這個技能的評分是 78/100，表示它很適合作為處理 Makepad 2.0 效能與除錯工作的目錄候選。對於需要實用、值得安裝的工作流程指南的使用者來說，它大致能派上用場，但仍有幾點需要留意：內容可操作且具體，不過若能補強快速上手結構與支援中繼資料，會更完整。
- 觸發性強：frontmatter 明確指出可用於 Makepad 效能、除錯、profiling、GC、batching，以及 UI 凍結、捲動卡頓等相關症狀。
- 操作深度不錯：正文涵蓋 draw batching、garbage collection 與 render triggers 等 Makepad 核心子系統，讓 agents 有具體可下手的方向，而不是籠統建議。
- 工作流程內容充實：這個技能有較長的正文、多個標題、code fences，以及獨立的參考指南，顯示它不只是佔位或 demo 等級的簡略內容。
- 安裝決策的把握度受限於封裝資訊偏少：沒有 install command，而支援檔案除一個 reference file 外也很精簡。
- description 非常簡短，而且 repository 仍有 placeholder markers，因此使用者可能需要仔細閱讀後，才能放心拿它處理邊緣情境的除錯。
makepad-2.0-performance 技能總覽
這個技能是做什麼的
makepad-2.0-performance 技能是一份聚焦的指南，用來診斷並改善 Makepad 2.0 的渲染、批次處理、GC 與除錯問題。當你需要理解為什麼 UI 變慢、為什麼文字或視圖消失，或為什麼在一次渲染變更後版面行為不一樣時，它特別有用。這不是一般性的 Makepad 教學；它是為效能工作而設計的，而 makepad-2.0-performance 之所以重要，是因為這類 bug 通常和批次順序、render 觸發，或 VM 記憶體行為有關。
適合哪些人使用
如果你已經在用 Makepad 開發，並且需要一條從現象追到根因的實作路徑，就該使用 makepad-2.0-performance skill。它適合能明確描述具體失敗情況的開發者，例如捲動卡頓、標籤不可見，或異常重繪，並且想要的是一份能幫你除錯、而不是讓你猜測的指南。
主要差異
這個技能的價值在於它的範圍很窄：它聚焦在 new_batch: true、draw batching 規則、render invalidation，以及 Splash VM 裡的 GC 行為。當一般的提示式建議無法點出真正原因時，這些往往就是最容易卡住 Makepad 應用導入的關鍵區域。
如何使用 makepad-2.0-performance 技能
安裝並啟用它
若要進行 makepad-2.0-performance install，先透過倉庫的 skill manager 流程把這個技能加入你的工作區，接著以 skills/makepad-2.0-performance/SKILL.md 作為主要入口。只有在效能或除錯任務真的有呼叫到這個技能時，安裝才有意義，所以你的提示詞一定要清楚寫出症狀與 Makepad 的情境。
先從正確的檔案開始
先讀 SKILL.md，再讀 references/optimization-guide.md。這兩個檔案會先提供你需要的工作模型，再讓你套用這個技能。如果你想用最短路徑快速理解，先看 batching 區段，以及 new_batch: true 周邊的註解，因為那通常是修正順序錯誤最有影響力的手段之一。
把模糊需求改寫成可用提示
makepad-2.0-performance usage 這種模式，最有效的做法是把以下內容講清楚：
- 可見問題：
text disappears、UI freezes、scroll stuttering，或render tree混淆 - 觸發點：
draw batching、mod.gc、debug logging，或on_render - 情境：問題發生在清單、重疊視圖，或重繪很多的畫面中
更好的提示詞像是：「除錯一個 Makepad 2.0 畫面：只有在同層視圖重疊時文字才會消失；請檢查 batching 順序，以及是否需要 new_batch: true。」這比「Makepad UI bug」好得多，因為它提供了具體失敗模式和可能機制。
讓輸出更好的實務流程
把這個技能當成診斷流程來用：
- 描述症狀以及發生位置
- 判斷問題屬於視覺、重繪，還是記憶體相關
- 先問最可能的子系統，不要一開始就要求整個重寫
- 用實際 widget tree 驗證建議的修正
如果是效能問題，請附上會重複、捲動或頻繁重建的那段 tree。如果是除錯問題，請附上能重現問題的最小程式路徑。這能幫助技能區分 batching 問題、GC 暫停，或錯誤的 render 觸發。
makepad-2.0-performance 技能 FAQ
這個技能只適合效能工作嗎？
不是。makepad-2.0-performance skill 也很適合處理那些看起來像效能問題、其實是 draw 順序或 render 觸發造成的症狀。當一般的提示協助無法把症狀對應到 Makepad 的 batching 模型時，它尤其有用。
什麼情況下不該用它？
不要拿它來處理一般 Rust 問題、無關的 UI 框架，或與渲染行為、GC、除錯診斷無關的廣泛 Makepad 功能需求。如果你只是想快速回想語法，這個技能的專精程度就太高了。
這個技能對初學者友善嗎？
可以，只要你能描述哪裡壞掉。你不需要很深的 renderer 知識，也能從 makepad-2.0-performance guide 受益，但你需要提供足夠的背景，像是失敗的畫面、重複出現的 widget 模式，或導致退化的觸發條件。
它和一般提示有什麼不同？
一般提示常常只要求修正問題，卻沒有點出子系統。這個技能的設計，就是先把調查方向導向 batching、記憶體與 render 生命週期問題，通常因此能得到更準確的根因，也能少走很多冤枉路。
如何改進 makepad-2.0-performance 技能
提供症狀，不要只講目標
最好的結果來自具體的失敗描述：是哪個 widget 消失、什麼動作觸發卡住，以及問題是否只在捲動、滑鼠懸停，或重建之後才出現。對 makepad-2.0-performance for Debugging 來說，症狀往往比程式碼風格更重要。
把會影響 batching 的結構一起提供
Batching 問題取決於同層順序、共用 shader、背景是否重疊，以及某個子樹是否需要自己的 batch。若你想得到更好的協助，請展示問題周邊的 widget 階層，而不只是你懷疑有問題的單一元件。
告訴技能哪些地方有改動
如果 bug 是在重構之後才出現，請說明你改了什麼：新增容器、移動標籤、變更 shader，或調整 render invalidation。這樣比較容易把真實退化和 Makepad pipeline 原本就存在的限制分開。
用有針對性的 repro 反覆縮小範圍
如果第一次的答案太籠統，就把案例縮成一個畫面和一個失敗互動。接著重新跑一次 makepad-2.0-performance usage 流程，並補上 logs、最小 tree，或精確的重疊模式。你的 repro 越精準，這個技能就越能快速縮小修正範圍。