给编码Agent设定间距令牌约束
AI根据截图生成布局时,容易写入大量偏离设计规范的像素值,造成组件间距逐渐失控。文章建议在提示词中提供现有间距刻度,并将新增刻度作为明确的设计令牌变更审查。
AI 深度解读
AI 把工具栏排齐了,却留下 mt-[13px]、gap-[18px]、p-[22px]。单看页面可能没问题,但项目已有间距体系,后续 Agent 再各自补几个数字,组件之间就会越来越难统一。
作者给出的办法很直接:把任意间距当作草稿,先映射到已有刻度,确有必要再提议新增 token。这篇没有性能跑分或团队对照实验,它的价值是一套能放进提示词和代码审查的布局约束。
看起来精确的间距,为什么会增加维护成本
模型照着截图或 Figma 写布局时,很容易把像素值直接搬进 CSS。18px 看起来比某个现有刻度更精确,却绕开了项目用于统一排版、卡片和表单行的间距规则。
问题往往出在累积上。同类位置逐渐出现 12px、13px、14px,以后想整体收紧页面,就要逐个判断这些差异究竟是设计要求,还是生成时的临时选择。
作者认为,一组略有偏差但统一的 token,比一堆接近却不一致的值更容易调整。这里的 token,就是有名字、可复用的设计值,例如 --space-2、--space-3、--space-4,或团队已经采用的 Tailwind 间距刻度。
视觉上合适的数字,可以作为候选值,但不能自动成为设计规范。
因此,审查 18px 时,先问它应当归入哪个现有刻度,再讨论间距体系是否真的缺了一档。
怎样让 Agent 从一开始就遵守刻度
作者的规则覆盖 margin、padding 和 gap:都使用已有间距体系;业务样式不加入任意像素值;新增刻度必须作为有名称、有文档的 token 变更处理。
这也限制了另一种做法:为了让一个页面看起来更齐,反复微调局部数值,却让它逐渐脱离整个应用的规则。
下面这段提示词把约束和遇到冲突时的处理方式一起交给 Agent:
Use the existing spacing scale only (space-1 through space-8 / the standard Tailwind spacing steps we already use).
Do not add arbitrary pixel margin, padding, or gap values.
If a screenshot uses 18px and the nearest step is 16px, use the step and note the difference.
If you believe a new step is required, propose the token; do not invent a magic value in this file.
重点看第三行:截图是 18px,最近刻度是 16px,就先采用 16px,同时说明差异。它给了模型一条明确的执行路径,避免模型为了还原截图自行突破规则。
实际使用时,还应按作者的建议,把项目真实的间距表贴进提示词。只写「遵守现有规范」,却不提供规范内容,模型仍然可能猜错。
代码审查则搜索 diff 中的 [Npx] 形式、margin 和 padding 中直接写入的 px,以及没有使用 CSS 变量或刻度工具类的间距字面量。
作者还把「只有一个工具栏使用的新 spacing token」列为警示项。给魔法数字起个名字,并不足以证明这档间距有必要存在。更合理的结果,是布局复用已有值,或通过专门的 token PR 说明新增刻度,并在新布局中使用。
我的判断
我赞同把这套规则作为 AI 布局的默认约束。它把审查重点从「这一屏是否刚好对齐」拉回「这次修改是否遵守项目规则」,也让后续 Agent 有稳定的参照。
但它成立的前提,是现有间距体系足够可用。原文没有解释刻度不完整时如何决策,也没有给出减少返工、降低样式数量的对照数据。因此,「统一刻度更容易维护」在这里属于作者的经验判断,不能包装成已经验证的效率收益。
和逐处追求截图像素一致相比,这种做法优先保证全局一致性。对已有设计体系的项目,这个取舍很合理;如果某处确有特殊布局要求,就需要把理由带回 token 设计讨论。原文保留了新增刻度的入口,但没有给出判断新增是否合理的具体标准。
能拿来做什么
- 给前端布局任务附上项目实际使用的 CSS 间距变量或 Tailwind 刻度,并明确截图数值与刻度冲突时采用哪一方。
- 审查 AI 生成的 diff 时,集中检查 margin、padding、gap 的任意值,要求说明它们为何不能映射到现有刻度。
- 遇到确实需要的新间距,把它整理为有名称、有文档的 token 变更,并检查它是否只是单个组件的一次性微调。