現場示範指南
讓觀眾親眼看見真實產品發生改變。
好的 oh-my-design 示範不是逐一介紹技能名稱。它從一個看得見的問題開始，保護產品原本依賴的行為，最後回到真實路由，並留下任何人都能檢查的依據。
選擇足以證明成果的最小規模
時間限制的是範圍，不是誠實程度。開始前先選定一種形式，也清楚說明哪些內容不會更動。
搶救一個明顯問題
既有頁面能用，卻顯得普通或難以理解
保留原有行為，只修正一個影響最大的層級、間距、狀態或無障礙問題。
修改前畫面、聚焦的差異，以及同一真實路由上的修改後結果。
交付一個完整的小介面
專案已有技術堆疊、元件與範圍清楚的流程
根據專案的設計脈絡，實作一個小介面以及載入、空白、錯誤與成功狀態。
可操作的路由、狀態覆蓋、變更檔案與確實執行的檢查。
執行含檢查點的完整流程
介面全新或定義模糊，需要研究與設計系統決策
不略過核准關卡，從探索、使用者旅程、DESIGN.md 提案一路走到實作與驗證。
使用者旅程、DESIGN.md 修補內容、可操作 UI、驗證摘要與三次使用者檢查點。
可重複使用的六步驟流程
不論是社群聚會、工作坊或螢幕錄影，都能使用同一套順序。CLI 負責準備環境，實際的 UI 工作由 AI 程式助理在程式碼儲存庫內完成。
- 01
選定一個明顯問題與一項受保護行為
打開真實路由，精準指出觀眾應該注意的地方。接著說明 URL、資料流程、欄位名稱、文案或互動中，哪些內容絕對不能更動。
- 02
安裝套件，再讓 doctor 檢查實際狀態
在專案根目錄執行兩個指令，安裝後重新啟動 AI 程式助理。安裝成功只是準備工作，不是示範成果。
npx oh-my-design-cli@latest npx oh-my-design-cli@latest doctor - 03
對齊 DESIGN.md 與 verified_v2 依據
公開示範請選擇 verified_v2 參考。請代理和既有 DESIGN.md 一起讀取，只採用屬於目前產品介面的證據；無法確認的字型、token 與元件仍保持空缺。
- 04
實作真實介面與關鍵狀態
沿用現有技術堆疊與元件。若是新流程，不要只打磨靜態成功畫面，也要涵蓋使用者實際可能遇到的狀態。
- 05
在實際產品頁面檢查
開啟產品頁面，實際操作受保護的行為，再執行相關的無障礙與 interface-feel 檢查。只回報確實跑過的檢查與量測。
- 06
記錄使用者的修正
當使用者修正某個視覺決定時，只調整對應範圍，並用 omd:remember 留下紀錄，避免下個工作階段重犯。
現場搶救可直接使用的提示詞
先讀取 DESIGN.md，並檢查目前的產品路由。在保留 URL、資料流程、欄位名稱與既有使用者行為的前提下，改善這個頁面上一個看得見的層級或狀態問題。公開示範請使用 verified_v2 參考，並只對齊屬於該產品介面的證據；未知數值不要用替代值補上，直接省略。把變更實作在真實介面並涵蓋關鍵狀態，接著驗證該路由，回報變更檔案與確實執行的檢查。擴充 DESIGN.md 或跨過必要的 harness 檢查點前，先取得我的確認。觀眾應該能當場檢查的證據
示範進行時同步保留這些紀錄。只有漂亮截圖、卻沒有可追溯過程，觀眾就無法確認實際做了哪些工作。
原始畫面與一開始指出的明顯問題
包含受保護行為的完整提示詞
DESIGN.md 差異與刻意省略的未知欄位
包含關鍵狀態的真實產品路由，而非獨立 mockup
變更檔案與確實執行的檢查或量測
以持久且範圍明確的偏好記錄下來的使用者修正
讓驚豔感建立在事實上
CLI 負責安裝與診斷
AI 程式助理會讀取已安裝的脈絡並修改 UI；安裝器本身不會產生整個介面。
未知資訊仍保持空缺
不要用系統字型、通用元件、推測 token 或相鄰的行銷頁面補上缺少的品牌事實。
證據優先於表演
沒有真實的前後量測，就不宣稱速度、轉換率、無障礙或效能獲得提升。
必要檢查點不能略過
30 分鐘流程仍會在使用者旅程、DESIGN.md 修補內容與驗證核准處暫停。現場有觀眾不是略過它們的理由。