Agent skill · daymade
data-visualization-discipline
数据可视化的判断层 SSOT——画任何图表、dashboard、看板之前先加载它,不是画完之后。管"该不该这么画":这张图想让读者得出什么结论、用均值还是中位数、能不能聚合、堆叠还是折线、能不能上双轴、配色与颜色数量、同一实体跨图是否同色同位、表格该留几列。介质无关:HTML 报告页、React/Vue dashboard、PPT 原生图表、matplotlib/plotly/ECharts/D3、渲染成 PNG 的图,一律适用。Use when 动手画图之前,或评审既有图表("这几张图有什么问题"、"图例为什么不一致")。Not for 报告页的排版/组件/交互(用 report-with-html:report-with-html)或 PPT 原生图表的实现与渲染陷阱(用 deck-creator:deck-creator)。
What it needs
About 5k tokens when loaded.
What this skill does
数据可视化纪律 这是可视化判断层的唯一权威源。其他 skill 引用它、不复制它——一条规则出现在两处,就多一个将来会矛盾的地方。 边界:什么归我,什么不归我 问题 归属 --- --- 这张图想让读者得出什么结论?该用什么图型?用均值还是中位数?能不能聚合?几个颜色? 本 skill 报告页怎么排、用哪个组件、什么皮、交互键位、浏览器渲染自验、认可语料 register report-with-html:report-with-html python-pptx 怎么落原生图表、次轴折线在 QuickLook 不渲染、中文掉字 deck-creator:deck-creator 图表用什么库实现 当前项目已声明的图表栈;没有就先调研选维护中的库,禁止手搓图表引擎 参考文件清单见下一节末尾的表(按阶段锚定,一处维护)。 --- 这份 skill 怎么组织的(加规则之前先读这节) 规则按你在什么时刻会想起它排,不按主题分类:定意图 → 验数据 → 选形 → 编码 → 交付前自检。 阶段 1–4 各有「交接检查」,阶段 5 是交付闸,交付前那道最重。 这不是"一道闸抓所有规则"——那会把闸撑到十几条,而检查清单一超过 9 条就开始被跳过(Gawande)。成熟做法是多个停点各管各的:飞机在滑行、起飞、巡航、落地有各自的清单,不是一张。所以本 skill 的判据是: 每条规则都必须被相应阶段的检查点抓住。 不是每条都要进交付闸。 这个轴不是审美选择,是防膨胀装置。一份按主题堆叠的规则集会一直长——每收编一处沉淀就多几节,最后没人读得完,也没人知道新规则该放哪。所以: 加一条新规则前,先回答:它在第几阶段被想起?它的违反被哪个检查点抓住? 都答得上 → 写进那个阶段,正文里说清判据,并确认那个检查点的产物清单真的会暴露它。 答得出阶段、答不出检查点 → 把它加进那个阶段的交接检查(阶段交接不受 9 条预算限制,因为它只在那一刻问一次)。只有当它必须在交付前再查一遍时,才动交付闸——而交付闸是 5–9 条 killer items 的预算,加一条得说清挤掉谁。 这条准入规则同样管存量。 最容易漏的不是新规则——是规则立起来那天已经在文件里的内容,没人回头用它筛一遍("祖父豁免")。但也不能因此开一张无边界重构的许可证,所以判据是有范围的:每次实质改动这份文件时,顺手对你本次已经打开的那一节做一次同样的核对;不为找问题去打开本次不涉及的章节。 写完之后必须机械核一次,别靠记性——把新规则的关键词 grep 一遍,看它在检查点文字里出没出现。0 命中 = 它没挂上任何检查点,回到上面几条重新归位。 以下限定缺一不可: 范围要说死:各阶段的「阶段 N 交接检查」引用块 + 交付闸的编号条目正文、产物行、以及豁免表。豁免表要搜,但它的命中意义是相反的——见下一条。 >0 命中 ≠ 挂上,必须读那一处。命中的可能是"这条闸在查这件事"(真挂上),也可能是"这条闸声明自己不管这件事"(豁免行)。只在豁免行命中 = 反向证据:它恰恰证明这条规则被明确排除在检查范围之外,等同 0 命中,要回去重新归位。 例如,若"纯 KPI 数字卡片"只出现在闸 8 的豁免行、正文与产物行没有对应判据,说明该规则被排除。不能把"不管 KPI 卡片"读成"已经挂上"。 换 2–3 个同义词再搜一遍:实测过一次假阴性——搜"色盲"全文 0 命中,但文件一直用"色觉障碍"讲同一件事,只搜一个词会误判成"完全没覆盖"。 这个动作只对「写进阶段正文」那条出口有验证力。直接写进交接检查的,grep 必然命中(那个词就是你刚放进去的),等于什么都没验证——那条路径要反过来问:"交接检查里这句,正文里有对应的判据吗?"没有的话它是一句无处可查的口令。判定为战例的则整个跳过这一步:战例本来就不该出现在检查点里,0 命中是正确结果,不是失败。 例外:正向动作不配闸。 阶段 1「画法没有明显答案时:批量出候选」不是"禁止什么"而是"该做什么"的规则。这类生成性技术没有可判失败的违反形态——硬给它配闸只会在"画法本就明显"的常见情形上误杀。它的归位方式是挂在最近那个检查点上做条件子句(阶段 1 交接第 4 项之后),不单列。 答得出不止一个阶段(两个都说得通,不是答不出)→ 多半说明它是两条规则粘在一起,拆开,每半各归各的阶段。真实例子:"做图前先问会不会被黑白打印"能同时论证阶段 1(受众 × 介质,早问省重做)与阶段 4(技术解法与"红绿不能是唯一通道"同源)——正确处理是拆:触发条件进阶段 1 交接、技术解法并进阶段 4 既有规则。拆不开、确实是一条 → 放更早那个阶段(早发现便宜)。 哪个阶段都答不出(一个都说不通)→ 要么不属于本 skill(介质实现层归 report-with-h …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills daymade/data-visualization-discipline