21 Grams UX 是做什麼的?
對現有流程進行一次審視。21 Grams UX(21 Grams 系列的 UX 套件)不會重新設計產品,也不會新增 UI 套件。它會實際走訪流程,找出 AI 建構的產品在使用者端失效的地方(死路、缺失狀態、無聲失敗、不可復原的操作、與使用者對抗的表單),並透過專案既有的元件與模式來修復它們。
21 Grams UI 負責外觀。21 Grams UX 負責功能。當兩者都安裝時,請先執行 UX:修飾一個不該存在的步驟是沒有意義的。
規則零:使用專案既有的元件
所有修改都必須使用專案既有的東西。21 Grams UX 絕不建立平行元件或平行流程。
- 在動手之前先盤點。 記錄路由器和路由表、元件庫、表單庫與驗證方式、提示框、對話框與空狀態元件、資料擷取層(載入與錯誤狀態的來源),以及分析或事件層(如果有的話)。
- 在元件所在之處修復。 缺失的錯誤狀態應加入共用的資料或空狀態元件,而非某個畫面。確認模式應使用專案的對話框,而非一次性的。
- 如果有適合的元件,絕不新增元件或依賴項。 不要為了達到 21 Grams UX 的效果而引入新的表單庫、提示框庫或導覽庫。
- 當某個元件確實缺失時(沒有空狀態元件、沒有復原功能),應使用專案既有的原始元件來建構,並遵循其檔案佈局與命名方式。並在報告中說明。
- 產品決策保持不變。 21 Grams UX 不會改變產品的用途、目標對象或業務規則。它只會改變現有任務的執行方式。任何會改變範疇的內容都應以問題的形式放在報告中,而非作為修正。
優先級: 使用者的話語優先,其次是專案既有的模式與產品規則,最後才是 21 Grams UX 的內部規則。
內容
- UX 研究步驟。 在設計或重新設計流程之前,逐一分析現有產品與三到五個業界領先的範例,並在連線時使用像 Mobbin 這樣的模式庫。完整流程請參閱
references/research.md。 - UX 法則。 規則所依據的知識,收錄於
references/laws.md,按區段編號為 A1、A2……。A 區是核心法則:希克定律、費茲定律、雅各布定律、米勒定律、多赫蒂閾值、泰斯勒定律與普斯特爾定律。當沒有規則涵蓋某種情況時,請根據這些法則推理。 - UX 規則。 收錄於
references/rules.md中的編號規則,每條規則包含規則內容、應用方法以及需要標記的事項,並附有快速稽核查核清單。以行動端優先撰寫,並同樣應用於網頁(桌面版的主要導覽視為「底部分頁」,彈出視窗視為「底部工作表」)。 - 實戰規則。 從 AI 建構產品的實際審查會議以及對領先產品的 UX 研究中學到的規則,收錄於
references/field-rules.md,編號為 F1、F2……。此檔案會在每次審查會議後擴充(參閱「擴充實戰規則」)。 - 各領域的內部規則 收錄於
rules/目錄下,每個領域一個檔案,列出屬於該領域的法則、編號規則與實戰規則:
| 檔案 | 領域 |
|---|---|
navigation.md | 導覽與路徑尋訪 |
forms.md | 表單與輸入 |
states.md | 空、載入、錯誤與成功狀態 |
feedback.md | 回饋與系統狀態 |
onboarding.md | 引導與首次使用 |
destructive.md | 破壞性操作與復原 |
accessibility.md | 無障礙與鍵盤 |
flows.md | 流程與任務長度 |
choice.md | 選擇與認知負荷 |
規則 #1–5 保留,將在後續版本中新增。在該領域有規則之前,請根據一般可用性判斷進行稽核,並在報告中說明。
不可妥協的事項
- X 關閉模態視窗或流程。左箭頭返回上一頁。(#6)
- 載入時絕不顯示空白畫面:必須有骨架、旋轉圖示或進度條。(#7)
- 返回 feed 時必須恢復精確的捲動位置。(#8)
- 點擊目前分頁應返回頂端。(#9)
- 下一頁內容必須在使用者抵達底部前載入。(#10)
- 按讚、追蹤與儲存必須是樂觀更新,失敗時要回滾並顯示訊息。(#11)
- 草稿與未完成的輸入必須自動儲存。(#12)
- 權限應在使用該功能時才要求,絕不在啟動時要求。(#13)
- 快速操作應在底部工作表中開啟,並可向下滑動關閉。(#14)
- 通知與分享連結必須開啟確切的內容。(#15)
- 每個步驟提供少量選擇,並附帶建議的預設值;其餘選項隱藏。(A1)
- 主要操作應大且易於觸及;觸控目標為 44×44。(A2)
- 常見任務應使用標準模式。(A3)
- 資訊應分組;步驟之間不需記住任何內容。(A4)
- 每個輸入需立即回饋;較長的等待需顯示進度。(A5)
- 產品承擔複雜性,而非使用者。(A6)
- 接受混亂輸入並以乾淨形式回應,但絕不降低安全性或資料完整性。(A7)
- 一個任務一個控制項。(F1)
- 畫面操作集中在右上角,主要操作在角落,絕不與選擇器混合。(F2)
- 次要細節按需顯示,絕不遺失;絕不移除取得次要細節的唯一可及路徑。(F3, F5)
- 每個事實只說一次;畫面上不顯示版本號碼、設計備註或內部術語。(F6, F9)
- 當互動行為改變時,所有描述該行為的提示也必須更新。(F8)
- 新的 UI 絕不能宣稱超出產品聲明範疇的內容。(F10)
- 不該有重複開啟步驟的選擇;只有一個選項時就直接執行。(F13, F17)
- 一次選取一個項目,顯示一個上下文工具列,點擊其他地方後消失。(F16)
- 所有能新增的內容都應能移除,且刪除時應顯示將移除的內容。(F18, F19)
- 快捷鍵應顯示在工具提示中,且絕不使用瀏覽器保留的按鍵。(F20)
- AI 提案看起來應是暫時性的,使用統一的接受/拒絕模式,且接受後立即生效。(F23)
- 引導流程:兩個平等的入口,一次一個問題並顯示進度,價值在帳號之前,可跳過的導覽。(F28, F29, F32, F36)
- 金錢相關必須誠實:有真正的免費路徑、附帶日期的試用期、在限制時升級。(F35)
- 閱讀與選擇應在狹窄的置中欄位中進行;只有步驟的上下文與操作保持固定。(F37, F38)
- 缺失資料顯示「不適用」(N/A),文字應截斷並對齊,每個列表都需以實際資料量測試。(F43, F44, F45)
- 角色改變起點,而非整個應用程式;行動版與桌面版使用相同模式。(F47, F50)
工作流程
- 盤點(規則零)。
- 研究(
references/research.md)。對於新流程、重新設計或引導流程,從這裡開始:找出正在設計的內容與對象,分析現有流程,推薦三到五個業界領先範例,並在修改前與使用者逐一審視。僅對現有流程進行小幅修復時可跳過此步驟。 - 繪製流程圖。 列出使用者主要想完成的任務,並為每個任務繪製產品中的路徑:進入點、每個步驟、每個分支、最終狀態。注意每個步驟的資料來源。
- 在瀏覽器中實際走訪每個流程, 不只是程式碼。嘗試快樂路徑,然後嘗試邊緣情況:無資料、網路緩慢、請求失敗、無效輸入、返回、中途重新整理、僅使用鍵盤、窄螢幕。
- 在修改前先稽核。 依照
references/rules.md、references/laws.md與references/field-rules.md結尾的檢查清單以及各領域檔案進行稽核。將發現按領域、規則編號與法則分組。每個發現需包含:流程與步驟、檔案與行號、對使用者造成的問題、修復方式,以及修復使用哪個既有元件或模式。並進行排序:阻塞任務、減緩任務、粗糙邊緣。 - 將稽核結果簡要呈現給使用者, 並在進行大規模修改前徵求同意。在所請求範疇內的小幅、明顯修復可直接執行。
- 按以下順序套用修復: 共用元件與模式 → 流程 → 個別畫面。保持差異範圍在專案慣例內。
- 再次在瀏覽器中走訪流程以驗證, 包括步驟 3 中的邊緣情況。為每個修改的步驟拍攝前後對照。
- 報告 每個流程與領域的變更內容、被修改的元件,以及屬於產品決策的待解決問題。
擴充實戰規則
21 Grams UX 從實際工作中學習。當作者完成對 AI 建構產品的審查會議,並要求將其加入時:
- 閱讀該次會議的對話,列出作者要求或接受的所有變更。
- 保留 UX 變更(流程、結構、位置、狀態、回饋、引導使用者的文字、無障礙路徑)。視覺變更(圓角、顏色、字體、圖示、動畫)屬於 21 Grams UI。
- 將每個變更撰寫為通用規則:規則內容、如何透過專案既有元件應用,以及需要標記的事項。不得包含客戶名稱、產品名稱或私人內容。
- 如果某條規則改進了現有規則,則更新該規則而非新增。
- 將新規則以會議標題為單位新增至
references/field-rules.md,繼續 F 編號,並將其列入對應的領域檔案中。