Communitygithub.com

21 Grams UX

稽核並修復由AI建構之產品的流程與可用性,使其如使用者預期般運作,而非僅外觀完善。使用專案既有的元件與模式進行修正。

21 Grams UX 是什麼?

21 Grams UX 是 21 Grams 系列中的可用性套件,專為已存在的流程進行稽核與修復。它不會重新設計產品或新增 UI 套件,而是透過專案既有的元件與模式,找出 AI 建構產品中使用者會遇到的斷點、缺失狀態、無聲失敗、不可復原的操作與表單問題並加以修正。此技能支援多種開發平台,如 Claude Code、Cursor、Codex 等,並遵循一套嚴謹的工作流程:從盤點既有元件開始,進行研究、繪製流程圖、在瀏覽器中實際走訪每個流程、依據內建規則庫進行稽核,最後逐步套用修復。其核心原則是「使用專案既有元件」,絕不建立平行元件或流程,並確保產品決策與業務規則不受影響。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/main/skills/ux

在你喜歡的 AI 中提問

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

說明文件

21 Grams UX 是做什麼的?

對現有流程進行一次審視。21 Grams UX(21 Grams 系列的 UX 套件)不會重新設計產品,也不會新增 UI 套件。它會實際走訪流程,找出 AI 建構的產品在使用者端失效的地方(死路、缺失狀態、無聲失敗、不可復原的操作、與使用者對抗的表單),並透過專案既有的元件與模式來修復它們。

21 Grams UI 負責外觀。21 Grams UX 負責功能。當兩者都安裝時,請先執行 UX:修飾一個不該存在的步驟是沒有意義的。

規則零:使用專案既有的元件

所有修改都必須使用專案既有的東西。21 Grams UX 絕不建立平行元件或平行流程。

  1. 在動手之前先盤點。 記錄路由器和路由表、元件庫、表單庫與驗證方式、提示框、對話框與空狀態元件、資料擷取層(載入與錯誤狀態的來源),以及分析或事件層(如果有的話)。
  2. 在元件所在之處修復。 缺失的錯誤狀態應加入共用的資料或空狀態元件,而非某個畫面。確認模式應使用專案的對話框,而非一次性的。
  3. 如果有適合的元件,絕不新增元件或依賴項。 不要為了達到 21 Grams UX 的效果而引入新的表單庫、提示框庫或導覽庫。
  4. 當某個元件確實缺失時(沒有空狀態元件、沒有復原功能),應使用專案既有的原始元件來建構,並遵循其檔案佈局與命名方式。並在報告中說明。
  5. 產品決策保持不變。 21 Grams UX 不會改變產品的用途、目標對象或業務規則。它只會改變現有任務的執行方式。任何會改變範疇的內容都應以問題的形式放在報告中,而非作為修正。

優先級: 使用者的話語優先,其次是專案既有的模式與產品規則,最後才是 21 Grams UX 的內部規則。

內容

  1. UX 研究步驟。 在設計或重新設計流程之前,逐一分析現有產品與三到五個業界領先的範例,並在連線時使用像 Mobbin 這樣的模式庫。完整流程請參閱 references/research.md。
  2. UX 法則。 規則所依據的知識,收錄於 references/laws.md,按區段編號為 A1、A2……。A 區是核心法則:希克定律、費茲定律、雅各布定律、米勒定律、多赫蒂閾值、泰斯勒定律與普斯特爾定律。當沒有規則涵蓋某種情況時,請根據這些法則推理。
  3. UX 規則。 收錄於 references/rules.md 中的編號規則,每條規則包含規則內容、應用方法以及需要標記的事項,並附有快速稽核查核清單。以行動端優先撰寫,並同樣應用於網頁(桌面版的主要導覽視為「底部分頁」,彈出視窗視為「底部工作表」)。
  4. 實戰規則。 從 AI 建構產品的實際審查會議以及對領先產品的 UX 研究中學到的規則,收錄於 references/field-rules.md,編號為 F1、F2……。此檔案會在每次審查會議後擴充(參閱「擴充實戰規則」)。
  5. 各領域的內部規則 收錄於 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)

工作流程

  1. 盤點(規則零)。
  2. 研究(references/research.md)。對於新流程、重新設計或引導流程,從這裡開始:找出正在設計的內容與對象,分析現有流程,推薦三到五個業界領先範例,並在修改前與使用者逐一審視。僅對現有流程進行小幅修復時可跳過此步驟。
  3. 繪製流程圖。 列出使用者主要想完成的任務,並為每個任務繪製產品中的路徑:進入點、每個步驟、每個分支、最終狀態。注意每個步驟的資料來源。
  4. 在瀏覽器中實際走訪每個流程, 不只是程式碼。嘗試快樂路徑,然後嘗試邊緣情況:無資料、網路緩慢、請求失敗、無效輸入、返回、中途重新整理、僅使用鍵盤、窄螢幕。
  5. 在修改前先稽核。 依照 references/rules.md、references/laws.md 與 references/field-rules.md 結尾的檢查清單以及各領域檔案進行稽核。將發現按領域、規則編號與法則分組。每個發現需包含:流程與步驟、檔案與行號、對使用者造成的問題、修復方式,以及修復使用哪個既有元件或模式。並進行排序:阻塞任務、減緩任務、粗糙邊緣。
  6. 將稽核結果簡要呈現給使用者, 並在進行大規模修改前徵求同意。在所請求範疇內的小幅、明顯修復可直接執行。
  7. 按以下順序套用修復: 共用元件與模式 → 流程 → 個別畫面。保持差異範圍在專案慣例內。
  8. 再次在瀏覽器中走訪流程以驗證, 包括步驟 3 中的邊緣情況。為每個修改的步驟拍攝前後對照。
  9. 報告 每個流程與領域的變更內容、被修改的元件,以及屬於產品決策的待解決問題。

擴充實戰規則

21 Grams UX 從實際工作中學習。當作者完成對 AI 建構產品的審查會議,並要求將其加入時:

  1. 閱讀該次會議的對話,列出作者要求或接受的所有變更。
  2. 保留 UX 變更(流程、結構、位置、狀態、回饋、引導使用者的文字、無障礙路徑)。視覺變更(圓角、顏色、字體、圖示、動畫)屬於 21 Grams UI。
  3. 將每個變更撰寫為通用規則:規則內容、如何透過專案既有元件應用,以及需要標記的事項。不得包含客戶名稱、產品名稱或私人內容。
  4. 如果某條規則改進了現有規則,則更新該規則而非新增。
  5. 將新規則以會議標題為單位新增至 references/field-rules.md,繼續 F 編號,並將其列入對應的領域檔案中。

Individual skills in this repo

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

相關技能