Communitygithub.com

介面質感

用於審計並修復應用程式或網站的使用者介面(UI)質感,包含動畫、轉場、互動品質,以及應用 UX 法則、動畫原理和 UI 技巧,以提升一致且流暢的互動體驗。

介面質感 是什麼?

這個技能的核心是對應用程式的「質感」(feel)進行系統性審計與修復。它基於一份包含 40 個檢查項目的清單(涵蓋 12 個動畫原理、8 個 UX 法則與 20 個 UI 技巧)和一套運動系統。首先,透過程式碼普查(census)與頁面探測(probe)進行審計,不修改任何東西,而是產出報告,指出每個項目是「存在」(there)、「遺漏」(missing)、「錯誤」(wrong)或「跳過」(skip)。接著,根據報告進行修復:優先處理信任相關項目,然後依照標準修復改變行為但不改變外觀的項目(如點擊區域、安全三角形),最後只實作那些經由負責人挑選、會改變視覺外觀的項目。這個技能特別適合需要提升使用者體驗一致性與效能(LCP、INP)的 Web 或行動端專案,支援所有主流開發環境(如 Claude Code、Cursor 等代理工具),並強調尊重專案既有的設計系統與 motion tokens。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

介面質感 是做什麼的?

關於介面如何移動與回應的全面檢視。它會針對應用程式的當前狀態,逐一比對清單中的四十個項目(十二個動畫原理、八個 UX 法則、二十個 UI 技巧)與運動系統,撰寫一份報告,然後根據每個項目的修正模式來修復發現的問題。大多數應用程式已經擁有清單中的一半項目;審計報告會指出這點,而不是重複添加。速度、目標區域與信任感永遠適用;裝飾性元素在工作工具中應保持克制。

專案自身的設計系統、運動 token 與規則優先於此處的任何內容。效能預算(LCP、INP、套件大小)、無障礙性與文案是與此技能並行的獨立檢查。

此技能包含的檔案

檔案用途
reference.md40 個項目的詳細說明:如何檢查、修復模式、何時跳過、以及真實審計範例
motion.md運動系統:token、十二條規則、CSS 模式、如何審計動畫
audit/census.sh程式碼普查:計算每個項目對應的模式數量,並附帶檔案:行號的線索
audit/probe.js即時頁面探測:真實的點擊目標、持續時間、緩動函數、圖形、標題、代碼欄位、佔位符
report-template.md審計報告範本:每個項目一行結論、工作順序、未檢查的內容

第一階段:審計(不修改任何內容)

  1. 首先閱讀專案的設計系統、運動 token 與 UI 規則。
  2. 從專案根目錄執行普查:bash <此技能的路徑>/audit/census.sh . --show 5。它只會讀取已發布的原始碼(排除依賴項目、建置產物、複製的程式碼、測試、基準測試、產生的檔案與註解行;可使用 CENSUS_EXCLUDE="dir1,dir2" 加入更多排除項目)。安裝 ripgrep 以獲得快速執行;若沒有,腳本會回退使用 perl。計數僅代表需要檢查的線索,而非最終判定。
  3. 執行應用程式。在每個關鍵頁面上,於寬度 1440px 與 375px 下,以及在應用程式提供的每個主題中,執行 audit/probe.js(將其貼到主控台,或在瀏覽器工具的 JavaScript 執行器中 await 它)。它會一次一個畫面地捲動整個頁面,然後恢復位置。隱藏的分頁沒有寬度且不會繪製畫面:請先顯示它。判斷其輸出:標記為 spaced(與下一個控制項的間隙達到最小值)的目標嚴重性較低;圖形僅在數值變化時才需要 tabular-nums;將裝飾性的假視窗標記為 aria-hidden,或忽略其列。
  4. 手動檢查腳本無法看見的項目,使用真實的指標事件(瀏覽器工具的點擊,非合成的 .click()):快速按下每個付費或不可逆的操作兩次,並計算伺服器端的影響;將網路與寫入操作限速至 600 毫秒再按下;快速開啟與關閉每個圖層,並在關閉過程中重新開啟,取樣其不透明度(motion.md 中的「Measuring a reopen」);在關閉的選單內點擊;輸入帶有重音符和不同大小寫的查詢;沿對角線朝懸停子選單移動;在圖層開啟時按下 Android 返回鍵;滑動關閉手機的 sheet。
  5. 根據 report-template.md 撰寫報告:所有 40 行,每個項目標記為 存在、遺漏、錯誤 或 跳過,並附上理由、檔案:行號或數字的證據,以及標註為 建置 或 挑選。在修復前展示報告。

第二階段:根據檢查清單修復

  1. 信任優先:第 39 項以及任何可能導致雙重收費或資料遺失的項目,並在修復前撰寫一個會失敗的測試。
  2. 建置 項目:這些項目改變行為但不改變外觀(例如:點擊區域偷渡、安全三角形、返回手勢、強調色折疊、快捷鍵、命令面板條目、樂觀寫入、骨架屏、運動 token、可逆轉場)。根據 reference.md 和 motion.md 中的模式,透過專案自己的元件和 token 來修復每個項目,並為任何邏輯撰寫測試。
  3. 挑選 項目:這些項目改變外觀或產品(例如:圓角、模糊佔位符、替代確認對話框的復原提示、錯誤警示、新的動畫節拍、視角轉場)。每個項目需在兩種主題下以 1:1 比例進行前後對比評估,並編號且可分離;只建置被負責人挑選的項目。
  4. 絕不以移除既有裝飾來換取新的裝飾。

第三階段:驗證

重新執行普查與探測,並將結果與報告進行比較。以使用者的方式,在兩種主題下以及手機寬度下,單獨測試每個已修復的互動。將已建置、已測試、已通過視覺審查和已部署的項目作為獨立的事實報告,並說明哪些內容無法測量(例如:沒有實體手機、沒有正式建置版本)。

檢查清單

編號與 reference.md 及報告相符。

#項目失敗條件
A動畫原理 (motion.md)
1擠壓與拉伸著陸的徽章、圓點或旋鈕停止時毫無緩衝
2預備動作按下動作在一個影格內沒有狀態變化(縮放至約 0.97,持續約 100 毫秒)
3聚焦開啟的圖層未能讓主要事物保持清晰
4姿態到姿態忙碌的按鈕、標籤或圖示切換時,寬度或內容發生跳躍
5跟隨動作圖層的內容像是黏在容器上一同到達
6慢入慢出UI 動畫使用 linear 或預設的 ease;使用超過三種緩動函數
7弧線運動某個物體以直線方式移動很長距離
8次要動作一個完成的動作沒有確認性的第二個動畫節拍
9節奏明快UI 回應時間超過 300 毫秒;同一個表層的表現不一致;退出動畫不比進入動畫短
10誇張反饋無效的提交僅顯示微小的顫動,沒有顏色變化的節拍
11立體繪圖陰影與圖層在光線和深度上不一致
12吸引力以 1:1 比例逐步操作一個真實流程時,顯示出接縫
BUX 法則
13費茲定律桌面端真實目標小於 32px,或手機端小於 44px
14更大的點擊區域目標透過放大圖片來增大,或導致兄弟元素重疊
15希克定律一個選單區塊中超過五個項目
16米勒定律未分組的頂層項目超過約七個
17多赫提定律從按下到下次繪製超過 400 毫秒,且沒有其他東西先回應
18波斯特爾定律(寬容原則)查詢的重音符號、大小寫或間距變體找不到任何結果
19雅各布定律(慣例原則)模式行為與其平台不一致(例如:懸停子選單、返回鍵關閉圖層)
20使用頻率每日操作需要超過一個步驟或一個命令
C速度與反饋
21骨架載入器路由在點擊的影格上顯示空白或旋轉器
22樂觀更新一個便宜的、可逆的寫入操作在伺服器回應前未顯示任何內容
23命令面板某個目標可透過點擊到達,但無法透過打字搜尋
24快捷鍵提示有快捷鍵的控制項未在其工具提示中顯示
25復原提示可復原的刪除操作沒有提供復原選項(由負責人決定是否取代確認對話框)
26先顯示過期資料再驗證重新訪問的頁面在顯示最新資料前,未先顯示上一次的資料
27預渲染最可能前往的下一個頁面,在偵測到意圖時未被預先擷取(需在正式環境中判斷)
28模糊佔位符載入中的圖片顯示為灰色方塊
29視角轉場(View Transitions)從網格到詳細頁面的開啟動作沒有共享元素的變形
30滑動關閉手機上的 sheet 或抽屜無法透過滑動手勢關閉
31可中斷動畫在退出動畫播放期間重新開啟,動畫會從頭播放
D平台與細節
32預測性返回Android 返回鍵在圖層開啟時會離開頁面
33點擊區域偷渡小型圖示控制項沒有提供不可見的目標區域擴展
34安全區域內邊距底部浮動元素在 viewport-fit=cover 設定下,忽略了 env(safe-area-inset-*)
35一次性代碼自動填寫驗證碼輸入欄位缺少 autocomplete="one-time-code" 與 inputmode="numeric"
36表格數字變化中的數字會跳動(未使用 tabular-nums)
37平衡標題短的多行標題會產生孤兒字(未使用 text-wrap: balance)
38連續圓角未考慮使用 squircle 圓角(這是一個外觀決策:需要對比評估)
E信任
39冪等金鑰快速按下付費或不可逆的操作兩次,會對伺服器造成兩次影響
40安全三角形當滑鼠沿對角線移向懸停子選單時,它會關閉

常見錯誤

  • 添加已存在的內容:骨架屏、快取與運動 token 通常已經存在;結論應為存在。
  • 僅依賴客戶端去重作為安全機制:在重新渲染禁用按鈕前,兩次點擊已經送達。應在伺服器端進行防護(條件更新、確定性金鑰、鎖定),並在 ref 中記錄按壓狀態。
  • 放大圖片而非目標區域;僅在桌面端寬度檢查目標,而桌面端的規則卻覆蓋了手機端的最小目標尺寸。
  • 為開啟和關閉設定不同的關鍵影格:無法反轉。應使用狀態屬性的轉場效果,並將正在離開的圖層設為 inert。
  • 將復原、圓角或錯誤提示音視為純工程選擇。這些屬於負責人的產品決策。
  • 在開發伺服器或後台分頁上判斷預先擷取或時間設定。

相關技能