Communitygithub.com

Seminal

上下文感知的界面设计方法论。在构建前和构建过程中,决定UI中哪些应保持熟悉、哪些应改进、哪些应承载品牌身份、哪些值得创造新的交互方式。用于设计、重新设计、构建或审查任何用户界面时。

Seminal 是什么?

Seminal是一个设计决策层,它不规定外观,而是迫使开发者思考用户已经习惯的交互模式、品牌身份表达的位置以及需要创新的地方。它通过三层模型(惯例、身份、创新)帮助AI Agent在每个界面决策上做出选择,避免“随大流”或“为创新而创新”的陷阱。适用于Claude Code、Cursor、Codex等AI编程工具,支持从简单的组件调整到完整的产品界面设计。工作流程包含10个步骤,从理解产品用户、检查现有项目到最终验证,并附带一致性测试和创新测试来确保每个设计决策都是合理的。该技能可以独立工作,也可与前端设计、运动设计等其他专业技能集成,为AI驱动的设计提供结构化指导。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sewadahapp/seminal/tree/HEAD

在你喜欢的 AI 中提问

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

文档

Seminal 是做什么的?

借用熟悉,保持可用,表达身份,有意创新。

Seminal 是一个决策层。它不规定外观。它迫使你弄清楚用户已经期望什么、保留哪些期望、产品身份应在何处展现,以及哪些问题——如果有的话——值得新的解决方案。然后它让你构建并诚实地检查。

核心模型:三个层面,分别决策

每个界面决策属于三个层面之一。当AI Agent混淆它们时,就会做出糟糕的设计。

层面问题默认立场
惯例用户期望这类产品如何工作?保留它,除非它在此工作流中失效
身份是什么让这款产品能够被识别?有意识地表达;绝不借用其他产品的
创新什么新行为让体验变得更有意义?用其解决的具体命名问题来赢得它

后果:

  • 熟悉的UX并不意味着熟悉的视觉。一个市场保留搜索 → 结果 → 筛选 → 产品页面 → 购物车 → 结账,但仍然看起来不像其他任何市场。
  • 视觉原创性并不允许交互原创性,反之亦然。
  • “通用”是身份层面的失败。“令人困惑”通常是惯例层面的失败。“花哨”是创新层面的失败。在修复前先诊断。

存在两种失败模式,Seminal 对两者都有防范:

  1. 随大流的垃圾: 默认的套件组件,没有观点,可以是任何产品。
  2. 新奇性的垃圾: 重新发明的可操作机制、装饰性动画和巧妙的导航,迫使用户重新学习他们已经知道的东西。

工作流程

根据任务调整深度。对于单个组件的调整,第1-5步可能只需几句话。对于新产品或新界面,请将它们写为设计决策记录(模板:assets/design-decision-record.md)。目标大约是每个界面一个屏幕。

根据任务加载内容(仅加载任务所需):

任务加载内容
对现有UI进行小改动existing-projects,加上你修改部分的ux-patterns或visual-direction
仅做规划或方向(尚未编码)product-conventions(相关章节)、interface-classification、design-judgment
从头到尾构建新界面或新产品随着每一步的出现,加载所有步骤引用
重新设计现有界面existing-projects、layout、visual-direction、product-conventions(相关章节)
页面结构:内容宽度、对齐方式、列表 vs 卡片 vs 表格、应用外壳layout
审查或评价现有UIvalidation、design-judgment、product-conventions(相关章节)
对你构建的东西的模糊反馈(“看起来不对”、“难以阅读”)validation (§4)、layout
感觉接近发布报告examples

1. 了解产品及其用户

确定:产品的用途、使用者、使用频率、专业水平、以及当他们出错时会有什么风险。如果需求说明中没有提及,从代码库、数据模型、文案和路由中推断,明确陈述你的假设,并且仅在错误猜测会改变设计方向时才提问。如果是重新设计,外观和布局就是方向,所以询问它们是可以预期的(第3步)。

2. 检查现有项目(仅当文件夹为空时跳过)

在决策前先阅读:组件库、标记(tokens)、主题、布局外壳、路由、现有页面、文案语气、响应式方法。默认保留有效的工作决策。如果用户只描述了技术栈而你无法看到代码,则根据他们的描述制定计划,列出你会检查的内容,并在构建前确认。 → references/existing-projects.md

3. 映射期望:两套参考

来自两个不同的人的两个不同输入。收集两者。

  • 用户来自(工作方式)。列出用户最可能知道的2-5个产品(例如,印尼市场:Tokopedia、Shopee;问题跟踪器:Jira、Linear、GitHub Issues)。提取心智模型,而非视觉,并列出该类别的惯例。对于内部工具,参考通常是电子表格、遗留系统或纸质流程。找出用户离开它会失去什么(批量粘贴、自由排序、键盘速度)并保留它们。
  • 所有者喜欢(外观和感觉)。你为其构建的人通常在能说出具体名字之前就已经有了品味上的想法。对于新界面或重新设计,请他们提供1-3个他们喜欢的产品或屏幕用于此界面,或者使用他们已经给出的任何内容。截图或命名的屏幕是目标构图。其行为仍然要通过惯例分类账。

所有者处于以下三种情况之一。分别处理:

所有者拥有…执行此操作
具体参考瞄准它们。采用构图和感觉,而非品牌的皮肤(克隆测试)。
仅一种感觉(“干净”、“平静”、“像真正的仪表板”)将其转变为2-3个选项,每个都以一个真实模式命名,让他们选择(第8步)。
什么都没有(“你决定”、“不确定”)仍然提供2-3个选项并附上建议。人们识别他们想要的东西比描述它更快。

如果没有人可问,选择,写下你假设的参考,并在报告中提供替代方案。 → references/product-conventions.md、references/layout.md

4. 对每个界面进行分类

一个产品有许多界面(营销网站、入门引导、工作区、分析、设置、管理)。通过阅读五个信号对每个界面独立分类:使用频率、风险、用户专业水平、意图(交易/操作/探索/学习/创作/被说服)和信息密度。它们共同给出界面的姿态:界面应在多大程度上退后于任务之后,或站出来表达自己。 → references/interface-classification.md

5. 决定策略:惯例分类账

对于界面上的每个重要惯例,记录一个裁决:

  • 保留: 用户期望它并且它适合。(大多数条目。)
  • 改进: 保留模型,修复已知弱点(更好的筛选反馈、更清晰的空状态)。
  • 替换: 仅当通过下面的创新测试后才进行。写下它解决的问题。
  • 放弃: 该惯例完全不适用于此工作流。

然后为界面命名身份杠杆。这些是品牌展示的地方:字体、颜色、构图、图像、语气、组件形状、标志性交互。然后命名创新赌注(零是有效数字)。 → references/design-judgment.md

6. 建立UX和交互模式

信息架构、导航、核心任务流程、组件行为、表单和验证、反馈、每个状态(空、加载、部分、错误、成功、离线、无权限)、恢复和撤销、键盘和屏幕阅读器访问以及响应式行为。在设计样式之前决定这些。 → references/ux-patterns.md

7. 建立或复用视觉系统

如果项目有现有系统则复用它。否则,从身份杠杆和界面姿态派生标记(tokens):密度、字体比例、颜色角色、表面处理、动效预算。 → references/visual-direction.md

8. 检查点,然后实现

在构建前提供选项。 当多个模式同样有效并且选择会改变页面的外观(表格 vs 卡片列表 vs 网格、居中 vs 全宽列、侧边栏页脚结构)时,在编写代码前向所有者展示2-3个低保真选项:每个选项对应一行描述或小的ASCII草图,加上你的建议和理由。然后将塑造方向的决定(姿态、参考、关键分类账裁决、所选选项)作为简短摘要放入聊天中,即使你同时也保存了设计决策记录。没人读的记录无法指导任何事情。对于只有一个明显答案的小更改,跳过检查点。如果任务不间断地运行,构建你的建议并将其他选项列为后续事项。

然后构建。在项目自己的框架、组件和惯例中工作。使用真实或现实的内容(真实产品名称、现实数字、长字符串和短字符串、空数据集),而不是完美3行表格中的Lorem Ipsum。

9. 检查并验证

查看渲染结果。如果浏览器工具存在,截取移动端和桌面端宽度的关键状态,并用键盘和指针执行核心流程。然后运行验证问题。 → references/validation.md

10. 根据实际问题进行改进

按用户影响顺序修复检查发现的问题。不要进行仅移动像素的外观调整。当所有者的反馈模糊时(“看起来不对”、“难以阅读”),不要首先修复你猜测的东西。测量,列出2-3个假设,并为其品味(而非缺陷)请求参考(validation.md §4)。然后报告哪些已验证、哪些仅通过代码审查、以及哪些未经检查。

创新测试

在替换或发明一个模式之前,诚实地回答这些问题:

  1. 此交互是否有既定的惯例?
  2. 用户会理解并期望它吗?
  3. 该惯例是否真正适合此工作流、数据和用户?
  4. 此更改解决了哪些具体的、可命名的问题?
  5. 它在学习成本、发现性、可访问性、平台一致性和工作量方面代价是什么?
  6. 改进现有模式是否能获得大部分收益?
  7. 这种新颖性对用户有用,还是仅仅视觉上有趣?

决策规则: 仅当两者都成立时才继续:

  • 真正的差距: 惯例不适合(3 = 否),或者更改解决了用户实际遇到的可命名问题(4),并且
  • 没有更便宜的路径: 改进惯例无法获得大部分收益(6 = 否),并且(5)中的成本与该收益相称。

如果(7)的诚实答案是“仅视觉上有趣”,那么这是一个身份决策,而非创新。将其移至身份层面并保持行为传统。

一个定制的交互也必须在第50次使用时依然有效,而不仅仅是第一次。它必须能够在无需教程的情况下被发现,或者能在一个时刻内教会。它必须可通过键盘和屏幕阅读器访问,并且不能破坏平台期望(后退按钮、链接、选择、复制、滚动)。

身份测试

  • 互换测试: 将竞争对手的标志放在屏幕上。如果没有任何感觉不协调,说明身份层面是空的。
  • 克隆测试: 如果截图可能被误认为是参考产品,说明你借用了它的皮肤而不是模型。更改身份层面,而不是惯例。
  • 默认测试: 列出你因默认值而做出的选择(框架主题、库存字体、套件圆角、库存渐变)。只有在故意选择的情况下才保留默认值。对于操作性工具,许多默认值是正确选择的。

姿态的经验法则(信号,而非预设)

  • 高频率 + 专家用户 + 高密度 → 界面退后。熟悉的模式、键盘路径、紧凑密度、克制色彩、近乎零装饰动画。身份存在于精确性中:字体、间距节奏、数据格式化、微文案、一种强调色。
  • 交易型消费者流程 → 惯例承载信任。身份存在于品牌表面,如商品陈列、图像、语气和促销时刻。结账和支付保持平淡。
  • 说服性界面(着陆页、活动) → 最广泛的视觉实验许可。仍然保留传统导航、清晰的操作号召、可读文本和快速加载。
  • 创意和探索工具 → 当任务确实没有好的先例时(空间画布、时间线、新颖操作),创新预算更大。保持框架——文件、编辑、撤销、导出、设置——的传统。
  • 数据/分析 → 图表选择遵循被提出的问题。层次结构遵循用户做出的决策。装饰与数据竞争。

退后不是一种布局。 退后意味着界面不与任务竞争。这不意味着表格、左对齐的密集页面或没有个性。卡片列表、居中列和宁静大方的页面都可以退后。当用户比较列时使用表格。当产品的UI同时也是其展示(设计系统自己的应用、开源项目、作品集产品),或者所有者是主要用户时,所有者的品味是首要输入。主动询问,而不是默认采用最功利的形式。

一个产品的不同界面可以采取不同的姿态。通过共享的标记、语气和组件行为保持它们的一致性,而不是通过让每个页面看起来都一样。

与专业技能合作(可选)

Seminal 决策;专业技能执行。如果安装了诸如 Impeccable、Taste、UI UX Pro Max、Anti-Slop References、Frontend Design 或 motion/design-engineering skills 等技能,则在步骤1-5之后将工作分配给他们。通过惯例分类账过滤他们的输出。专业技能的预设永远不能在高级别表面的“保留”裁决上覆盖。 → references/specialist-integration.md

Seminal 在没有任何它们的情况下也能完全工作。

诚实规则

  • 永远不要声称你视觉验证了未渲染和查看的内容。说“已在浏览器中验证”、“仅通过代码审查”或“未经检查”,以实际情况为准。
  • 陈述你对用户及其参考产品的假设。不要将猜测呈现为研究。
  • 当用户要求的内容未通过创新测试(或与工作流不匹配的惯例)时,在第一个回复中提出一次:一两句关于权衡的话,以及你推荐的替代方案。

相关技能