Communitygithub.com

UI Roast

以有趣但具體且誠實的方式,從四個面向(UI、UX 流程與狀態、動態感、風格)評論 UI/UX(螢幕截圖、螢幕錄影描述、元件程式碼或執行中的應用程式),並將每個評論轉換成可立即使用的修復提示。

UI Roast 是什麼?

UI Roast 是一個針對開發者與 AI 代理(如 Claude Code、Cursor、Codex)設計的技能,用於深入評論視覺或互動介面設計。它接受多種輸入形式:螢幕截圖路徑、貼上的影像、元件或畫面程式碼、動態描述,甚至是執行中的應用程式。 評論過程涵蓋四大透鏡:UI(層級、間距、排版、色彩)、UX(觸控目標、反饋狀態、流程、可及性)、動態感(動畫曲線、手勢、滾動)與風格(視覺語言一致性)。輸出採用結構化格式,包含一句話評判、一項優點、最多五個依影響力排序的評論(每個包含嚴重程度標籤、問題原理說明與修復提示),以及一個整合頂層問題的合併修復提示。 此技能適用於任何需要設計意見回饋的開發工作流程,可與設計提示改寫器搭配使用,以精煉單一修復提示。能與程式碼庫、設計代號及專案特定規則整合(透過 CLAUDE.md 或 AGENTS.md),確保評論符合現有設計系統。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/ui-roast

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

UI Roast 是做什麼的?

輸入:視覺或互動內容。可以是螢幕截圖路徑、貼上的圖片、元件或畫面檔案、描述其動態變化的文字,或是使用者指向的執行中應用程式。 輸出:一篇簡短的評論,按照嚴重程度排序,其中的每個笑話都對應一個真實發現,且每個發現都以一個修復提示結尾,使用者可將其貼入編程會話中。

修復提示遵循 design-prompt-rewriter 的風格:平實、具體、使用設計詞彙,每個提示為一個簡短段落。詞彙來源:references/keywords.md。

流程

  1. 先看。 圖片:讀取它。程式碼:讀取畫面檔案及其樣式/動畫程式碼。執行中的應用程式:使用執行技能或使用者的螢幕截圖。如果有真實內容,不要只根據描述來評論。
  2. 掃描下方的清單。 只報告你實際上看到或讀到的內容。切勿為了湊數而憑空捏造問題。
  3. 依照使用者影響程度排序,而不是根據笑話的好笑程度。上限為 5 則評論。如果還有更多,將它們保留在結尾的一行「也發現」清單中。
  4. 以下列格式撰寫每個評論。
  5. 結尾提供一個合併提示,同時修復最嚴重的問題,以便使用者可以貼上單一區塊。

除非使用者在評論後要求,否則不要編輯檔案或撰寫程式碼。

檢查清單(涵蓋每個透鏡:UI、UX、動態感、風格)

透鏡對應,用於標記每個評論:UI = 1 至 4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · 動態感 = 7, 8 · 風格 = 14。

  1. 層級: 能在 2 秒鐘內知道這個畫面是做什麼的以及該先點哪裡嗎?有一個明確的主要操作?
  2. 間距與對齊: 一致的 4/8pt 網格、對齊的邊緣、足夠的留白、沒有擁擠或懸空的元素。
  3. 排版: 字級或字重過多、文字過小、行長不佳、內容被截斷、沒有為動態字級縮放。
  4. 色彩與對比: 文字對比度 4.5:1、僅用顏色傳達意義、使用未經設計的原始顏色而非設計代號、深色模式。
  5. 觸控目標與可發現性: 最小 44pt / 48dp、按鈕看起來像按鈕、有按壓狀態。
  6. 反饋與狀態: 載入(骨架屏 vs 空白)、空狀態、含重試機制的錯誤狀態、成功狀態、禁用狀態、離線狀態。
  7. 動態(如果可見或存在於程式碼中): 線性緩動、持續時間低於 150ms 或超過 500ms、沒有交錯動畫、沒有中斷能力、手勢後缺少慣性、佈局位移、對寬度/高度進行動畫而非 transform/opacity、狀態變化時閃爍。
  8. 手勢與滾動: 衝突的手勢、沒有慣性、沒有橡皮筋效果、缺少下拉刷新或滑動返回、滾動劫持、鍵盤遮擋輸入框。
  9. 一致性: 相同的東西用了兩種樣式、圖示風格混用、圓角半徑或陰影不一致。
  10. 文案與微文案: 含糊的按鈕(「提交」)、專業術語、責備使用者的錯誤訊息。
  11. 可及性: 標籤、焦點順序、減少動畫的備用方案、螢幕閱讀器角色。
  12. 在地化 / 從右至左(RTL): 鏡像佈局、滑入和滑出方向、應翻轉的圖示、阿拉伯文和英文混合對齊。
  13. 流程與資訊架構: 完成任務需要多少步驟、下一步是否明顯、標籤和選單群組是否如使用者預期、死胡同、返回路徑、單一畫面選項過多(希克定律)、阻礙而非引導的引導流程。需要兩個或更多畫面,或描述的使用者旅程。若只有一個畫面,則僅評斷其隱含的內容(入口點、出口、進度提示)。
  14. 風格與視覺語言: 整體視覺是否自成一個系統(圓角、陰影、模糊、漸層、插圖和圖示風格、圖片品質)、是否符合產品及其信任層級(健康或支付應用程式應感覺平靜可信,而非嘈雜)、效果是在發揮作用還是僅僅裝飾(玻璃、發光、漸層)、是否看起來過時或像預設模板。
  15. 平台慣例與響應性: 返回手勢和導航符合平台規範(iOS HIG、Material Design)、底部表單、標籤欄和對話框的行為符合使用者預期、安全區域和瀏海頭受到尊重、深色模式正常運作、佈局能適應小螢幕手機、大字型、平板、橫向模式或相關的網頁斷點。

專案上下文:如果工作目錄中有 CLAUDE.md 或 AGENTS.md 包含 UI 規則(來自共享主題的顏色、RTL 的 useRFLayout、底部表單元件、無限滾動的 5 種狀態),也要根據這些規則進行檢查並引用它們。

動態檢查(用於動態感透鏡)

靜態圖片本身沒有時間概念。要判斷懸浮、轉場和緩動效果,請取得以下其中一項,依優先級排序:

  1. 程式碼。 讀取轉場或動畫程式碼:CSS transition / @keyframes、Framer Motion、Reanimated(withTiming、withSpring、withDecay)、Animated。檢查持續時間、緩動函數、動畫的屬性(transform 和 opacity 與 width、height、top 相比)、交錯動畫、中斷能力、減少動畫的備用方案。
  2. 執行中的網頁應用程式。 使用可用的瀏覽器工具(內建瀏覽器或 Claude 在 Chrome 中)。懸浮或點擊元素,並在之前、期間(觸發後立即)和之後截取螢幕截圖。使用 JS 讀取實際值:getComputedStyle(el).transition 和 el.getAnimations()。檢查懸浮、焦點、按壓和禁用狀態,而不僅僅是預設狀態。
  3. 螢幕錄影轉為影格。 將影片作為圖片讀取;檔案讀取器無法播放影片。
    • 檢查 which ffmpeg。裁剪到關鍵時刻,然後將影格取樣到一個新的空白資料夾中:ffmpeg -ss <start> -t <seconds> -i <video> -vf "fps=20,scale=480:-1" <outdir>/%03d.png。對於 200 到 300ms 的轉場使用 fps 20 到 30,對於慢動作場景使用 10。
    • 要獲得概覽,製作一個聯繫表:ffmpeg -i <video> -vf "fps=10,scale=240:-1,tile=6x4" <outdir>/sheet.png,然後讀取變化前後的影格。
    • 使用 adb shell screenrecord --time-limit 8 /sdcard/m.mp4 然後 adb pull 錄製 Android。使用 xcrun simctl io booted recordVideo m.mov 錄製 iOS 模擬器。先檢查 which adb;它可能位於 Android SDK 的 platform-tools 下。
  4. 使用者的描述。 最後的手段。詢問他們在動畫的開始、中間和結束時看到了什麼。

影格可以告訴我們什麼:一個狀態或反饋存在與否、事件的順序、大致持續時間(影格數量乘以影格間隔)、佈局位移、內容消失的影格(閃爍)、過衝、高亮是移動還是跳轉。 影格無法告訴我們什麼:精確的緩動曲線、卡頓、彈簧感覺。請如實說明,並指出這些需要查看程式碼。

證據標籤:每個「動態感」評論的「為什麼」結尾需標註來源:(來自程式碼)、(來自影格,約 50ms 解析度) 或 (來自計算後樣式)。對於從影格讀取的任何持續時間,都應使用「約」字。切勿將猜測的數字當作測量值呈現。

如果 1 到 4 項都不可用,請在「透鏡」行中標記 動態感 –,並要求提供其中一項。

評論規則

  • 評論設計,絕不對人。 不開關於作者、團隊或用戶品味的玩笑。目標是畫面本身。
  • 每個笑話都承載一個發現。 如果你說不出問題是什麼以及為什麼,就刪掉這個笑話。
  • 一行好笑,下一行認真。 先寫評論行(最多約 20 字),然後是附帶原則名稱的平實理由。
  • 要具體。 指向元素(例如「價格下方 11px 的灰色說明文字」),而不是「排版」。
  • 誠實,而非殘酷。 如果有好的地方,請在頂部用一行說明。不要憑空讚美。
  • 不要偽造嚴重程度。 每個問題標記為:阻擋(使用者失敗或受傷)、惱人(使用者掙扎)、打磨(使用者能感覺到但影響較小)。
  • 平衡各個透鏡。 不要用 UI 的小毛病填滿所有 5 個位置。如果存在流程或風格問題,它會與其他問題競爭影響力。對於你無法判斷的透鏡,要明確說明,而不是默默跳過。
  • 風格是主觀的,所以要從產品角度論證。 將每個風格評論與產品的目標受眾、信任層級或應用程式內部的不一致之處聯繫起來。永遠不要說「我不喜歡漸層」。
  • 撰寫修復提示時記住使用者的技術棧(React Native、網頁、SwiftUI)。如果已知,請使用其術語;否則使用中立術語。
  • 語氣: 冷靜、快速、不尖銳。不使用髒話,不使用需要解釋的迷因。

輸出格式

評判:<一行,有趣,誠實>
優點:<一行,真實的優勢>
透鏡:UI ✓ · UX ✓ · 動態感 ✓ · 風格 ✓   (對於任何無法判斷的透鏡,標記 – 並簡短說明原因,例如「動態感 – 靜態圖片」)

1. [阻擋|惱人|打磨] [UI|UX|動態感|風格] <評論行>
   為什麼:<問題是什麼、原則名稱、一句話>
   修復提示:「<1 到 3 句話,使用設計詞彙,可立即貼上>」

2. ...

也發現:<逗號分隔清單,僅當超過 5 個時>

合併修復提示:
「<一個段落,按照使用者體驗的順序合併頂層修復:先看、觸摸、釋放、靜止>」

下一步:<一個可以在 2 分鐘內完成的事情,例如「將合併提示貼入一個新的會話」>

範例

輸入:預訂頁面的截圖。灰色的「確認」按鈕、大尺寸庫存照片橫幅下的 12px 灰色文字、載入時空白頁面上的轉圈圈、底部工作表瞬間彈出。

輸出:

評判:一個竭盡全力藏匿你進來要做的那件事的預訂頁面。
優點:課程卡片之間的間距一致且透氣。
透鏡:UI ✓ · UX ✓ · 動態感 ✓(來自程式碼) · 風格 ✓ — 流程未評斷,僅一個畫面

1. [阻擋] [UI] 「確認」按鈕打扮得像個禁用按鈕,非常努力地想要不被注意到。
   為什麼:視覺層級薄弱且無可發現性。灰色疊灰色無法滿足對比度要求,且主要操作看起來不可點擊。
   修復提示:「將『確認』設為單一主要操作:使用共享主題中的品牌色填充,白色標籤,對比度至少 4.5:1,固定在底部,目標大小 48dp。添加按壓狀態(縮放至約 0.96,100ms ease-out)和輕微觸覺回饋。僅在請求進行時使用清晰的樣式將其禁用。」

2. [惱人] [UX] 空白頁面上孤獨的轉圈圈,就像在空無一人的機場等待。
   為什麼:沒有骨架屏,所以資料到達時佈局會位移(佈局位移),且感知效能受損。
   修復提示:「將轉圈圈替換為帶有 shimmer 效果的骨架行,尺寸與最終卡片匹配,這樣就不會發生位移。每個骨架屏以約 50ms 的交錯時間淡出為其對應的卡片。」

3. [惱人] [動態感] 底部工作表像是有更好的地方要去似的瞬間傳送出來。
   為什麼:即時掛載無轉場,且無法拖動關閉,感覺廉價且與觸摸無關聯。
   修復提示:「使用彈簧動畫(無過衝)從底部向上滑出工作表,持續約 300ms,同時淡入遮罩。允許使用者向下拖動關閉,並根據鬆開時的速率提供慣性,頂部有橡皮筋效果。退出時使用更快的 ease-in 動畫。」

4. [打磨] [風格] 橫幅是一張陌生人的微笑庫存照片,而這是一個預約醫生的頁面。
   為什麼:通用圖像削弱了健康產品的信任度,並與頁面上其他地方使用的平靜扁平圖示風格衝突(視覺語言不一致)。
   修復提示:「將庫存照片替換為應用程式自身的插圖風格,或使用平靜的純色色塊,搭配與卡片相同的圓角半徑,使頁首與圖示集風格匹配,顯得可信而非千篇一律。」

5. [打磨] [UI] 橫幅下 12px 的灰色說明文字在低聲細語地說著價格。
   為什麼:文字過小且對比度低,未為動態字級縮放,價格是關鍵資訊但層級最低。
   修復提示:「將價格提升為粗體大號樣式,放在標題旁邊;將說明文字至少維持在 14px,對比度 4.5:1,並讓兩者都跟隨系統字型大小縮放。」

合併修復提示:
「首次載入時,顯示與最終佈局尺寸匹配的帶有 shimmer 效果的骨架卡片,然後以約 50ms 的交錯時間淡出為內容,且無佈局位移。將庫存照片替換為應用程式自身的插圖風格或使用卡片圓角半徑的平靜色塊。使價格變為粗體且突出,說明文字至少 14px,對比度 4.5:1。將『確認』設為填充的主要操作,固定在底部,目標大小 48dp,按壓時縮放至 0.96 並帶輕微觸覺回饋。底部工作表以約 300ms 的彈簧動畫向上彈出,同時淡入遮罩,可向下拖動關閉並帶有釋放速率慣性和橡皮筋效果,退出時使用更快的 ease-in 動畫。」

下一步:將合併提示貼入一個新的會話,或在任何單一修復提示上執行 `/design-prompt-rewriter` 以進行調整。

當輸入資訊不足時

  • 只有模糊的描述(「我的應用程式感覺很糟」)?要求一樣東西:螢幕截圖或畫面檔案路徑。不要盲目評論。
  • 無法從靜態圖片判斷動態。用一行說明,然後要求提供動畫程式碼、螢幕錄影或執行中的應用程式(請參閱動態檢查),然後評論你能看到的內容。
  • 只有一個畫面:判斷 UI、UX 狀態、動態感(如果存在程式碼或錄影)和風格。將流程標記為未評斷,並提議如果使用者分享下一個畫面或描述步驟,可以審查使用者旅程。
  • 多個畫面:先進行流程分析(步驟、標籤、死胡同、返回路徑),然後評論最糟糕的畫面,並說明你選擇了哪一個。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能