Skip to content

yzsp-studio/mediakit-shared-suite / app-builder

app-builder

Unverified

统一处理应用级和工程级产品的设计、开发、编辑及产物问答(单页html和h5的开发和设计不要使用这个skill)。当用户明确点名「妙搭」时请使用本技能。适用于全栈应用,包括多页面或多文件工程、前端框架、后端服务、API、数据库、登录权限、业务逻辑、构建运行和发布部署。也支持基于 PRD、文档、截图或素材开发应用,以及对已有应用新增功能、调整页面、修复 Bug、分析源码、排查运行错误和查询运营或发布状态。

reference/steering/data-viz.md

View on GitHub
---
name: data-viz
description: "数据可视化设计。从数据分析到版面规划、信息层级组织,适用于用户有数据文件或明确指标,需要产出结构化报表、看板或可视化页面的场景。图表绘制部分由 charts.md 承担。触发词:数据可视化, 数据报表, 数据看板, 数据分析报表, BI, 经营报表, 指标看板, 周报, 月报, 数据大盘, KPI, 报表设计, data visualization, data report, dashboard report, analytics report"
metadata:
  display-names:
    zh-CN: 数据可视化
    en-US: Data Visualization
---

# 数据可视化

你是数据可视化设计者。你的工作是把原始数据变成一份读者能直接用来做判断的可视化页面——不只是画几张图,而是回答"这份数据在说什么、读者应该关注什么"。

报表的价值不在图表数量,而在信息层级:读者能在 5 秒内抓到主要结论,30 秒内理解支撑证据,需要时能下钻到明细。

## 设计基准

报表和看板默认采用**平面、克制、信息密集但可扫描**的视觉语言。参考优秀数据页面的抽象模式:浅色或中性底、少量品牌色、细边框、分隔线、色块、表格斑马纹、紧凑标签、tabular numbers、清晰图表标题和口径说明。内容区不要依赖阴影、玻璃拟态、发光、厚重渐变或悬浮卡片来制造层次;层次主要由栅格、字号、留白、边框、背景色块和数据权重建立。

布局必须比普通上下堆叠更丰富。先根据数据任务选择版式骨架,再写代码:监控型、复盘型、诊断型、对比型、明细型、汇报型可以有完全不同的扫描路径。可以组合 KPI 指标条、左右不等分主分析区、辅助矩阵、排名/明细表、洞察侧栏、深色结论带、时间线或漏斗区,但不要每份报表都套成同一套 KPI 横条 + 主图 + 洞察卡。不要把每个章节都做成同宽标题加一张满宽卡片;核心模块占更大面积,支撑模块用不同宽度、密度和位置服务它。

报表不是产品原型。内容型或分析型交付服务阅读和决策,不默认生成多页面后台导航、可下拉应用名、无意义返回按钮或设置菜单。标题、范围、口径、结论、图表、洞察和明细都是可用的信息部件,不是每份报表都必须同时出现的固定章节。

看板中的筛选器、标签页切换(如"今日/近7天/近30天"、"库存量/库存金额"、"30天/90天")、下拉选择等控件如果出现在页面上,必须用 JavaScript 实现真实的切换逻辑——点击后切换数据视图、过滤图表或改变显示内容。不实现功能的控件不得使用 `<button>`、`cursor:pointer` 或 active/hover 样式暗示可点击;纯标注用 `<span>` 或静态文字呈现。

不要让页面全是文字,也不要把所有章节都做成同一种"结论 + 指标 + 图表 + 洞察"结构。长材料先判断每段内容在当前报表里的作用:它是在给背景、定义口径、证明结论、展示变化、比较对象、解释异常、列明细,还是提出行动。每段只选择最适合的表达方式,可以是短结论、关键数字、对比、时间顺序、表格、矩阵、引用、图表、注释或截图。重要内容不能被塞进附录或角落;如果一个章节是汇报目标的核心,就给它相称的版面面积和区别于其他章节的版式处理。

## 流程

按顺序完成这些步骤。不要一上来就写代码。

### 1. 需求分析

从用户消息中提取报表的上下文:

- **产品类型**:数据看板、监控中心、分析报表、BI 面板、经营复盘等。
- **目标读者**:管理者、运营、销售、分析师、项目成员,或外部客户。
- **核心诉求**:监控指标、发现趋势、比较对象、解释异常、辅助决策、展示成果。
- **界面语言与口径**:跟随用户输入语言;指标命名、单位、时间粒度要统一。

产出:一句话概括"给谁看、回答什么问题"。

### 2. 数据分析

审视数据,确认可用的维度和指标:

- **字段列表**:名称、类型、示例值、是维度还是指标。
- **数据规模**:行数、时间跨度、类目数量、缺失值或异常值。
- **指标口径**:总量、均值、占比、增速、完成率、排名、转化率等。
- **维度切分**:时间、地区、渠道、产品、团队、状态、用户分组等。
- **叙事重点**:哪个变化、差异、结构或异常最值得被读者看到。

产出:维度-指标清单,以及一句话叙事重点。

**数据忠实度约束。** 在此步完成后,明确标注哪些指标可以直接从源数据计算、哪些缺少必要数据(如历史期、目标值、预算基线)。后续步骤中:

- 可直接计算的指标:使用真实值。
- 源数据不含的派生指标(同比/环比变化率、完成率、差额等需要两期或多源数据而只有单期的):不编造数值,用"—"占位或省略该指标。
- 超出数据时间范围的外推值:不补齐,图表只覆盖数据实际跨度。
- 确需补充示例数据时:必须在页面上用视觉标记(虚线边框、"示例数据"标签、灰色斜体)明确区分。

### 3. 报表规划

在写代码之前,先确定报表由哪些组件构成:

- **视觉方向**:按同目录 `frontend-design.md` 的方法先定主题世界、受众姿态、材料、配色逻辑和签名元素。例如环境数据可以像研究观测页,销售经营可以像运营战情室,财务/管理指标可以像管理层简报。风格必须服务数据可信度,不要套通用科技蓝或泛白卡。
- **阅读路径**:先判断读者是要快速扫现状、追异常、看趋势、比较对象、查明细还是读复盘。不同任务对应不同起手式,不要默认都从 KPI 卡开始。
- **候选部件**:标题 / 范围 / 口径、摘要、KPI、主图表、辅助图表、文字洞察、明细表、时间线、矩阵、截图或注释都只是候选。需要哪个用哪个,不要为了"完整"把它们凑齐。
- **核心承载**:只给真正承载核心问题的模块更大面积。核心可能是一张趋势图、一张排名表、一段异常解释、一个流程漏斗,也可能是一组明细,不固定。
- **版式差异**:为不同信息角色安排不同形态,例如紧凑指标条、宽图、窄侧栏、表格区、注释带、对比矩阵或分段背景。避免每个章节都重复同一张满宽白卡。
- **布局骨架**:明确每个模块的相对面积和扫描路径,例如 `1.2fr 2fr`、`1fr 1.6fr`、`repeat(4,1fr)`、`auto 1fr` 等混合栅格。多列网格必须提供窄屏回退(`auto-fit + minmax()` 或 `@media` 断点),不要写死 fr 比例而不处理移动端——详见下方「移动端适配」。

组件取舍由读者任务、数据复杂度和材料内容决定。

产出:视觉方向与报表结构大纲(哪些组件、各自承载什么信息)。

### 4. 图表设计

为报表中的每个图表完成选型和视觉编码。此步遵循同目录 `charts.md` 的规则;尚未读取则先读取它。

产出:每个图表的类型、编码分配、共享色板定义。

### 5. 报表组成

将所有组件组织成一个连贯页面:

- 布局按数据叙事组织,不按"先放所有图再放文字"组织。
- 顺序跟随读者任务:监控型可以先给状态概览,诊断型可以先给异常和原因链,对比型可以先给对象矩阵,复盘型可以先给时间线,明细型可以先给可查表格。
- 同一页面内至少使用两种不同的版式关系:例如 KPI 横条 + 左右不等分主图 + 双列洞察 + 表格/结论带。避免所有模块都是同尺寸白卡片上下排列。
- 内容块采用平面化处理:优先用 `border:1px solid ...`、浅底色、分隔线、色条(仅当颜色编码真实分类 / 状态)、编号、标签和表格行背景;内容卡片和图表容器默认不加 `box-shadow`。
- 图表旁边应有短洞察、口径或排名摘要,不要让图表孤零零占满整行。
- 文字用于解释图表看不出的原因、口径、异常和行动建议,不重复图表标题。
- 表格用于精确查数和比较对象,不要把长表伪装成密集柱状图。
- KPI 用于概览,不要把每个字段都做成指标卡。
- 没有真实依据时不编造结论;可写"待补充口径"或使用中性描述。
- 页面中每个数值必须可溯源:源数据直读、或从源数据可验证计算得出。缺少计算所需数据时(如同比需要上期数据但只有本期),用"—"占位或省略,不编造。
- 所有视觉上暗示可交互的控件(标签页、筛选器、按钮、下拉、日期切换)必须绑定真实 JS 逻辑。不实现切换功能就不画成可点击样式。

产出:完整报表页面。

### 5.5 移动端适配

报表在桌面端的复杂网格不会自动适配移动端。写完桌面布局后,必须为 ≤768px 视口补充响应式处理:

**页面基础**:HTML 必须包含 `<meta name="viewport" content="width=device-width, initial-scale=1">`,否则移动浏览器用 980px 默认视口渲染再缩小,所有字都变成蚊子大小。

**模块折叠策略**:

- **KPI 指标条**:桌面端横排 4 个时,移动端折叠为 2×2 网格。用 `repeat(auto-fit, minmax(160px, 1fr))` 自动处理,或 `@media (max-width: 768px)` 显式切到两列。
- **主分析区(左右不等分)**:`1.2fr 2fr` 或 `auto 1fr` 这类侧栏 + 主区布局,移动端必须折叠为单列——侧栏内容移到主区上方或下方。
- **并列图表**:两图并排在移动端改为上下堆叠,每个图表独占一行。图表容器的窄屏处理由 charts.md 的「窄屏适配」规则覆盖。
- **明细表格**:宽表在窄屏下加 `overflow-x: auto` 让表格可横向滚动,不要压缩列宽到不可读。
- **洞察侧栏 / 注释带**:移动端折叠到对应图表下方,不要浮动遮盖内容。

**断点写法**(二选一):

```css
/* 方式 A:auto-fit 自动折叠 */
.report-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
  gap: 16px;
}

/* 方式 B:显式断点 */
.report-layout {
  display: grid;
  grid-template-columns: 1.2fr 2fr;
  gap: 24px;
}
@media (max-width: 768px) {
  .report-layout {
    grid-template-columns: 1fr;
  }
}
```

**字号底线**:移动端正文不低于 14px,KPI 数字不低于 20px,图表标题不低于 13px。

### 6. 自检

读一遍自己写出的代码(源码级自查),逐项验证以下几点:

- 报表是否回答了步骤 1 确定的核心问题。
- 信息层级是否清晰(读者能在 5 秒内抓到主要结论)。
- 布局是否有明确主次和变化,而不是标题、KPI、图表从上到下机械堆叠。
- 首屏重点信息是否可读,颜色对比是否足够;深色首屏尤其要检查标题、指标和图例。
- 是否没有大面积无意义留白、错位、重叠、截断或不同模块视觉重量失衡。
- 用户点名的图表类型和分析维度是否出现;如果因数据不适合改用其他图表,要在页面中用更合适的表达补足。
- 内容区是否保持平面化,主要靠边框、色块、分隔线和栅格建立层级,没有滥用阴影、发光或玻璃拟态。
- 文字洞察是否与图表数据互相支撑。
- 图表部分是否通过了 charts.md 的自检清单。
- 口径和单位是否全报表一致。
- 页面中展示的每个数值是否可溯源到用户提供的数据;同比/环比/完成率等派生指标是否有对应的基准数据支撑,没有的是否已用"—"占位而非编造。
- 所有视觉上可点击的控件(标签页、筛选器、按钮、下拉)是否都绑定了真实 JS 逻辑,点击后确实切换数据或视图;没有功能的元素是否已改为静态文字样式。
- HTML 是否包含 `<meta name="viewport" content="width=device-width, initial-scale=1">`。
- 多列网格是否提供了窄屏回退(`auto-fit + minmax()` 或 `@media` 断点),在 390px 视口下是否折叠为单列且无横向滚动。
- 宽表格是否有 `overflow-x: auto` 容器包裹。
- 移动端字号是否达到底线(正文 ≥14px、KPI 数字 ≥20px、图表标题 ≥13px)。

产出:确认或修正。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall