SOP de Design Frontend com IA
jimmyhu95/ai-frontend-design-sop
Workflow engenheirado: referência → design specs → UI code → Vue 3 project
Ver no GitHubFluxo de engenharia para transformar referências visuais em UI com IA (Stitch/Claude Design), exportar para Figma e entregar como projeto Vue 3 + Vite. Padroniza o processo com 4 documentos (DESIGN.md, FEATURE_SPEC.md, INTERACTION_RULES.md, HTML_OUTPUT_CONTRACT.md) para alinhamento entre produto, design e eng.
Instalação
npx convez-ai jimmyhu95/ai-frontend-design-sop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar UI de alta fidelidade a partir de capturas de tela ou referências web
- Padronizar specs de design entre equipes (produto, design, frontend)
- Converter HTML/Tailwind em projetos Vue 3 + Vite com agents de código
- Exportar UI gerada para Figma como ativo reutilizável
Veredito

SOP sólido para teams que querem industrializar o fluxo design-to-code com IA, evitando fragmentação de specs e retrabalho entre agentes. Melhor para contextos estruturados (dashboards, painéis admin) que precisam de alinhamento disciplinado.
README
A tradução para o português deste README ainda está na fila.
AI 前端设计工程化 SOP
把“参考页面 + 业务需求 + AI 生成 UI + Figma 设计资产 + Vue 工程落地”沉淀成一套可复用、可检查、可交接的前端设计 SOP。
这不是一个提示词合集,也不是替代设计师或前端工程师的自动化工具。它是一套工程化工作流:先让 AI 读懂视觉规范、业务规则和交互规则,再用 Stitch、Claude Design 或同类工具生成 HTML / Tailwind / 前端 UI 代码;团队需要沉淀设计资产时,再把产物转成 Figma 设计稿;最后交给 Codex、Cursor、Claude Code 等工程 Agent 转成 Vue 3 + Vite 前端工程。
一句话理解这套流程:
四份规范 = 需求书 + 设计规则
Stitch / Claude Design 产物 = 高保真样板间
Figma = 团队设计资产
Vue 工程 = 真正进入项目的工程文件
适用场景
- 业务系统、后台管理台、SaaS 控制台、运营工具等信息密度较高的页面设计。
- 已有参考页面截图或网页链接,希望快速形成可复用的设计规范。
- 产品、前端、AI 工程实践者希望用统一模板协作,而不是每次从零写 prompt。
- 需要把 AI 生成的页面快速转成 Figma 设计文件,再由人工继续调整。
- 希望把 UI 代码进一步落成 Vue 3 + Vite 工程,而不是停留在单页 HTML 原型。
核心流程
参考页面截图或链接
-> DESIGN.md 设计规范
-> FEATURE_SPEC.md 业务功能规格
-> INTERACTION_RULES.md 交互规则
-> HTML_OUTPUT_CONTRACT.md HTML 输出契约
-> Stitch / Claude Design 生成并精修 UI
-> HTML / Tailwind / 前端 UI 代码 / DESIGN.md
-> 可选:HTML-to-Figma 或 Figma MCP 转成设计稿
-> Codex / Cursor / Claude Code
-> Vue 3 + Vite 工程文件
-> 接接口、状态管理、路由、权限、测试
两条轨道
工程实现轨:规范 -> Stitch / Claude Design -> UI 代码 -> Coding Agent -> Vue 3 + Vite 工程
设计资产轨:规范 -> Stitch / Claude Design -> Figma -> 评审 / 精修 / 组件库 / 设计系统
Figma 是推荐的团队工程化节点,但不是单人快速验证时的强制步骤。个人探索可以先跳过 Figma,直接把 Stitch 或 Claude Design 导出的 UI 代码交给 Coding Agent;团队协作、设计评审、组件沉淀和长期维护时,建议进入 Figma。
5 分钟快速开始
- 准备一个目标页面截图或网页链接,明确你想借鉴的是视觉语言、布局密度、组件风格,还是完整交互模式。
- 复制 templates/DESIGN.md,让大模型从参考页面中提取设计规范。
- 复制 templates/FEATURE_SPEC.md,补齐你的真实业务目标、页面对象、字段、操作和权限。
- 复制 templates/INTERACTION_RULES.md,定义页面状态、操作流、反馈、异常和响应式行为。
- 复制 templates/HTML_OUTPUT_CONTRACT.md,约束 Stitch、Claude Design 或其他模型生成可预览、可导入、可交接的 UI 代码。
- 在 Stitch 或 Claude Design 中生成并手工精修页面,导出 HTML / Tailwind / 前端 UI 代码 /
DESIGN.md。 - 如果需要团队设计资产,使用 Chrome 浏览器 html.to.design 插件、Figma 官方能力、Axhub 或 Codex App 里的 Figma MCP 把 HTML 转成 Figma 设计稿。
- 把“最终设计包”交给 Codex / Cursor / Claude Code:四份规范 + Stitch / Claude Design 导出的 HTML / Tailwind / UI 代码 + 可选 Figma 设计稿,按真实项目规范转成 Vue 3 + Vite 工程文件。
- 按 checklists/quality-gate.md 检查设计稿、UI 代码和工程实现。
仓库结构
.
├── README.md
├── docs/
│ ├── sop.md
│ └── html-to-figma.md
├── templates/
│ ├── DESIGN.md
│ ├── FEATURE_SPEC.md
│ ├── INTERACTION_RULES.md
│ └── HTML_OUTPUT_CONTRACT.md
├── examples/
│ └── work-order-dashboard/
│ ├── README.md
│ ├── DESIGN.md
│ ├── FEATURE_SPEC.md
│ ├── INTERACTION_RULES.md
│ ├── HTML_OUTPUT_CONTRACT.md
│ └── index.html
├── checklists/
│ └── quality-gate.md
├── CONTRIBUTING.md
└── LICENSE
四个核心文档
| 文档 | 作用 | 谁来维护 |
|---|---|---|
DESIGN.md | 描述视觉语言、颜色、字体、间距、组件、布局和禁忌项 | 设计负责人或 AI 设计实践者 |
FEATURE_SPEC.md | 描述页面目标、业务对象、字段、操作、权限和验收标准 | 产品负责人 |
INTERACTION_RULES.md | 描述用户操作流、状态反馈、异常处理、响应式和可访问性 | 产品 + 设计 + 前端 |
HTML_OUTPUT_CONTRACT.md | 约束 HTML / Tailwind / UI 代码产物必须可预览、可导入 Figma、可继续交接 | 前端或 AI 工程实践者 |
最终设计包
进入工程实现前,不要只把四份规范交给 Coding Agent,也不要只把 HTML 交给 Coding Agent。推荐交付一个完整的最终设计包:
| 内容 | 是否必需 | 价值 |
|---|---|---|
| 四份规范 | 必需 | 说明业务目标、视觉规则、交互规则和输出约束 |
| Stitch / Claude Design 导出的 HTML / Tailwind / UI 代码 | 必需 | 固化已经精修过的高保真 UI 结果,减少 Agent 重新猜设计 |
| Figma 设计稿 | 可选但团队推荐 | 作为评审、精修、组件沉淀和长期维护的设计资产 |
这样 Coding Agent 做的不是“重新设计页面”,而是“按真实项目规范把已确认 UI 落成工程文件”。
工具立场
本 SOP 保持工具中立。你可以使用 Claude、ChatGPT、Gemini、Cursor、Codex 或其他能处理截图、网页和代码的大模型。
UI 生成环节可优先验证:
- Google Stitch
- Claude Design / Claude Artifacts / Claude Code 相关设计生成能力
- 其他支持 HTML、Tailwind 或前端 UI 代码导出的 AI 设计工具
HTML-to-Figma 环节是团队工程化推荐步骤,不是强制步骤。可优先验证:
- html.to.design
- Builder.io Figma Plugin
- Axhub Chrome Extension
- Codex App 中的 Figma MCP 工作流
- 其他能把网页或 HTML 转成 Figma 可编辑图层的插件
参考项目
- VoltAgent/awesome-design-md:大量真实网站的
DESIGN.md风格分析。 - Google Labs DESIGN.md:
DESIGN.md的格式规范和 lint/export 工具。 - html.to.design:把网页或 HTML 导入 Figma 的典型工具。
合规提醒
- 不要直接复制未授权品牌资产、商标、插图、摄影图或私有页面内容。
- 参考页面只用于学习视觉结构和交互模式时,应在输出中替换为自有品牌、业务字段和素材。
- 脱敏示例不要包含客户名称、真实数据、内部系统 URL、账号、密钥或截图水印。
License
MIT. See LICENSE.