data-visualization-discipline

1# 数据可视化纪律
2 
3这是可视化**判断层**的唯一权威源。其他 skill 引用它、不复制它——一条规则出现在两处，就多一个将来会矛盾的地方。
4 
5## 边界：什么归我，什么不归我
6 
7| 问题 | 归属 |
8|---|---|
9| 这张图想让读者得出什么结论？该用什么图型？用均值还是中位数？能不能聚合？几个颜色？ | **本 skill** |
10| 报告页怎么排、用哪个组件、什么皮、交互键位、浏览器渲染自验、认可语料 register | `report-with-html:report-with-html` |
11| python-pptx 怎么落原生图表、次轴折线在 QuickLook 不渲染、中文掉字 | `deck-creator:deck-creator` |
12| 图表用什么库实现 | 当前项目已声明的图表栈；没有就先调研选维护中的库，**禁止手搓图表引擎** |
13 
14参考文件清单见下一节末尾的表（按阶段锚定，一处维护）。
15 
16---
17 
18## 这份 skill 怎么组织的（**加规则之前先读这节**）
19 
20规则按**你在什么时刻会想起它**排，不按主题分类：**定意图 → 验数据 → 选形 → 编码 → 交付前自检**。
21 
22**阶段 1–4 各有「交接检查」，阶段 5 是交付闸，交付前那道最重。** 这不是"一道闸抓所有规则"——那会把闸撑到十几条，而检查清单一超过 9 条就开始被跳过（Gawande）。成熟做法是**多个停点各管各的**：飞机在滑行、起飞、巡航、落地有各自的清单，不是一张。所以本 skill 的判据是：
23 
24> **每条规则都必须被相应阶段的检查点抓住。** 不是每条都要进交付闸。
25 
26这个轴不是审美选择，是防膨胀装置。一份按主题堆叠的规则集会一直长——每收编一处沉淀就多几节，最后没人读得完，也没人知道新规则该放哪。所以：
27 
28**加一条新规则前，先回答：它在第几阶段被想起？它的违反被哪个检查点抓住？**
29 
30- **都答得上** → 写进那个阶段，正文里说清判据，并确认那个检查点的产物清单真的会暴露它。
31- **答得出阶段、答不出检查点** → 把它加进**那个阶段的交接检查**（阶段交接不受 9 条预算限制，因为它只在那一刻问一次）。只有当它必须在**交付前**再查一遍时，才动交付闸——而交付闸是 5–9 条 killer items 的预算，加一条得说清挤掉谁。
32**这条准入规则同样管存量。** 最容易漏的不是新规则——是**规则立起来那天已经在文件里的内容，没人回头用它筛一遍**（"祖父豁免"）。但也不能因此开一张无边界重构的许可证，所以判据是有范围的：**每次实质改动这份文件时，顺手对你本次已经打开的那一节做一次同样的核对**；不为找问题去打开本次不涉及的章节。
33 
34**写完之后必须机械核一次，别靠记性**——把新规则的关键词 grep 一遍，看它在**检查点文字**里出没出现。**0 命中 = 它没挂上任何检查点**，回到上面几条重新归位。
35 
36以下限定缺一不可：
37 
38- **范围要说死**：各阶段的「阶段 N 交接检查」引用块 + 交付闸的**编号条目正文、产物行、以及豁免表**。豁免表要搜，但**它的命中意义是相反的**——见下一条。
39- **>0 命中 ≠ 挂上，必须读那一处**。命中的可能是"这条闸在查这件事"（真挂上），也可能是"这条闸声明自己**不管**这件事"（豁免行）。**只在豁免行命中 = 反向证据**：它恰恰证明这条规则被明确排除在检查范围之外，等同 0 命中，要回去重新归位。
40…