我们的代理如何利用design.md构建品牌页面
内容提要
Vercel团队开发了design.md，一个公开文件，让AI代理在外部工具中也能生成符合Vercel风格的设计。他们通过七种场景评估、样式表和反馈循环，将设计判断编码为规则，减少生成页面的常见错误。测试显示，使用该文件后已知故障减少57%，并持续通过实际使用和每周反馈更新。
延伸解读
从“描述风格”到“编码规则”
文章指出，单纯用自然语言描述视觉风格（如“保持布局干净”）会导致不同模型产生截然不同的页面。Vercel的解决方案是将设计判断转化为可验证的规则，并配合公开的样式表，把字体、间距等决策从模型中剥离，从而减少歧义。这提示我们，给AI的指令越具体、越可操作，输出的一致性就越高。
评估循环是质量的关键
Vercel通过七个固定场景和盲测A/B比较，持续迭代design.md。每个修正都落在最合适的位置：判断进文档、机制进样式表、可自动化的进代码检查。这种“反馈-编码-再验证”的循环，使得已知故障减少57%。但文章也强调，样本量小且仍有严重问题，说明评估循环的价值在于防止已知错误复发，而非保证整体设计质量。
可复制的实践方法
文章末尾给出了构建类似系统的步骤：从单一重复性任务开始，保存基线输出，收集最近十次修正并转化为可观察的规则，发布样式表约束机械性设计，然后进行对照测试。这种方法不依赖复杂工具，适合团队逐步引入。关键是要持续收集反馈并监控特定类型投诉是否减少，否则规则可能无效。
Q&A
什么是design.md？
design.md是Vercel团队创建的一个公开文件，用于指导AI代理在外部工具中生成符合Vercel风格的设计。它包含设计指南、样式表和评估循环，帮助代理理解品牌、布局、文案等设计原则。
Vercel团队为什么需要design.md？
因为Vercel团队使用编码代理在外部工具中生成页面，这些工具无法访问代码库中的设计系统文件。design.md提供了一个单一的公开URL，让任何代理都能加载并遵循Vercel的设计规范，确保生成的页面符合品牌风格。
design.md由哪三个部分组成？
design.md由三个部分组成：1) design.md文件本身，提供设计指南；2) 公开样式表，定义可用的CSS类和令牌；3) 评估循环，通过反馈和确定性检查不断改进指南。
Vercel团队如何测试design.md的效果？
他们使用七个固定的评估场景（如续订提案、性能报告等），在相同条件下生成页面，对比有无design.md的输出。通过人工审查和确定性检查，他们发现使用design.md后已知故障减少了57%。
design.md如何保持更新？
通过实际使用和每周反馈循环。团队在Slack中使用@design-agent代理，收集真实请求和反馈，每周汇总并分析重复出现的抱怨，将其转化为规则或检查，并持续更新design.md。
如何构建自己的design.md？
步骤包括：1) 选择一个重复出现的工件；2) 保存基线输出；3) 从最近十次修正中提取可观察的规则；4) 将可重复的机制放入样式表；5) 运行一次匹配比较；6) 编码修正。之后可以添加工具和自动化，但保持人工审查。
