Skip to content
Skills Library
Data & analytics · Review & audit

tooltip-missing-unit-trap

/tooltip-missing-unit-trap

当用户在 Tooltip 中省略数据单位时触发,用于警告这会造成歧义。触发场景:用户问"Tooltip 需要显示单位吗?"、"数值 1234 是什么意思?"、"如何避免用户对数据量级的误解?"。不适用于:无单位的纯计数数据。关键 trigger 信号:Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元。

Repository
agents ↗
Licence
MIT
Last repository change
28.08.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

当用户在 Tooltip 中省略数据单位时触发,用于警告这会造成歧义。触发场景:用户问"Tooltip 需要显示单位吗?"、"数值 1234 是什么意思?"、"如何避免用户对数据量级的误解?"。不适用于:无单位的纯计数数据。关键 trigger 信号:Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元。

Triggers from the description

Tooltip 需要显示单位吗?数值 1234 是什么意思?如何避免用户对数据量级的误解?
Original author description

当用户在 Tooltip 中省略数据单位时触发,用于警告这会造成歧义。触发场景:用户问"Tooltip 需要显示单位吗?"、"数值 1234 是什么意思?"、"如何避免用户对数据量级的误解?"。不适用于:无单位的纯计数数据。关键 trigger 信号:Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元。

How it works

  1. R (Reading) — 原文引用
  2. I (Interpretation) — 方法论骨架
  3. A1 (Past Application) — 书中作者用过的案例
  4. A2 (Future Trigger) — 何时调用此 skill
  5. E (Execution) — 可执行步骤
  6. B (Boundary) — 边界与盲点
Original SKILL.md headings · 87 lines, 234 words
SKILL.md preview
---
name: tooltip-missing-unit-trap
description: |
  当用户在 Tooltip 中省略数据单位时触发,用于警告这会造成歧义。触发场景:用户问"Tooltip 需要显示单位吗?"、"数值 1234 是什么意思?"、"如何避免用户对数据量级的误解?"。不适用于:无单位的纯计数数据。关键 trigger 信号:Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元。
source_book: 《ENCY-charts 数据可视化设计规范》 ENCY Design Team
source_chapter: 7. Do's #3 + 7. Don'ts #5
tags: [data-visualization, tooltip, unit-display, clarity]
related_skills: [chart-taboo-principles, clarity-first-principles, kpi-card-glossary]
---

# Tooltip Missing Unit Trap(Tooltip 省略单位歧义)

## R (Reading) — 原文引用

> "Do's: Tooltip 包含单位 + 时间 + 值 — 完整上下文帮助用户快速理解"
> "Don'ts: 不要在 Tooltip 中省略数据单位 — 造成歧义"

## I (Interpretation) — 方法论骨架

**核心问题**:缺少单位的数据失去业务含义,用户无法判断数值的量级(是 1234 元还是 1234 万元?),导致误解或需要额外查找上下文。

**失败机制**:
1. **量级不明**:用户无法判断 1234 是 1234 元、1234 万元还是 1234 亿元
2. **决策错误**:基于错误的量级理解做出错误判断
3. **认知负担**:用户需要额外查找上下文才能理解数据

**正确做法**:所有数值显示必须包含单位(万/亿/元/个/人/次/%),Tooltip 应提供完整上下文(名称 + 数值 + 单位 + 时间)。

## A1 (Past Application) — 书中作者用过的案例

在 ENCY-charts 规范中,作者将"Tooltip 包含单位 + 时间 + 值"列为 Do's,将"省略数据单位"列为 Don'ts,强调完整上下文的重要性。

## A2 (Future Trigger) — 何时调用此 skill

**调用场景**:
- 设计师问"Tooltip 需要显示单位吗?"
- 产品经理说"用户反馈看不懂这个数值是什么意思"
- 前端工程师问"数值 1234 应该显示为 '1234' 还是 '1234 万元'?"

**关键 trigger 词**:Tooltip 单位 / 数据单位 / 数值歧义 / 万/亿/元 / 完整上下文

## E (Execution) — 可执行步骤

**步骤 1:检查 Tooltip 配置**
- 验证 formatter 是否包含单位:
  ```javascript
  tooltip: {
    formatter: function(params) {
      // 错误做法:仅显示数值
      // return `${params.name}: ${params.value}`;
      
      // 正确做法:包含单位
      return `${params.name}: ${params.value} 万元`;
    }
  }
  ```

**步骤 2:添加完整上下文**
- Tooltip 应包含:名称 + 数值 + 单位 + 时间
  ```javascript
  tooltip: {
    formatter: function(params) {
      return `
        <div>${params.seriesName}</div>
        <div>时间: ${params.name}</div>
        <div>数值: ${params.value} 万元</div>
      `;
    }
  }
  ```

**步骤 3:自动化检查**
- 扫描 Tooltip formatter,查找缺少的单位:
  ```javascript
  const tooltipFormatter = option.tooltip?.formatter?.toString();
  if (tooltipFormatter && !/(万|亿|元|个|人|次|%)/.test(tooltipFormatter)) {
    console.warn('Tooltip 可能缺少单位,请检查');
  }
  ```

**步骤 4:验证用户理解**
- 进行可用性测试:让用户看 Tooltip,问"这个数值是什么意思?"
  - 如果用户能准确说出量级 → 合格 ✓
  - 如果用户困惑或猜错 → 需要添加单位

## B (Boundary) — 边界与盲点

**例外情况**:
- 无单位的纯计数数据(如"用户数: 1234 人"中的"人"可以省略,因为语境明确)
- 百分比数据(% 符号通常已包含在数值中)

**相关 skills**:
- `chart-taboo-principles` — 图表禁忌清单
- `clarity-first-principles` — 清晰性优先原则
- `kpi-card-glossary` — KPI 指标卡
Files in this package (2)
  • SKILL.md 4 KB
  • test-prompts.json 1 KB

Versions

RepositoryScoreLicence
This page · natsummerance/agents100MIT
natsummerance/agents100MIT

Database snapshot: 13.11.2026 · package version 2f7e5cfc5033 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100y-axis-non-zero-trap
    当用户考虑将柱状图的 Y 轴起点设为非零值时触发,用于警告这会放大微小差异并误导用户。触发场景:用户问"如何让两个数值的差异看起来更明显?"、"Y 轴可以从 90 开始吗?"、"截断 Y 轴是不是更好的展示方式?"。不适用于:折线图(可以截断)、对数坐标轴。关键 trigger 信号:Y 轴起点 / 截断 Y 轴 / 柱状图 Y 轴 / 放大差异。
  • 100y-axis-non-zero-trap
    当用户考虑将柱状图的 Y 轴起点设为非零值时触发,用于警告这会放大微小差异并误导用户。触发场景:用户问"如何让两个数值的差异看起来更明显?"、"Y 轴可以从 90 开始吗?"、"截断 Y 轴是不是更好的展示方式?"。不适用于:折线图(可以截断)、对数坐标轴。关键 trigger 信号:Y 轴起点 / 截断 Y 轴 / 柱状图 Y 轴 / 放大差异。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.