使用指南
fast-uxspec 是为了解决 Vibe Coding 场景下的前端 UI 规范落地问题而设计的工具。我们将系统性的设计要求，通过自动生成的 Markdown 文档作为上下文提示词，传达给大语言模型（如 Claude、GPT-4 等），确保生成的代码具有高一致性和美感。
第一步：从模板或提取网址出发
你可以选择两种方式开启规范的编写：
- •开箱模板：预置了类似 iOS 清新、Material Design 3、或是 SaaS 后台等成熟的设计原则。一键载入参数即可开始微调。
- •从网址提取：在首页面板输入网址，通过强大的浏览器后台服务为你直接解析网站的调色板、圆角和字体栈结构。
第二步：调整并完善设计参数
进入编辑器后，左侧是精细的设计参数表单。无需手动编写 Markdown，直接在这里配置并实时关联更新：
- •颜色配置、Web 与 iOS 字体栈 及全局字号阶梯。
- •响应断点、容器预设与组件特有的 Feature Flags（如深色模式、圆角规范）。
- •自定义 Do / Don't 设计规范，帮助约束大模型在某些易错组件上的表现。
第三步：双模式预览
编辑器右侧分两栏：你可以随时在 可视化看板 与 Markdown 源码 之间通过顶部切换。可视化界面能够助你检验设计原则的合理性，确保生成的方案是美观和自洽的。
💡 为什么需要生成的 Markdown 文件？
在使用 Cursor 或相关 AI 代码生成工具时，建议项目的根目录下存放 CLAUDE.md 或 design-system.md。当你将在此工具复制的内容粘贴其中后，AI 即可了解此项目的排版尺度、颜色变量和组件库限制。生成的页面自然就不会出现不一致的“丑陋大杂烩”代码了。
第四步：分享协作与云端保存
规范编写一旦完成：如果你登录了账号，就可以点击 保存为模板 留存在个人空间。 设置 “公开” 后，直接在 URL 栏获取属于此配方的外链，发给团队的其他伙伴或大基建项目的协作者。所有人共用一个 Prompt 标准，团队的 AI 开发产出的交付质量将会突飞猛进。