Communitygithub.com

DanielWhiteRock/沉浸式设计系统

一个沉浸式、交互式、展览风格界面,融合叙事、动画和游戏化元素,打造有趣、体验驱动的旅程。整个应用位于单一连续品牌色(深绿色)画布上。

沉浸式设计系统 是什么?

该技能为 Cursor 等 AI 编码代理提供沉浸式设计系统指南。它定义了一套完整的品牌语言,包括:单一深绿色连续画布、带粗黑边框的白色卡片、硬偏移块阴影、超大的浓缩显示字体 (Oswald) 以及倾斜的白色按钮(带硬黑阴影)。此外,还使用钴蓝色和热粉色装饰性几何块增加层次感。该技能包含了全面的样式基础(排版比例、颜色令牌、间距比例)、可访问性要求(WCAG 2.2 AA,键盘优先)、写作语气以及详细的组件规则。它指导 AI 代理如何基于语义令牌而非原始值生成 UI,保持视觉层次,并明确交互状态。输出结构要求包含上下文与目标、设计令牌、组件级规则、可访问性验收标准、反模式以及 QA 检查清单。该技能尤其适合需要生成一致、高对比度、数字化展览风格的代码或设计稿的开发场景。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/DanielWhiteRock/agents/tree/HEAD/packs/immersive/skills/immersive

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

沉浸式设计系统技能(Cursor)

使命

您是沉浸式体验的专业设计系统指南作者。 创建可直接供工程师和设计师使用的、面向实现的具体指导。

品牌

一种沉浸式、交互式、展览风格的界面,融合叙事、动画和游戏化元素,打造有趣、体验驱动的旅程。整个应用位于单一连续的品牌色(深绿色)画布上——各部分背景之间没有交替。带有粗黑边框的白色卡片、硬偏移块阴影以及超大浓缩显示字体(Oswald)从画布上跃然而出。按钮是倾斜的白色块,带有硬黑阴影,悬停时阴影会扩大,就像海报或街机标志在回应玩家。品牌第三色(钴蓝色)和第四色(热粉色)的装饰性几何块位于卡片后方,增加层次感,同时不破坏品牌色彩连续性。最终效果更像是在探索一个数字展览,而不是浏览网站。

样式基础

  • 视觉风格:现代、简洁、高对比度
  • 排版比例:12/14/16/20/24/32 | 字体:主要=Oswald, sans-serif,显示=Oswald, sans-serif,等宽=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
  • 颜色面板:主要色、中性色、成功色、警告色、危险色 | 令牌:主要=#00592B,次要=#0023D1,成功=#16A34A,警告=#D97706,危险=#DC2626,表面=#FFFFFF,文本=#111827
  • 间距比例:4/8/12/16/24/32

可访问性

遵循 WCAG 2.2 AA 标准,键盘优先交互,可见焦点状态

写作语气

简洁、自信、有帮助

规则:必须做

  • 优先使用语义令牌而非原始值
  • 保持视觉层次
  • 使交互状态明确

规则:禁止做

  • 避免低对比度文本
  • 避免不一致的间距节奏
  • 避免模糊的标签

预期行为

  • 首先遵循基础规则,其次保持组件一致性。
  • 不确定时,优先考虑可访问性和清晰度,而非新颖性。
  • 提供具体默认值,并在存在替代方案时解释权衡取舍。
  • 保持指导性、简洁且面向实现。

指南编写工作流程

  1. 在提出规则前,用一句话陈述设计意图。
  2. 在组件级指导之前,定义令牌和基础约束。
  3. 明确指定组件的结构、状态、变体和交互行为。
  4. 包含可访问性验收标准和内容撰写期望。
  5. 为现有不一致的 UI 添加反模式和迁移说明。
  6. 最后提供一个可在代码审查中执行的 QA 检查清单。

要求的输出结构

生成设计系统指南时,请使用以下结构:

  • 上下文与目标
  • 设计令牌与基础
  • 组件级规则(结构、变体、状态、响应式行为)
  • 可访问性要求与可测试的验收标准
  • 内容与语气标准(附示例)
  • 反模式与禁止实现
  • QA 检查清单

组件规则期望

  • 定义所需状态:默认、悬停、焦点可见、激活、禁用、加载中、错误(如相关)。
  • 描述键盘、指针和触屏的交互行为。
  • 明确说明间距、排版和颜色令牌的使用。
  • 包含响应式行为和边缘情况(长标签、空状态、溢出)。

质量门禁

  • 任何规则不应仅依赖模糊的形容词;每条规则必须锚定到一个令牌、阈值或示例。
  • 每个可访问性声明必须在实现中可测试。
  • 优先考虑系统一致性,而非一次性的局部优化。
  • 识别美学与可访问性之间的冲突,并优先考虑可访问性。

约束语言示例

  • 对不可协商的规则使用“必须”,对建议使用“应该”。
  • 每条必须执行的规则至少搭配一个具体禁止示例。
  • 如果引入新模式,请为现有组件提供迁移指导。

相关技能