Communitygithub.com

money-data

设计技能。正确且美观地显示金钱和财务数据。涵盖金额、货币、变化量、账户标识符、按区域设置的盈亏颜色、图表选择(余额、支出、现金流、投资组合、预测、关键绩效指标)、基线、图表擦洗与可访问性、进度和支付状态(转账、卡、KYC步骤、纠纷、目标)、交易列表、收据、报表以及B2B财务仪表盘和数据网格。在您设计、构建、评审或原型任何屏幕或组件时使用。

money-data 是什么?

这是一项面向AI代理的、高度专业化的设计技能,专门用于在各种应用中正确且美观地显示金钱和财务数据。其核心原则是,每笔金额必须能够被用户“一次读懂”,避免歧义和错误解读。该技能整合了来自Wise、Stripe、Apple等头部科技公司以及IBM Carbon设计系统的行业最佳实践,并将其转化为可执行的规则和参考文件集合。 此技能对于确保财务UI的准确性、合规性和用户体验至关重要。它覆盖了从基础的数字格式化(如使用平台API处理货币符号和最小单位)、颜色语义(根据不同区域设置表示盈亏)到复杂的图表选择、数据可视化规范以及各种状态(加载、待处理、失败)的处理等所有方面。 该技能适用于任何涉及金钱显示的消费者应用或B2B工具,并建议与名为“critical-core”和“money-flows”的相关技能搭配使用,以全面处理财务场景中的风险、视觉语言和资金流动操作。其核心包含一个详细的检查清单,确保交付质量,并引用了多个详细的参考文件,用于处理数字、标识符、颜色、图表、进度状态和仪表盘等特定主题。

兼容平台~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] criticalUX 的综合分析。

  1. 使用平台API格式化,切勿手动处理。 使用 Intl.NumberFormat(Web)、NumberFormatter/FormatStyle(Apple)、NumberFormat/DecimalFormat(Android)。它们处理符号位置、分隔符和每种货币的最小单位(日元为0,科威特第纳尔为3)。 [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个带有时间戳的简单阶段。“已发送”不等于“已到达”。预计到达时间(ETA)需标注为估算值。退回的资金应有其独立的非最终状态。 [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")。

状态标签。 图标 + 单词 + 颜色,绝不能只用颜色。使用用户能理解的动词:待处理、已支付、失败、已退款、已退回。避免使用内部代码(如 AUTHORISED、SETTLED)。

移交前检查

  • 每笔金额均由平台API根据用户区域设置格式化,并带有货币
  • 所有变化或列中的数字使用表格数字
  • 无紧凑表示法应用于可操作金额
  • 盈亏使用语义令牌 + 符号 + 字形;已用色盲模拟器测试
  • 条形图从零开始;预测用带状图表示;基线已说明
  • 每个图表都有标题、表格视图和键盘访问方式
  • 每个状态都有加载、待处理、失败、退回和过期状态,并带有时间戳
  • 标识符已屏蔽;显示是经过用户确认的
  • 每个金钱界面都支持“隐藏余额”(隐私)模式
  • 文本缩放至200%时不会截断金额

在将某个监管要点用于发布产品之前,请先阅读每个参考文件中的来源链接。

相关技能