让编码智能体复用设计系统排版组件
文章建议在编码指令中指明现有排版组件,并明确标题层级和组件变体的用法。智能体如果沿用页面里的原生标签和临时字号类,可能漏掉后续设计令牌更新,也可能写错标题层级。
AI 深度解读
AI 编程助手加一个「Preferences」小节标题,顺手写了 <h2 className="text-xl font-semibold">。页面看起来没问题,但项目已有 Heading 和 Text。等设计系统统一调整字号、字体或间距,这个标题就可能被漏掉。
作者的做法是,在提示词里给出排版组件的路径和用法,再在 PR 里检查新增文案有没有绕过它们。对前端团队来说,这条规则同时管两件事:样式能不能随设计系统一起更新,标题层级能不能反映页面结构。
为什么对齐了字号,标题还是会走样
排版规范(type scale)在代码里往往由组件来落实。原文里的 <Heading level={2}> 或 Text variant="title" 会按设计系统的定义应用字号、字重、间距和标题字体。手写的 text-xl font-semibold 即使今天看起来接近,也只是在当前页面单独指定了字号和字重。以后改设计 token,也就是组件共用的样式变量,这处写法可能还停在旧值。
作者观察到,模型很容易沿用附近的 JSX。页面原来就混用了几处裸标签,新加一个 h2 看起来甚至更符合这个文件的写法。问题还会出在语义上:本该是 h3 的子标题被写成 h2,或者为了做出大字用了 div,结果这个标题没进入页面的标题结构。选 level 时要看它在页面里的上下级关系,选样式时再看组件支持哪些 variant。
提示词里给组件路径,审查时看新增文案
作者要求标题、正文、说明文字和标签都走共享排版组件。下面这段提示词给出了组件入口、可选范围,以及模型遇到样式差异时容易走的几条岔路。
Use the existing typography components (Heading, Text — see src/components/typography) for titles and body copy.
Do not add a raw <h2> or <p> with ad-hoc size or weight classes.
Pick a level/variant from the existing scale. Do not override font-size on the component.
Do not invent a new Title or SectionHeader component.
第三行尤其关键。只要求「使用 Heading」,模型仍可能给它叠上 text-xl 或 font-bold,让当前页面继续单独控制字号和字重。仓库如果有 Heading 和 Text 的选用文档,作者建议把相关内容直接给模型,组件名字本身不足以说明适用场景。
审查时可以在 diff 里找新增的 <h1> 到 <h6>、<p className="text-,以及文案旁修改字号或字体的工具类。也要看新建的 PageTitle 是否把 Heading 的实现抄了一遍。设计系统未覆盖的邮件模板、法律文本快照可以保留裸标签,在 PR 里交代原因。确实缺少一种排版规格时,作者接受在共享组件内新增 variant,并配上 token 和 Storybook story。
我的判断
这套做法最有说服力的地方,是能顺着代码解释样式为什么会漏改。只在提示词里列字号表,模型仍需要在每个页面重新应用这些值。复用组件则把这项工作放回统一的实现里。作者给出的是日常编码观察和审查经验,原文没有对照实验,也没有说明提示词能减少多少违规写法。
落地前要确认组件确实覆盖当前场景,以及它最终渲染的标签符合语义。Text variant="title" 这个名字只说明它有标题样式,实际会不会渲染成标题元素要看实现。仓库如果已经有 lint,固定的标签和类名模式可以交给规则检查。标题层级是否合适、例外是否合理,仍需要结合页面和 PR 判断。
能拿来做什么
- 给 AI 派发 React 页面任务时,把排版组件的真实路径和
Heading、Text的选用说明一起贴进去,并要求从已有的level和variant里选。 - 审查 AI 生成的 JSX 时,沿新增文案检查裸标题、带字号类的段落和重复封装,再对照页面结构确认标题层级。
- 现有组件缺少所需规格时,在 PR 里说明这是局部例外还是共享需求。共享需求可以直接补到组件里,用 token 和 Storybook story 记录新规格。