在 Cursor 中
使用 DESIGN.md

把 ZIP 交给 Cursor,使用设计规范、Tailwind、CSS 和设计 Token,对照原始网站完成页面。

先准备一个可运行的项目

用 Cursor 打开你准备修改的项目文件夹,先按项目已有的说明启动页面。确认当前页面能够打开,再加入设计规范;这样发生问题时,容易区分是项目本身还是本次修改造成的。

这篇以 Vercel 设计规范和一个开发者作品集首页为例。你可以换成其他模板,保留相同的操作顺序。还没选好时,先到模板目录找一份喜欢的风格。

让 Agent 处理 ZIP

下载 ZIP 后,将压缩文件或它的完整本地路径提供给 Agent,由它在当前项目内创建参考目录、解压并定位设计文件。你无需手动解压、创建目录或逐个搬运文件。下面是 Agent 处理后应得到的目录示意,六个文件保留原名:

my-project/
  design-reference/
    vercel/
      AGENT.md
      DESIGN-compact.md
      DESIGN.md
      tailwind-v4.css
      variables.css
      design-tokens.json

AGENT.md 是这份模板的使用说明。本文会明确让 Agent 读取它,不需要把它改名为 AGENTS.md,也不用覆盖项目原有的规则。六个文件的分工可查看文件用途指南。

让 Cursor 读取文件与原始网站

下一节提供了可以一次复制的完整任务。将 ZIP 路径和页面需求填好后发给 Cursor,让 Agent 解压并读取六份文件,再打开原始网站核对。

解压完成后,如需显式引用文件,可在对话输入框中输入 @,搜索并选择文件,核对完整路径。Cursor 的官方文件引用说明介绍了这种引用方式。

要求 Agent 报告实际读取的文件、采用的参数及定义位置、参考的网址与观察结果。无法读取或核对的部分要明确说明,不能只回答“已经读过”,也不能凭品牌印象猜测。

给第一版页面一个具体任务

点击“复制提示词”,替换 ZIP 路径和页面需求后发给 Cursor。可以把需求写成:实现一个开发者作品集首页,包括姓名与介绍、三个项目、关于我和联系入口。整段任务包含从 ZIP 到页面验收的完整步骤。

开始使用的完整提示词

ZIP 文件:<填写 ZIP 文件的完整本地路径>
页面需求:<填写要实现的页面、文案和功能>

请在当前项目中完成以下任务:

1. 由你检查 ZIP 的目录结构,在项目内建立独立的设计参考目录,
   解压并定位文件。保留原 ZIP 和已有项目文件;有同名内容时先说明,
   不直接覆盖,也不要要求我手动解压或逐个搬运文件。

2. 读取解压后的全部六份文件:
   AGENT.md
   DESIGN-compact.md
   DESIGN.md
   tailwind-v4.css
   variables.css
   design-tokens.json
   按 AGENT.md 的说明和阅读顺序理解设计规范。

3. 打开 AGENT.md 中 Original website 对应的原始网站,
   实际观察布局、颜色比例、字体层级、间距与组件表现。
   不要只凭品牌印象或自己的记忆设计。

4. 必须读取并使用 Tailwind、CSS 和设计 Token 中已有的真实定义,
   包括颜色、字体、间距、圆角与组件参数,列出采用值的来源位置。
   三份文件都要读取,再根据现有技术栈和版本选择接入方式,
   不把样式不加检查地覆盖到全局,也不自行编造参数。

5. 先检查当前项目的技术栈、页面入口、项目规则与公共组件,
   再按上方需求实现或修改指定页面。保留无关页面、已有功能和数据,
   不扩展到本次需求之外的账号、后台或支付功能。

6. 打开实际页面,对照原始网站和设计文件检查桌面与手机布局,
   检查文字、按钮、链接、组件一致性及是否出现横向溢出。
   完成后报告修改的文件、启动与打开方式、参考网址、参数来源、
   实际执行的检查及结果。

如果 ZIP 路径、文件、参数、字体或原始网站无法读取或核对,
请明确说明缺少什么、需要我确认什么;不要猜测或声称已经检查。

复制后替换 ZIP 路径和页面需求,再发给 Agent。

读取三份文件是所有项目的共同步骤,接入方式则取决于已有技术栈:Tailwind 项目确认版本后使用相应样式定义;普通 CSS 项目应用 CSS 变量;设计 Token 用于核对和应用其中已有的参数。不要把两份样式不加检查地同时覆盖到全局。

打开页面,检查并修正

在浏览器打开 Agent 给出的页面地址,同时打开 AGENT.md 记录的原始网站,并对照三份样式与参数文件。先检查这些能直接观察到的地方:

发现问题时,复制下面的修正任务,填写具体位置和问题,例如“手机端项目卡片标题被截断,卡片之间的间距不一致”。提示词可在当前或新的对话中独立使用:

修正页面的完整提示词

ZIP 文件:<填写 ZIP 文件的完整本地路径>
页面需求:<填写需要修正的页面、具体位置和问题>

本轮只修正上面列出的问题,保留已经确认的内容和其他页面。
如果当前项目已有这份 ZIP 的解压目录,先定位并复用,不重复覆盖。

请在当前项目中完成以下任务:

1. 由你检查 ZIP 的目录结构,在项目内建立独立的设计参考目录,
   解压并定位文件。保留原 ZIP 和已有项目文件;有同名内容时先说明,
   不直接覆盖,也不要要求我手动解压或逐个搬运文件。

2. 读取解压后的全部六份文件:
   AGENT.md
   DESIGN-compact.md
   DESIGN.md
   tailwind-v4.css
   variables.css
   design-tokens.json
   按 AGENT.md 的说明和阅读顺序理解设计规范。

3. 打开 AGENT.md 中 Original website 对应的原始网站,
   实际观察布局、颜色比例、字体层级、间距与组件表现。
   不要只凭品牌印象或自己的记忆设计。

4. 必须读取并使用 Tailwind、CSS 和设计 Token 中已有的真实定义,
   包括颜色、字体、间距、圆角与组件参数,列出采用值的来源位置。
   三份文件都要读取,再根据现有技术栈和版本选择接入方式,
   不把样式不加检查地覆盖到全局,也不自行编造参数。

5. 先检查当前项目的技术栈、页面入口、项目规则与公共组件,
   再按上方需求实现或修改指定页面。保留无关页面、已有功能和数据,
   不扩展到本次需求之外的账号、后台或支付功能。

6. 打开实际页面,对照原始网站和设计文件检查桌面与手机布局,
   检查文字、按钮、链接、组件一致性及是否出现横向溢出。
   完成后报告修改的文件、启动与打开方式、参考网址、参数来源、
   实际执行的检查及结果。

如果 ZIP 路径、文件、参数、字体或原始网站无法读取或核对,
请明确说明缺少什么、需要我确认什么;不要猜测或声称已经检查。

复制后替换 ZIP 路径,并写清需要修正的页面、位置和问题。

把这套方法用于下一页

使用另一份模板时,同样把新 ZIP 交给 Agent 处理。第一张页面确认后,再把已经采用的文字层级、间距和组件样式复用到下一页。开始新对话时,重新提供设计文件路径和本次页面任务,避免只说“沿用之前的风格”。

想先比较不同规范的视觉表达,可以查看同一份需求的三种自制页面示例;准备使用本篇的参考风格,可查看Vercel 设计规范。

本文以显式文件引用为主。如果你之后需要配置项目级规则,再参考 Cursor 的Rules 文档,按项目情况处理。