全部指南
指南

从品牌简报制作设计系统:Token、主题与 CSS

选择产品起点,生成语义 Token 与可复用 CSS,再检查完整界面及独立集成。区分本地演示与生产应用。

快速开始

让 AI 助手帮你完成

将这段提示粘贴到你正在使用的 AI 助手中:

使用 Design System Studio,将审核后的品牌简报制作成语义 Token、主题和可复用 CSS。先询问产品、受众与主要任务,再选择规划、编辑或运营起点。标记虚构预设,生成到新目录,检查实际交互与独立 CSS 集成,并区分配对对比度检查与完整无障碍审核。

设计系统技能实际交付什么?

Design System Studio v1.2.0 将审核后的简报制作成语义颜色、可复用 CSS、设计约定和可交互产品界面。规划、编辑与运营三种起点具有不同布局和行为。Python 生成器可在本地运行,无需依赖或 API 密钥;设计决策与审核后的内容仍由你的助手提供。

从产品任务与可用品牌资料开始

  • 写明产品、受众与主要任务。可提供已确认品牌颜色、字体指引与自有界面参考。缺失事实应明确标记,不编造客户故事。
  • 工作流选择 planning,文章与审核队列选择 editorial,密集记录与本地确认选择 operations。按任务选择,而不只看喜欢的配色。
  • 保留虚构练习记录的标记。更换预设品牌名,不会使进度值、人物或故事成为真实证据。

用语义角色连接设计决策与组件

原始值表达具体数值,语义角色说明用途,组件规则说明应用位置。此内容包每个主题定义十二种语义角色,包括 canvas、surface、ink、primary、on-primary 与 focus。支持 {primary} 这样的同主题别名;循环与未知引用会被拒绝。编写简报前阅读 references/input.md。

从视觉选择到可检查交付
选择交付表示检查
表面与文字含义tokens.json 与原生 CSS 中的主题角色将解析颜色与实际组件对照
间距、圆角、字体与动效明确的刻度与可复用组件样式检查密集记录、长文案与减少动效
目标框架集成原生 CSS 及可选 Tailwind v4 适配文件在实际目标项目中编译适配文件

无需编写 JSON,生成完整练习交付

安装完整内容包,并确认助手能够发现它。阅读 SKILL.md,审核生成器。在安装目录内使用 Python 3.10 及以上和新输出目录。下面命令采用虚构 Northstar 规划预设,并使用演示品牌名;其他两种起点可使用 atelier 或 signal。

python3 scripts/quickstart.py --preset northstar --name "Cedar Practice" --output ./practice-design-system

检查成果与独立 CSS 集成

打开 practice-design-system/result/index.html,测试所选产品任务。再打开 practice-design-system/result/integration.html;该页面独立导入实际交付样式表。将计算样式与 tokens.json 对照;只有配色相同的截图,不能证明另一个文档使用相同 CSS。

  • 在搜索、选择或表单错误存在时切换主题,检查输入与恢复状态是否保留。测试键盘关闭弹窗、空结果、长内容与窄屏。
  • 使用未舍入的通过与失败判定检查 contrast.json 和 contrast.csv。它们只覆盖列出的不透明 Token 配对,不能证明完整 WCAG 合规、屏幕阅读器行为或所有叠加状态。
  • 检查 delivery.zip 及清单,并结合可编辑简报、app.json 和导出 CSS 阅读 DESIGN.md 与集成说明。内容包采用自己记录的 JSON 格式,不宣称是 DTCG 交换格式。

编辑普通字段,再生成新交付

使用可视化编辑器时,在内容包目录执行 python3 scripts/start-studio.py --output ./practice-design-editor,再打开输出的本机地址。选择起点,编写主要字段并生成实际文件。每次生成使用新目录;浏览器中的本地操作会在刷新后重置。保留审核后的简报,并重新生成以将修改保存到导出文件。

真实产品还需要实施什么?

内置交互演示本地行为,不会创建生产记录、连接后端或提供服务端授权。请在目标应用中编译框架适配文件并审核无障碍。购买按权限规则解锁内容包;模型账号与其他服务仍需另行准备。

全部指南