设计工艺 是做什么的?
一种前端设计和构建的工作方法。SKILL.md 包含了每个任务所需的内容;references/ 文件则包含更深入的细节、数字和代码。当文末表格中的触发器适用时,请阅读相应文件。
范围: 一个新页面、流程或组件执行步骤 1-8。一个小的改动(一个状态、一个动画、一个字符串)只执行它所触及的步骤,然后对更改的内容执行步骤 8。
需求层次
功能性 → 可靠性 → 可用性 → 愉悦性。切勿在已损坏、缓慢或令人困惑的事物上增添愉悦感,也切勿在缺少顶层内容(即个性)时发布,因为推迟到“以后”的个性几乎不会实现。
1. 框架(在编写任何代码之前)
- 用户任务故事: 当 [情境] 时,我想要 [动机],以便能够 [结果]。 如果情境或结果未知,请询问,或在你的摘要中将其作为假设陈述。
- 选择摘要所要求的雄心, 并在此投入精力:
| 摘要 | 投入方向 | 首要证明 |
|---|---|---|
| 品牌网站,“高级”,“奖项级别”,“充满动画” | 一个基于主题的标志性交互(步骤 2) | 交互在真实内容上运行:开始、中间、中断、释放 |
| 发布、编辑、营销页面 | 报价清晰,其最佳证据可探索 | 在手机上读取的首屏;主操作无需等待即可触及 |
| 应用、工具、仪表板 | 最难的决定、错误的成本、重复使用的速度 | 一个包含变化数据的实际任务,以及从一次失败中恢复 |
| 组件或设计系统 | 一个能够承受两个不同消费者的行为契约 | 在两种上下文中使用长内容的相同组件 |
- 区分事实与假设。指出访客到达时的情绪状态;这决定了基调。
- 检查已有的内容:代币、组件、模式、约定。在发明之前先复用。
2. 在主题中寻找标志性交互
对于表达性工作,寻找一个访客即使遮住Logo也能识别的主题属性,以及一个能让其引导的动词。啤酒会倒出、起泡并展示其颜色;布料会垂坠;字体有轴线;手表有机芯。围绕该属性设计交互。
- 替换测试: 换入一个不相关的品牌。如果效果仍然有效且无需更改,那它还不是关于这个主题的。在添加润色之前,回到主题。
- 四个节拍: 什么触发输入 → 什么在接触时响应 → 在持续输入下揭示了什么 → 释放后留下了什么。一个持久的对象应承载所有四个节拍。
- 更多效果永远无法修复“感觉基础”的问题。 改变核心思想或机制。
- 每个手势都有一个朴素的等价物(滑块、按钮、单选组),可以访问相同的信息。
3. 低成本探索,首先证明最难的部分
- 用几行描述至少三种结构上不同的方法。选择一个,并说明原因。
- 在动效之前,用真实内容组合一个静态帧:阅读顺序、类型、图像、主要操作。任何动画中间的一个帧也应该看起来是有意为之。
- 首先构建风险最大的声明(手势、滚动场景、困难的工作流程),并先在真实浏览器中检查它,然后再构建页面其余部分。
4. 系统先行
- 代币优于组件。组件消耗语义代币(
--color-action),这些代币别名化原始代币(--amber-400)。组件样式中没有十六进制、px或魔法数字。 - 基于4的比例进行间距(4, 8, 12, 16, 24, 32, 48, 64)。正文16px/1rem,行高1.5;标题1.1-1.25。一个模块化字体比例。最多两种字体(+等宽字体)。变化的数字使用表格数字。
- 1-3种品牌色,中性色,状态色。每对文本都通过WCAG AA标准(正文4.5:1,大型/UI 3:1)。颜色永远不是唯一的信号。
- 动效代币(持续时间、缓动函数)与颜色和间距并存。
- 属性命名含义(
variant="destructive"),而非外观。重复的覆盖意味着缺少一个变体。
5. 每个状态,而不仅仅是快乐路径
交互式组件:默认、悬停、焦点可见、激活、禁用、加载、错误、已选。 屏幕:空、加载、部分、错误、成功、离线。异步工作:
- 最新请求获胜;缓慢的旧响应不得覆盖新的响应。
- 在任何失败后保留用户输入,并在加载时保留之前的结果(变暗显示)。
- 空账户、无结果和获取失败是不同的状态,具有不同的下一步操作。
键盘可操作,语义化HTML优先,仅在HTML无法表达时才使用ARIA,每个字段都有标签,每个模态框都有可见的退出方式,并且当模态框关闭时,焦点返回到合理的位置。
6. 情感、文案与诚实
- 清晰胜过聪明。 如果一个笑话需要额外的句子,就删掉它。使用缩略词、平实的词语。
- 语气一致,语调变化:成功时温暖,错误时平淡冷静,敏感输入时温和。
- 错误: 发生了什么,为什么,下一步做什么,以及保留了什么。切勿责怪用户。这里没有幽默。
- 空状态 应引导:这里将会出现什么,加上一个明确的首要操作。
- 峰终定律: 将一大乐趣放在真正成就的结尾,切勿放在挫折的低谷。
- 在高风险页面上,点出访客的恐惧,并在呼吁行动之前逐一回答。
- 图像: 默认多样化;询问“我们排除了谁?”
- 诚实: 在人们可能误以为真时,标记AI生成的图像和演示数据。文案必须与图像显示的内容匹配(打印5.0%的罐子意味着页面显示5.0%)。
- 受监管类别(酒类、金融、健康、儿童):添加所需的门控或披露,并根据该类别的广告规范检查图像,例如酒类图像不应有色情内容。
7. 动效
每个动画都有一个任务:上下文、注意力、反馈或个性。没有任务,就没有动画。
| 代币 | 值 | 用途 |
|---|---|---|
--dur-1 | 100ms | 按下、聚焦、切换(≈感知阈值) |
--dur-2 | 200ms | 大多数UI过渡、悬停、小的进入 |
--dur-3 | 300ms | 面板、抽屉、模态框 |
--dur-4 | 400-500ms | 仅全屏或主视觉编排 |
--ease-out | cubic-bezier(0,0,.2,1) | 进入 / 获得注意力 |
--ease-in | cubic-bezier(.4,0,1,1) | 离开 / 失去注意力(退出约短20-30%) |
--ease-in-out | cubic-bezier(.4,0,.2,1) | 在屏幕位置之间移动 |
| spring | 临界阻尼,可重新定位 | 手势;在目标改变时保留速度 |
- 切勿让编排阻塞主要操作。 预加载器或介绍画面不得将主要操作延迟超过大约一秒钟,并且回访者应跳过它。
- 空间一致性: 事物以它们来的方式离开;共享元素在原地变形。
- 错开 30-60ms,使用递减的延迟(
base*√i);保持整个序列在约300ms以下。 - 滚动场景: 进度映射自章节的测量行程,因此相同的滚动位置始终产生相同的帧,向上滚动可干净地反转,并且指向中间的直接链接也能工作。
- 手势: 一个进度的所有者;手柄始终附着在指针上;释放时将速度传递给弹簧;中途中断使UI保持可操作状态。
- 仅动画化
transform和opacity。在prefers-reduced-motion下,移除移动、视差、缩放和自动播放,保留短淡入淡出,并让用户驱动的手势仍然工作。 - 曾破坏实际构建的工程陷阱(一个属性一个所有者;暂停的滚动时间线;时间线内的快照标签;非负帧时间;预加载可更换资源):
references/motion-engineering.md。
8. 在真实浏览器中验证,然后交付
在桌面端、手机端和减少动效模式下运行 scripts/walk.py(Playwright + 本地Chrome):真实指针拖拽、滚动每个章节、控制台错误、横向溢出。隐藏或最小化的预览窗格会节流动画帧,因此不要据此判断动效。详情:references/verification.md。
然后根据用户任务故事进行评审,而不是个人品味:
- 它满足用户任务故事吗?主要操作是否是最突出的,并且随处可及?
- 所有状态都存在吗(步骤5)?键盘、屏幕阅读器标签、对比度?
- 仅使用代币?复用了现有组件?
- 文案遵循步骤6,包括诚实标签?
- 每个动画都有任务、正确的缓动方向、中断路径和减少动效路径?
- 标志性交互是否通过替换测试?是否有一个高峰,放置在结尾?
- 我会削减什么?移除一个元素或效果,看看是否变得更好。
交付时附上设计决策说明:问题、方法、被拒绝的替代方案及原因、测试了哪些内容及如何测试(模拟vs真实设备),以及已知的限制。模板:references/process-and-teams.md 附录B。
参考文献
| 读取 | 何时 |
|---|---|
references/motion-engineering.md | 构建任何 GSAP/ScrollTrigger/Lenis、Canvas、手势或滚动场景工作时 |
references/verification.md | 在宣布任何视觉或交互工作完成之前 |
references/imagery.md | 生成或准备图像、产品抠图、艺术指导时 |
references/animation.md | 编排、7个动效原则、错开数学、动效代币时 |
references/emotion.md | 设计人物、引导、愉悦、信任与恐惧、故障文案时 |
references/design-systems.md | 代币、组件API、治理、版本控制、文档时 |
references/product-design.md | 研究、故事优先、草图、反馈、原型设计、测试时 |
references/design-thinking.md | 需要同理心/定义/构思/原型/测试的模糊问题时 |
references/design-engineering.md | 选择原型保真度、设计与代码握手时 |
references/process-and-teams.md | 评审会议、设计决策说明和交付模板、设计运营时 |