说明

什么是 DESIGN.md?

DESIGN.md 是一种 Markdown 形式的设计契约,帮助 AI coding agent 在写前端 UI 前理解真实视觉系统。它描述颜色、字体、间距、布局节奏、组件、交互行为、示例和非目标。

一个有用的 DESIGN.md 要足够短,方便阅读;也要足够结构化,方便解析;还要足够具体,避免生成出来的 UI 变成千篇一律的 SaaS 模板。

AwsomeDesign 提供真实公共案例,也可以从你提交的网站中提取品牌信号,生成私有且可落地的 DESIGN.md。

coding agent 如何使用 DESIGN.md

Agent 会把 DESIGN.md 当作实现前的设计事实来源。文件会给出 token、组件规则、布局限制和视觉边界,让多次 UI 任务都能沿用同一套品牌判断。

对团队来说,价值在于可复用:同一份设计契约可以指导落地页、后台、表单流程或重构任务,而不需要每次重新解释品牌。

DESIGN.md 与 README、design tokens 的区别

README 解释项目如何运行,design tokens 列出颜色和间距等原子值。DESIGN.md 把这些信息转成产品判断:什么时候使用某个 token,组件应该有什么气质,以及哪些视觉动作不能做。

FAQ

什么是 DESIGN.md?

DESIGN.md 是一种 Markdown 设计契约,帮助 AI coding agent 在构建前端 UI 时遵循真实视觉系统。

DESIGN.md 和 design tokens 有什么不同?

design tokens 定义原始数值;DESIGN.md 解释这些数值如何应用到布局、字体、组件、交互和产品限制中。

谁适合使用 DESIGN.md?

DESIGN.md 适合开发者、设计师、产品团队,以及需要稳定前端实现指引的 AI coding agent。