Nine design languages · one gate九套设计语言 · 一道检查

Nine design languages.
And a gate that fails
what does not match.
九套设计语言。
外加一道会把不合格
产物打回来的检查。

Every design skill for a coding agent ships a prompt. This one ships the prompt and the thing that checks the prompt was obeyed. 给编程 agent 的设计 skill,别人发的是提示词。这个仓发的是提示词,加上检查提示词有没有被照做的那个东西。

GitHub See the pages看做完的页面

A page that looks fine 一个看着没问题的页面

The file below passes the structural check and passes the rendered visual audit. In a browser nothing about it looks wrong. 下面这个文件,结构检查过了,渲染视觉审计也过了。在浏览器里看不出哪里不对。

$ bin/design-review examples/looks-fine.html ━━ [1/5] verify.py (structural) design-review verify: OK — 1 file(s) passed (auto-detected skill) ━━ [2/5] visual-audit.mjs (rendered + brand + italic + smell) visual-audit: OK (examples/looks-fine.html) ━━ [3/5] axe-audit.mjs (accessibility · axe-core) axe-audit: 1 rule(s), 34 element(s) [error] color-contrast (serious) ×34 .anth-hero > .anth-container > p > .lang-en Element has insufficient color contrast of 2.31 (foreground #a8a69c, background #faf9f5, font size 14.3pt, weight normal). Expected 4.5:1 … and 33 more ✗ axe-audit found blocking violations — fix before continuing $ echo $? 1

The only edit separating that file from a canonical reference page is two colour values, nudged until they stop clearing 4.5:1. That is the case a prompt cannot catch and a person reviewing at speed will wave through. 它和一张合格样张的差别只有两个颜色值,调到刚好不满足 4.5:1 为止。这正是提示词管不住、人快速过一眼也会放过去的那一类。

The nine九套

Each is a complete design language: type scale, colour tokens, layout rhythm, motion, diagram conventions, and a reference library of finished pages the generator is measured against. Fifty-nine specimens in all, and every one of them passes the gate. 每一套都是完整的设计语言:字号阶梯、颜色 token、版面节奏、动效、图表画法,外加一批做好的参考页面,生成器拿它们当标尺。一共 59 张,全部能过检查链。

anthropic-design

Warm editorial暖色杂志感

Cream ground, serif body, orange accent, long-form rhythm.米色底、衬线正文、橙色重点、长文节奏。

10 reference pages张参考页

apple-design

Product minimalism产品式极简

White ground, SF type, statistics used as headlines.白底、SF 字体、数字当标题用。

10 reference pages张参考页

ember-design

Handcraft warmth手作感的暖

Cream, chocolate and gold, editorial with a maker's hand.米色、巧克力棕、金,带手工痕迹的编辑感。

10 reference pages张参考页

sage-design

Nordic quiet北欧的安静

Cream, sage green, deep indigo, generous whitespace.米色、鼠尾草绿、深靛,留白给得大方。

10 reference pages张参考页

atelier-design

Warm-glass product UI暖玻璃产品界面

The one skill that draws an application rather than a page, and it clicks.九套里唯一画应用本身而不是页面的,而且真的能点。

6 reference screens张参考界面

glass-design

Aurora glass极光玻璃

Deep navy, frosted panels, light and dark themes both measured.深藏青、磨砂面板,明暗两个主题都实测过。

4 reference pages张参考页

eclat-design

Launch keynote发布会

A matte cinematic stage, near-black with a single cool flare.哑光电影感舞台,近黑底加一道冷光。

3 reference pages张参考页

lectern-design

Boardroom briefing会议室简报

Paper white, serif headings, data before argument.纸白、衬线标题、数据放在论证前面。

3 reference pages张参考页

primer-design

Technical explainer技术图解

Diagrams carry the argument; prose fills the gaps between them.让图承载论证,文字只补图之间的缝。

3 reference pages张参考页

The tenth, which renders第十套:它做渲染

hardware-3d is the odd one here. The nine lay out a page; this one renders one — a hand-written WebGL2 engine in a single HTML file with no external dependencies, for explaining how a piece of hardware actually works. Park the camera and every frame re-jitters the sub-pixel offset, the aperture disk, the softbox area and the ambient-occlusion kernel, then averages. Two hundred samples later the soft shadows and the depth of field are sampled rather than approximated. hardware-3d 是这里的另类。那九套是排一张页面,这一套是渲染一张页面 —— 单个 HTML、零外部依赖、手写的 WebGL2 引擎,用来讲一块硬件到底是怎么工作的。相机一停,每帧重新抖动亚像素偏移、光圈盘、柔光箱面积和环境光遮蔽的采样核,然后平均。两百次采样之后,软阴影和景深是采出来的,不是近似出来的。

Data flow you can read看得懂的数据流

Inside the die画在 die 内部

A 64-bit word is a row of lit and dark cells, not a dot. A bus is 64 parallel wires, not one line. The path runs inside the die — logic blocks on the silicon, elevated copper rails above them, which is what the metal layers physically are.一个 64 位字画成一行亮暗格子,不是一个点。一条总线是 64 根并行导线,不是一条线。路径走在 die 内部 —— 逻辑块躺在硅上,架空的铜轨在它们上方,那正是金属互连层的物理样子。

Advances by clock ticks · pause · single-step按时钟拍推进 · 可暂停 · 可单步

Four checks of its own自带四道检查

A voice, measured把风格量出来

Self-contained, render pipeline, frame budget — and one that measures the look. On a normal page 0.4% of pixels are bright and saturated, median saturation 0.09. Tint the materials neon and those become 44.8% and 0.63, and the check refuses the page.自包含、渲染管线、帧时间 —— 外加一道量画面本身的。正常页面高亮高饱和像素占 0.4%、饱和度中位数 0.09;把材质染成霓虹青之后是 44.8% 和 0.63,检查当场拦下。

The counterpart of the design gate's brand check对应设计检查链里的品牌检查

Worked page做完的页面

DRAM cell → register内存颗粒 → 寄存器

Five stations: the board under studio light, a DRAM package close up, row-and-column addressing inside the die, 64 data lines across the board, and the queue through L3, L2 and L1 into a register.五站:棚拍下的整板、一颗 DRAM 封装的微距、颗粒内部的行列寻址、板上的 64 根数据线、以及穿过 L3 / L2 / L1 排队进寄存器的那一路。

Open it打开看看

Worked pages做完的页面

Twenty-six pages built with these skills and shipped through the gate. The diagram galleries carry a Copy SVG button on every figure, so a figure can be lifted straight into your own page. 用这些 skill 做完、并且过了检查链的 26 张页面。图例库里每张图都带一个 Copy SVG 按钮,可以直接抠去自己的页面里用。

Diagram galleries图例库

9

One per design language. Architecture, flow, hierarchy, timing waveforms, register bitfields, SoC blocks, call graphs, packet encapsulation.每套设计语言一份。架构、流程、层次、时序波形、寄存器位域、SoC 框图、调用图、封包分层。

anthropic · apple · glass · primer

Long-form technical技术长文

6

Full-length articles where the figures carry the argument rather than decorate it.完整长文,图是用来承载论证的,不是拿来装饰的。

How one bit is held一个比特是怎么被存住的 · How a chip is assembled一颗芯片怎么封装出来 · How a picture reaches a screen一张画面怎么到屏幕上

Technical explainers技术图解

10

Short primer-design pages on one mechanism each: address maps, interconnects, protocol layers, register decoding, scheduler timing.primer-design 的短页,一页讲一个机制:地址映射、互连拓扑、协议分层、寄存器解码、调度时序。

All ten看全部十张

What the gate checks那道检查查什么

Five checks run in order and stop at the first failure. 五道按顺序跑,第一道不过就停。

Check检查 What it decides它判什么
verify.py Structure: leftover placeholders, missing viewport, undefined classes, BEM modifiers without their base, unbalanced SVG, hero container width, hardcoded colours that already have a token.结构:占位符残留、缺 viewport、未定义的 class、BEM 修饰符缺基类、SVG 标签不配对、hero 容器宽度、已经有 token 却写死的颜色。
visual-audit.mjs The rendered page: contrast, brand presence, diagram label sizes, orphan cards, SVG text legibility, and colour borrowed from another skill's palette.渲染后的页面:对比度、品牌存在感、图表标签字号、孤立卡片、SVG 文字可读性、以及借用了别家调色板的颜色。
axe-audit.mjs Accessibility, via axe-core. Four rules block: color-contrast, link-name, aria-prohibited-attr, svg-img-alt.可访问性,走 axe-core。四条规则阻断:color-contrast、link-name、aria-prohibited-attr、svg-img-alt。
interaction-audit.mjs The states a click reaches: console errors, axe violations that appear only after a click, dead controls, broken in-page anchors, and content revealed onto other content. Every other check judges the first painted frame.点开之后才存在的状态:控制台报错、点击之后才出现的 axe 违规、死控件、断锚点、新露出来压住别的内容。其余每一道判的都是同一个静止画面。
screenshot.mjs A full-page PNG, for the part a person still has to look at.整页 PNG,留给人眼那一部分。

A sixth is opt-in: --pixel compares rendered pixels against a committed baseline. It stays opt-in because an intentional redesign trips it as readily as a regression does. 第六道是选配:--pixel 拿渲染像素跟提交过的基线比。它一直是选配,因为有意的改版和真正的回退一样会让它报错。

What it refuses to judge它不判什么

The gate answers one question: does this page obey the design language it claims to be written in. It says nothing about whether the page is any good, whether the content is correct, or whether a reader will follow the argument. Clearing every check is compatible with the page being worth throwing away. 这道检查只回答一个问题:这一页有没有照着它声称的那套设计语言写。它不回答页面好不好、内容对不对、读者能不能跟上论证。全部检查通过,和这一页该扔掉,两件事可以同时成立。

Contrast ratios, class definitions and label sizes have numeric answers. Whether a layout earns its whitespace does not, and the attempts to mechanise it in earlier rounds produced false positives at a rate that made the check useless. That half is handed to six critic agents, and to a person. 对比度、class 有没有定义、标签多大,这些有数值答案。版面留白是否用得其所没有,早几轮试着把它机械化,误报率高到那条检查没法用。那一半交给六个评审 agent,以及交给人。

How it stops repeating mistakes它怎么做到不重复犯错

Every defect a reviewer catches becomes a row in the known-bugs catalogue, plus a new mechanical check wherever the defect can be detected by machine. 评审员每抓到一个毛病,就变成 known-bugs 目录里的一行;只要机器能判,同时再加一条新检查。

9
design languages套设计语言
59
reference specimens张参考样张
93
catalogued defects条已收录的毛病
6
critic agents个评审 agent