对大型企业来说，设计系统（Design System）的组件规格文档，往往是最难维护的一环。每当UI组件设计更新，相关文档也必须同步更新，否则工程师容易依赖经验猜测组件在不同状态下的行为，最终导致UI不一致或积累技术债务。

为解决这个问题，Uber最近打造了一款AI代理（AI Agent）工具uSpec，可通过MCP直接读取Figma设计文件，自动生成组件规格文档，将原本可能需要数周完成的文档整理工作缩短至几分钟。

一个按钮背后，其实需要维护大量文档

在设计系统中，一个看似简单的UI组件，背后其实需要维护大量文档。以最常见的按钮（Button）为例，一份完整的规格不仅描述外观，还包含组件结构、可配置参数、不同状态、变体、颜色Token和尺寸规则等。

更复杂的是无障碍设计，同一个组件还需明确说明如何在iOS、Android和网页端正确适配辅助功能，使其能被VoiceOver、TalkBack和ARIA等机制正确识别与朗读。

但这还只是“一个”组件。Uber指出，他们的设计系统包含数百个组件，每个组件通常需对应七种技术平台的实现，例如UIKit、SwiftUI、Android XML、Android Compose、React Web等。换句话说，同一个组件的规格文档，往往需同时涵盖多个平台的实现方式。

只要组件设计更新，相关文档就必须同步修改。长期下来，文档维护自然成为一项庞大的工程。

AI代理直接读取Figma设计文件，自动生成规格

为减轻人工整理文档的负担，Uber设计系统团队开发了uSpec工具。

它的使用方式非常简单：设计师只需在AI开发工具Cursor IDE中粘贴一个Figma组件链接，并补充一些背景信息，例如组件状态或平台行为，AI代理就会通过Figma Console MCP连接到Figma设计文件，读取组件结构、设计Token和变体设置，再根据模板自动生成完整的规格页面，并直接写回Figma。

也就是说，AI可以在一次流程中完成从读取设计到生成文档的全部工作。

MCP让AI代理直接操作设计工具

这套系统之所以能运行，关键在于Figma Console MCP——即AI代理与Figma之间的桥梁。它能让AI代理直接读取Figma中的组件结构、样式和变量，并将生成结果写回文件，例如生成表格或标注组件结构，而不仅仅是查看设计稿的截图。

Uber表示，这套工具的整个流程都在本地环境执行。例如，AI代理在本地的Cursor IDE中运行，并通过本地WebSocket连接Figma桌面端，因此设计数据不会离开企业内网，确保数据隐私与安全。

就效果而言，Uber以最复杂的无障碍规格为例，该工具仅需两分钟，即可生成涵盖iOS、Android和网页三个平台的配置规格文档。

对Uber而言，这一应用反映了AI代理工具的新方向：AI不再只是生成文字或代码，而是开始直接操作企业级软件工具。通过MCP这样的桥接层，AI能够读取工具内部数据并执行实际操作，例如更新设计文档或整理项目资料。

他们透露，接下来还将探索更多自动化功能，例如自动比对组件设计与规格文档、检测文档是否过时，或从代码反向生成规格文档。