AgentSkillsCN

jeff-display-formatting

Jeff针对货币、数字、日期及其可视化展示所制定的格式化规范。无论何时需要在用户界面中渲染API返回的数值,都可放心采用这些规范。

SKILL.md
--- frontmatter
name: jeff-display-formatting
description: Jeff's display-formatting conventions for money, numbers, dates, and date visuals. Use whenever rendering API values in UI.

Jeff's Display Formatting

Render user-facing values with consistent formatting across routes.

Apply when

  • Displaying monetary amounts.
  • Displaying dates/times from API values.
  • Rendering date visuals in table/list cells.

Money rules

  • Use formatAmount() from @/lib/utils.
  • Do not render raw numeric strings for currency.
  • Pair numeric output with font-mono tabular-nums where alignment matters.

Date/time rules

  • Do not display raw API timestamps directly.
  • Use date-fns formatting or shared helpers.
  • Use human-readable formats (for example dd MMM yyyy, h:mm a).
  • For URL state, store dates as yyyy-MM-dd strings.

Visual date rule

  • Use <DynamicDateIcon date={...} /> in list/table contexts where a date icon improves scanability.

Validation checklist

  • No raw timestamp/currency output in UI.
  • Numeric columns align consistently.
  • Date format is human-friendly and consistent in-module.