AGY Hub
工具与配置
前端实践
来源:AGY Hub 工程复盘

用 Google Stitch DESIGN.md + Starwind UI 治好前端「AI 味」

为什么只靠长提示词做不好页面?复盘 AGY Hub 从手写深蓝霓虹到 Stitch Tonal Layering + 零 React Astro 静态架构的实战经验。

Stitch DESIGN.md Tailwind v4 Starwind

AI 生成前端为什么总是一股模板味?

未受约束的编码助手很容易默认滑向三件套:深青紫渐变背景 + 1px 发光边框 + 卡套卡弹窗。仅仅在对话里写「请做高级一点」,过几轮迭代就会失效。

社区验证有效的三层约束

  1. 一份可校验的 DESIGN.md 契约:把 Surface 层级(surface → surface-container-lowest → surface-container-low)、字阶与 No-Line Rule(能用背景色阶分层就不画硬边框) 写进根目录,并通过官方 CLI 校验对比度与导出 CSS @theme:
bash
pnpm run design:lint
pnpm run design:export
  1. 避免 Tailwind v4 令牌命名踩坑:DESIGN.md 里的 spacing 键名应使用语意前缀(如 gutter-lg),不要使用 bare lg,否则导出的 --spacing-lg 会覆盖 max-w-lg 弹窗宽度。
  2. 能静态就不要强行上重框架:对于比价表、文档与快讯门户,采用 Astro + Tailwind v4 + Starwind UI 原生 .astro 组件,搭配几 KB 的原生 ESM + Cloudflare Worker 动态 JSON 下发,首屏与总 JS 体积可控制在 60 KB 以内,同时完美吃满 Cloudflare 免费无限流量 CDN。

关联实战工具与延伸阅读

浏览全部精选攻略 →