基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-21 20:54

让编码智能体复用设计系统排版组件

dev.to · AI#设计系统#编码智能体#语义化
Editor brief · 编辑速览

文章建议在编码指令中指明现有排版组件,并明确标题层级和组件变体的用法。智能体如果沿用页面里的原生标签和临时字号类,可能漏掉后续设计令牌更新,也可能写错标题层级。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 记录新规格。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
用 CI 检查编码智能体有没有漏掉需求
下一篇
GPT-6.2 Sol 编程跑分接近 Astra

资讯速览

dev.to · AI · 2026-11-21 20:54

AI 评分 8.0 / 10

相关标签

#设计系统#编码智能体#语义化

继续阅读

  • 用 Claude Code Hooks 拦住反复踩的坑
  • 用 CI 检查编码智能体有没有漏掉需求
  • GPT-6.2 Sol 编程跑分接近 Astra
  • 开源数据集收录 66 条编程智能体实战轨迹
  • 在无头模式下复测 Claude Code 指令冲突