Communitygithub.com

设计工艺

指导AI智能体如何进行艺术指导和构建“设计工艺”,使最终输出为落地页、首页或作品集。流程涵盖设计工艺、需求层次,以及框架(在编写任何代码之前)。适用于需要此类工艺的新任务。

设计工艺 是什么?

该技能为AI智能体提供了一套结构化的工作方法,用于前端设计和构建,确保输出高质量的页面、组件或系统。它基于“功能→可靠→可用→愉悦”的需求层次,引导智能体在编写任何代码之前,先通过用户任务故事和雄心匹配来进行框架设计。核心流程包括:在主题中寻找标志性交互、低成本探索并先证明最难部分、系统先行(使用语义化代币和设计系统)、处理所有状态(包括非快乐路径、键盘可访问性和无障碍性)、注入情感与诚实的文案与视觉、以及遵循“七大运动原则”的动效设计。最终,智能体需在真实浏览器中验证并基于用户任务故事而非个人品味进行评审,最终交付包含设计决策说明的成果。此工作流对于需要强表现力、品牌感或交互复杂度的前端项目(如品牌网站、营销页面、应用工具等)尤为有用,支持Cline、Roo Code等AI编码智能体平台,并能与现有设计系统无缝集成。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Iitian001/design-craft/tree/HEAD/skills/design-craft

在你喜欢的 AI 中提问

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

文档

设计工艺 是做什么的?

一种前端设计和构建的工作方法。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-1100ms按下、聚焦、切换(≈感知阈值)
--dur-2200ms大多数UI过渡、悬停、小的进入
--dur-3300ms面板、抽屉、模态框
--dur-4400-500ms仅全屏或主视觉编排
--ease-outcubic-bezier(0,0,.2,1)进入 / 获得注意力
--ease-incubic-bezier(.4,0,1,1)离开 / 失去注意力(退出约短20-30%)
--ease-in-outcubic-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。

然后根据用户任务故事进行评审,而不是个人品味:

  1. 它满足用户任务故事吗?主要操作是否是最突出的,并且随处可及?
  2. 所有状态都存在吗(步骤5)?键盘、屏幕阅读器标签、对比度?
  3. 仅使用代币?复用了现有组件?
  4. 文案遵循步骤6,包括诚实标签?
  5. 每个动画都有任务、正确的缓动方向、中断路径和减少动效路径?
  6. 标志性交互是否通过替换测试?是否有一个高峰,放置在结尾?
  7. 我会削减什么?移除一个元素或效果,看看是否变得更好。

交付时附上设计决策说明:问题、方法、被拒绝的替代方案及原因、测试了哪些内容及如何测试(模拟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评审会议、设计决策说明和交付模板、设计运营时

相关技能