Communitygithub.com

money-data (金融資料呈現)

設計技能。正確且美觀地顯示金錢與金融數據。涵蓋金額、貨幣、變動值、帳戶識別碼、依地區設定漲跌顏色、圖表選擇(餘額、支出、現金流、投資組合、預測、關鍵績效指標)、基準線、圖表觸控探索與無障礙性、進度與付款狀態(轉帳、卡片、KYC 步驟、爭議、目標)、交易列表、收據、對帳單以及 B2B 金融儀表板和數據網格。每當你設計、建構、評審或原型製作一個畫面或元件時,請使用本技能。

money-data (金融資料呈現) 是什麼?

這項技能提供了一個全面的指南,指導如何在使用者介面中正確且一致地呈現金融數據。它基於頂尖金融科技公司(如 Wise、Monzo、Stripe)及 Apple 和 IBM Carbon 的實務經驗,涵蓋從貨幣格式化、顏色語義、圖表選擇到交易記錄與儀表板的一切。其核心規則以標準([REG])、研究([RES])、實務([PRAC])或關鍵用戶體驗綜合([INF])為依據,例如強制使用平台原生的 `Intl.NumberFormat` 等 API、規定漲跌顏色必須是根據地區設定解析的「語義代碼」並搭配符號與字形、以及使用「扇形圖」來呈現不確定的預測。這套技能適用於 Claude Code、Cursor 及類似代理工具,當開發者被要求設計或建構金融相關畫面時,應自動觸發此技能,以確保專業人士和一般使用者都能獲得易於閱讀且無障礙的體驗。它還附帶了五份參考文件(numbers-and-identifiers、color-and-gain-loss、charts、progress-and-status、records-and-dashboards)和一張全面的交付前檢查清單。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sthitapragna-009/Critical_UX/tree/HEAD/skills/money-data

在你喜歡的 AI 中提問

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

說明文件

money-data (金融資料呈現) 是做什麼的?

如何顯示金錢,讓人們第一次就能正確解讀。這些規則同時適用於消費者應用程式和密集的 B2B 工具。它們源自於嚴格應用於金錢的排版與資料視覺化標準,以及 Wise、Monzo、Stripe、Coinbase、Robinhood、Apple 和 IBM Carbon 的實務記錄。

請將此技能與 critical-core (風險、情緒、視覺語言) 和 money-flows (移動金錢的行動) 搭配使用。

如何使用此技能

  1. 為每個數字命名其任務。 它是餘額、待付款金額、變動值、利率、預測值還是參考編號?任務決定了格式、精準度、顏色和位置。
  2. 載入你需要的參考文件 (如下),然後再撰寫程式碼或指定元件。請使用確切的值;不要即興發揮格式。
  3. 撰寫所有狀態,而不只是預期路徑。 每個金錢相關的表面都具有載入中、過時、處理中、失敗、空白和隱藏狀態。
  4. 在交付前執行檢查清單 (在結尾處)。
參考文件載入時機
references/numbers-and-identifiers.md貨幣格式化、小數單位、四捨五入、精簡表示法、負數、表格數字、遮罩帳戶號碼、單位與劑量
references/color-and-gain-loss.md依地區設定區分的正/負顏色、色盲安全配色、標記對比度、語義代碼
references/charts.md圖表選擇器、基準線、時間範圍、預測與不確定性、走勢圖、觸控探索、圖表無障礙性、遊戲化限制
references/progress-and-status.md載入臨界值、付款與轉帳狀態圖、卡片、爭議與 KYC 狀態、儲蓄目標與信用額度計量器
references/records-and-dashboards.md交易行、商家資訊清理、收據、對帳單、B2B 儀表板、金融數據網格、稽核日誌、對帳

上述所有內容的原始設計代碼存放在專案根目錄的 /tokens 中。

最重要的規則

每條規則都帶有來源類型:[REG] 法律或標準,[RES] 已發佈的研究,[PRAC] 記錄在案的公司實務,[INF] 關鍵用戶體驗綜合。

  1. 使用平台 API 格式化,切勿手動處理。 使用 Intl.NumberFormat (Web)、NumberFormatter/FormatStyle (Apple)、NumberFormat/DecimalFormat (Android)。它們會處理符號位置、分隔符號以及每種貨幣的小數單位 (JPY 沒有,KWD 有三個)。 [PRAC]
  2. 每個金額都必須附帶其貨幣。 在多貨幣產品中,絕不能只有裸數字。當符號不明確時 (單獨一個 $ 可能代表 USD、CAD、AUD、MXN 等),請使用 ISO 代碼 (USD)。 [INF]
  3. 任何會變動或位於欄位中的數字,請使用表格數字 (font-variant-numeric: tabular-nums)。比例字型數字會在數值跳動時產生抖動。 [PRAC]
  4. 精簡表示法僅限用於軸線和摘要圖塊。 永遠不要用在餘額、付款金額、費用或任何使用者即將操作的金額上。 [INF]
  5. 各部分加總應等於總額,否則畫面需說明四捨五入的適用情況。 [INF]
  6. 正數與負數是根據地區設定或使用者設定解析的語義代碼,而非硬編碼的綠色和紅色。在中國大陸、日本和台灣市場,紅色代表 上漲。始終將顏色與符號 (+/−) 和字形搭配使用。 [RES/PRAC]
  7. 圖表標記與相鄰顏色之間的對比度需達到 3:1 (WCAG 1.4.11),且沒有意義僅依賴顏色傳達 (WCAG 1.4.1)。 [REG]
  8. 長條圖從零開始。折線圖則不一定。 截斷的長條圖會誇大差異。 [RES]
  9. 絕不只用單一線條顯示不確定的未來。 儲蓄、退休、貸款償還或預測的預估值應使用扇形圖或區帶圖。2026 年英格蘭銀行的一項研究 (n≈1,600) 發現,扇形圖最能傳達預期與不確定性,並能在預測失準時保護信任度。 [RES]
  10. 每個圖表都應提供一個表格檢視和一行標題摘要。 觸控探索功能需有鍵盤和螢幕閱讀器對應的操作方式。 [PRAC]
  11. 說明每個變動值的基準線。 "+2.4% 今日 (自昨日收盤起)"。 [PRAC]
  12. 進度顯示必須誠實。 將後端狀態對應到 3-5 個帶有時間戳記的明確階段。「已發送」不等於「已送達」。預計送達時間應標示為估計值。退回的款項有自己非最終的狀態。 [PRAC]
  13. 立即顯示點擊已註冊。 「請勿按兩次」的警告效果不佳;立即顯示「處理中」狀態並停用按鈕則有效。 [RES]
  14. 預設情況下遮罩識別碼 (•••• 4421),按需顯示時需重新驗證才能查看完整號碼。 [PRAC]
  15. 「處理中」狀態需標明並解釋原因,且絕不能在不告知的情況下,將其添加到可用餘額或從中扣除。 [INF]
  16. 投資、信貸或支出圖表上禁止使用獎勵機制 (交易成功噴彩帶、刮刮樂揭示、人氣排名)。Robinhood 在 2024 年為此向麻薩諸塞州支付了 750 萬美元罰款。 [REG]

快速規格

金額層級。 在餘額或付款畫面上,金額是最大的文字,使用表格數字,貨幣符號使用相同或輕一級的視覺粗細。小數位數可以較小,但對比度不得低於 4.5:1。

變動值標籤。 +£12.40 (+0.8%) 今日 → 符號、絕對值、相對值、期間。顏色代碼 + 箭頭字形 + 符號。零值顯示為 £0.00 (0.0%),無符號且使用中性顏色 (signDisplay: "exceptZero")。

狀態標籤。 圖示 + 文字 + 顏色,絕不能只有顏色。使用人們理解的動詞:處理中 (Pending)、已付款 (Paid)、失敗 (Failed)、已退款 (Refunded)、已退回 (Returned)。避免使用內部代碼 (AUTHORISED、SETTLED)。

交付前請檢查

  • 每個金額都由平台 API 根據使用者的地區設定格式化,並帶有貨幣
  • 所有變動中或欄位化的數字都使用表格數字
  • 可操作的金額上沒有使用精簡表示法
  • 漲跌使用語義代碼 + 符號 + 字形;已使用色盲模擬器測試
  • 長條圖從零開始;預測值以區帶圖顯示;已說明基準線
  • 每個圖表都有標題、表格檢視和鍵盤操作功能
  • 每個狀態都有載入中、處理中、失敗、已退回和過時狀態,並附帶時間戳記
  • 識別碼已遮罩;顯示是刻意行為
  • 隱藏餘額 (隱私) 模式在所有金錢相關畫面上都能作用
  • 文字可縮放至 200% 而不截斷金額

在將法規要點用於正式產品之前,請閱讀每個參考文件中的來源連結。

相關技能