利用人工智能代理让设计师直接将组件部署到生产环境
一个网页团队如何终结重复开发循环:设计师与智能代理在生产库中编写代码,工程师审核相关协议,原本需要一周的工作量缩短至一小时。
来源: Design engineering at Bolt: shipping components with AI agents
某打车公司的公共网络平台每年在五十多个市场覆盖数千万用户。该平台依托于包含一百一十多种UI组件的共享设计系统。前端团队改变了这些组件的创建方式:在AI编程工具的帮助下,设计师们可以直接将可运行的代码放入生产环境库中,原本需要大约一周的时间现在缩短到了约一小时。有趣的是速度本身并非重点,关键在于团队为了实现这一目标放弃了什么,以及选择了保留什么。
设计文件无法填补的差距
自动布局、悬停状态、焦点顺序以及文本方向都能在 Figma 文件中实现。但浏览器需要处理的每种情况并非如此。传统上,工程师们负责补充其余部分:组件 API、键盘操作模型以及屏幕阅读器会读取的内容。然而,没人记录过在过程中哪些决策是从设计师悄悄传递给了工程师的。
编码助手减少了大部分这样的转换工作。现在,设计师可以与助手协作,创建出真正可运行的组件,这样一来,其他人的任务就变成了审查组件,而非再次编写它。
同一个组件为何被构建了两次
团队中的设计师们并未止步于 Figma,虽然他们仍会从那里开始探索、定义组件所需的标记及状态。接下来的步骤并非简单交接任务,而是打开编码工具,在内部的 Storybook 中构建该组件,让每种状态都能独立显示。编码工具生成版本后,设计师们会在不同主题、宽度及文本方向下检查它,指出存在的问题,随后编码工具再对其进行修改。
最终得到的是一个真正的组件,而非仅是它的示意图。它能正常编译,能在真实浏览器中响应操作,其各种状态也可以被逐一点击查看。
但工作到此就停止了。该组件仍存在于那个遵循自身规则的内部 Storybook 中,而生产环境则使用完全不同的库来构建。结果就是出现了两个 Storybook,各自都是信息的来源,仅通过工单相互关联。
两种真实数据源逐渐出现分歧。某个地方的间距标记发生了变化,而另一个地方却没有。深色模式或从右到左的显示方式仅存在于其中一侧。设计师们已经决定了悬停状态与键盘聚焦状态的差异,以及较长的德语标签应如何换行,而工程师们则依据在这些检查完成之前就拟定的任务单进行开发。同一个组件的两个“真实”版本慢慢变成了两件完全不同的东西。
于是工程师们拿起那份任务单,根据对已有且可运行功能的文字描述,在生产库中重新构建了这个组件。在项目看板上,这两种构建方式看起来都像是普通的工作内容,似乎没有任何问题。
那第二次构建看似是在履行必要流程,但实际上并非如此。设计师们早已拥有一个可用的版本,工程师们只是重新输入它,以便将其放入生产环境实际使用的代码库中。保留两个Storybooks必然会导致差异出现,这是该架构的固有特性,并非纪律松懈所致。
采用新的职位头衔或工具从来都不是动机。整个流程仍然基于预先提供的图片来设计,而设计师们早已离开了那个工作环境。重新输入代码只会浪费精力,两个Storybooks则必然导致差异,而且整个生命周期都假定实现环节是速度最慢的步骤。有了自动化工具后,输入工作变得迅速,因此延迟便转移到了相关环节以及中间的重新构建阶段。
在新的流程中,旧图表中的两个琥珀色阶段——即重复编写的同一组件——被合并为一个。设计师只需在生产库中编写一次即可。审核范围也扩大了,现在由两名工程师与设计师共同确认视觉效果,而之前是由一名工程师手动查看差异。审核工作的增加幅度小于实现工作的减少幅度,这一差距正是节省出的时间。对于符合设计系统的常规组件,其开发时间可从数周缩短至数小时。
从重复制作到评估判断
设计师交付的图片让工程师只需完成一项工作:将其复现。而已编写的代码则无需复现,因此剩下的问题就是该组件是否正确。它的 API 是否与库中的其他部分兼容?其语义是否能被屏幕阅读器理解?在所有断点以及两种文本方向下表现是否良好?这个问题一直都很重要,但过去总是在编码工作完成后才被考虑。现在它则被放在首位,而且由于审查对象已经是现成的代码,所需的质量标准也降低了。
实际发生了什么变化
这里所说的设计工程意味着对同一成果的共同负责。设计师可以将组件放入代码仓库,而工程师则负责 API 和架构设计。双方不再只是互相传递描述,而是直接共同开发该组件本身。
这种工作模式不需要新的工具或头衔,只需能够访问正确的代码库即可。设计师们现在可以直接在为公共页面提供支持的组件库中进行开发,使用他们已经熟悉的 agent 和 Storybook 工作流程。他们迭代优化的内容最终会直接上线。
只有当 agent 的输出结果安全可审时,这种方式才能发挥作用,因此团队将相关要求写入了 AGENTS.md 文件。该文件中的说明为组件库设定了质量标准:
- 重用现有的标记符。
- 在可访问的原始组件基础上进行扩展。
- 为每个有实际意义的变体编写测试用例。
- 不得修改无关代码。
该文件还明确了界限,将公共部分与内部代码以及那些不应存在于组件库中的内容区分开来。
这些规则的存在是为了保护该库作为产品。公共 API 会保持原样,除非有意进行破坏性变更、既定规范优于新方案,且每次变更都足够小以便能够放心审查。目标不仅仅是让代码能够运行,更是让所有依赖它的团队都能预测其行为。
另一项配套技能负责确定工作顺序。在基于 Figma 布局开始工作之前,操作员会先检查该组件或交互功能是否已存在,判断其应是公开还是内部使用,然后再构建相关流程并验证结果。该布局起到视觉规范的作用,既不是用于复制像素值的来源,也不是创造 API 的借口。
通过这些指导原则、约束条件以及工作流程,操作员能够获得足够的背景信息和结构指导,从而创建出适合放入该库的组件。
评审流程
设计师提交拉取请求,CI与Chromatic开始运行,随后设计师确认视觉上的改动。接着有两名工程师负责审查API、无障碍功能及架构,最后设计师完成合并操作。
评审工作按不同角色的职责划分:
- 设计师负责视觉准确性、标记符号、动画效果及状态,所有内容均在视觉评审环节确认。
- 两名工程师则负责组件API、无障碍语义、架构设计及测试覆盖率。
出于实际考虑,视觉评审由设计师而非工程师负责。他们可以在改动出现的地方直接确认,无需查看差异对比,也无需让工程师代为查看截图。
修改前后
旧的流程会在内部的Storybook中生成一个可用的组件,再创建一个任务,随后在正式发布的库中添加第二个组件。视觉效果的审核要么凭记忆进行,要么由工程师通过查看截图来完成。
在新的流程中,设计师在构建实际网站的同一库中进行工作,在Chromatic中确认像素效果,然后由两名工程师负责审查设计规范。当某个组件已经符合系统要求时,从可运行的原型到最终合并的代码更改仍需要数小时时间,整个过程全是审核环节。
团队所承受的成本
最大的风险就是那种显而易见的风险。设计师与开发人员合作时,可能会做出表面上看似正确但实际上有问题的结果:与整个库不兼容的API、没有可访问名称的控制元素,或是只采用最简单路径实现的逻辑。写入权限意味着这样的组件确实可以被合并进代码库。正因如此,接口规范由两名工程师负责,而视觉设计则由设计师负责,这样就不会有人假装要审核所有内容。
合并关卡本身并不要求“两名工程师”的参与。GitHub只要收到任何拥有写入权限的人的两次批准即可,因此这种配对方式只是审核机制中的惯例。一旦这个惯例被打破,风险就会再次出现。
现在故意将审核设为瓶颈——如果那两名审核者动作迟缓,浪费依然存在,并不会消失。
设计师还必须在本地运行该代码库。设置过程确实存在诸多障碍,目前唯一的解决办法就是提供贡献指南并安排一次一对一指导。
最后,这种方案仅适用于符合系统要求的组件。在智能体能够模仿之前,必须先由有人将真正全新的模式添加到库中。那些具有复杂状态、可中断的动画或特殊语义的组件,仍然需要工程师亲自编写,而不仅仅是事后进行审核。
对其他团队的启示
- 每个UI组件只需构建一次。一旦设计师能够生成符合系统要求的可运行代码,接下来就应该进行审查。
- 保持一个统一的共享组件库。同时使用多个Storybook工具以及通过工单传递代码会导致差异,因此设计师所构建的组件应当就是最终发布的版本。