convez.ai
AgenteDesenvolvimento WebAvançado
jimmyhu95

SOP de Design Frontend com IA

jimmyhu95/ai-frontend-design-sop

Workflow engenheirado: referência → design specs → UI code → Vue 3 project

Ver no GitHub
InicialPluginScore · de 0 a 100

Fluxo 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-sop

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 分钟快速开始

  1. 准备一个目标页面截图或网页链接,明确你想借鉴的是视觉语言、布局密度、组件风格,还是完整交互模式。
  2. 复制 templates/DESIGN.md,让大模型从参考页面中提取设计规范。
  3. 复制 templates/FEATURE_SPEC.md,补齐你的真实业务目标、页面对象、字段、操作和权限。
  4. 复制 templates/INTERACTION_RULES.md,定义页面状态、操作流、反馈、异常和响应式行为。
  5. 复制 templates/HTML_OUTPUT_CONTRACT.md,约束 Stitch、Claude Design 或其他模型生成可预览、可导入、可交接的 UI 代码。
  6. 在 Stitch 或 Claude Design 中生成并手工精修页面,导出 HTML / Tailwind / 前端 UI 代码 / DESIGN.md。
  7. 如果需要团队设计资产,使用 Chrome 浏览器 html.to.design 插件、Figma 官方能力、Axhub 或 Codex App 里的 Figma MCP 把 HTML 转成 Figma 设计稿。
  8. 把“最终设计包”交给 Codex / Cursor / Claude Code:四份规范 + Stitch / Claude Design 导出的 HTML / Tailwind / UI 代码 + 可选 Figma 设计稿,按真实项目规范转成 Vue 3 + Vite 工程文件。
  9. 按 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 环节是团队工程化推荐步骤,不是强制步骤。可优先验证:

参考项目

合规提醒

  • 不要直接复制未授权品牌资产、商标、插图、摄影图或私有页面内容。
  • 参考页面只用于学习视觉结构和交互模式时,应在输出中替换为自有品牌、业务字段和素材。
  • 脱敏示例不要包含客户名称、真实数据、内部系统 URL、账号、密钥或截图水印。

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados