设计实验室技能
此技能实现了一个完整的设计探索工作流程:访谈、生成变体、收集反馈、优化、预览和最终确定。
关键:清理行为
当流程结束时,无论是通过以下哪种方式,所有临时文件都必须被删除:
- 用户确认最终设计 → 清理,然后生成计划
- 用户中止/取消 → 立即清理,不生成计划
永远不要留下.claude-design/或__design_lab路由。 如果用户在任意时刻说“取消”、“中止”、“停止”或“算了”,请确认,然后删除所有临时工件。
阶段 0:预检检测
在开始访谈之前,自动检测:
包管理器
检查项目根目录中的锁定文件:
pnpm-lock.yaml→ 使用pnpmyarn.lock→ 使用yarnpackage-lock.json→ 使用npmbun.lockb→ 使用bun
框架检测
检查配置文件:
next.config.js或next.config.mjs或next.config.ts→ Next.js- 检查
app/目录 → App Router - 检查
pages/目录 → Pages Router
- 检查
vite.config.js或vite.config.ts→ Viteremix.config.js→ Remixnuxt.config.js或nuxt.config.ts→ Nuxtastro.config.mjs→ Astro
样式系统检测
检查 package.json 中的依赖项和配置文件:
tailwind.config.js或tailwind.config.ts→ Tailwind CSS- 依赖项中的
@mui/material→ Material UI - 依赖项中的
@chakra-ui/react→ Chakra UI - 依赖项中的
antd→ Ant Design - 依赖项中的
styled-components→ styled-components - 依赖项中的
@emotion/react→ Emotion .css或.module.css文件 → CSS Modules
设计记忆检查
查找现有的设计记忆文件:
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
如果找到,读取它并用于预填充默认值并跳过重复问题。
视觉风格推断(关键)
不要使用通用/预定义样式。从项目中提取视觉语言:
如果检测到 Tailwind,读取 tailwind.config.js 或 tailwind.config.ts:
// 提取并使用:
theme.colors // 调色板
theme.spacing // 间距尺度
theme.borderRadius // 圆角值
theme.fontFamily // 字体
theme.boxShadow // 阴影系统
如果存在 CSS 变量,读取 globals.css、variables.css 或 :root 定义:
:root {
--color-* /* 颜色令牌 */
--spacing-* /* 间距令牌 */
--font-* /* 排版令牌 */
--radius-* /* 圆角令牌 */
}
如果检测到 UI 库(MUI、Chakra、Ant),读取主题配置:
- MUI:
theme.ts或createTheme()调用 - Chakra:
theme/index.ts或extendTheme()调用 - Ant:
ConfigProvider主题 prop
始终扫描现有组件以理解模式:
- 找到 2-3 个现有按钮 → 记录它们的样式模式
- 找到 2-3 个现有卡片 → 记录内边距、边框、阴影
- 找到现有表单 → 记录输入样式、标签位置
- 找到现有排版 → 记录标题大小、正文文本
将推断出的样式存储在设计摘要中,以便在所有变体中一致使用。
阶段 1:访谈
使用 AskUserQuestion 工具进行所有访谈步骤。如果存在设计记忆,则根据它调整问题。
步骤 1.1:范围与目标
提出以下问题(可以合并为单个 AskUserQuestion,包含多个问题):
问题 1:范围
- 标题:“范围”
- 问题:“我们要设计一个独立的组件还是一个完整的页面?”
- 选项:
- “组件” - 一个可复用的 UI 元素(按钮、卡片、表单、模态框等)
- “页面” - 一个完整的页面或屏幕布局
问题 2:新建或重新设计
- 标题:“类型”
- 问题:“这是一个新设计还是对现有内容进行重新设计?”
- 选项:
- “新建” - 从头创建
- “重新设计” - 改进现有组件/页面
如果选择了“重新设计”,则询问: 问题 3:现有路径
- 标题:“位置”
- 问题:“现有 UI 的文件路径或路由是什么?”
- 选项:(让用户通过“其他”提供)
如果目标不明确,根据仓库模式提出一个名称并确认。
步骤 1.2:痛点与灵感
问题 1:痛点
- 标题:“问题”
- 问题:“当前设计的最大痛点是什么(或者这个新设计应避免什么)?”
- 选项:
- “过于杂乱/密集” - 信息过载,难以扫描
- “层次不清” - 主要操作不明显
- “移动端体验差” - 在小屏幕上效果不佳
- “外观过时” - 感觉陈旧或与品牌不一致
- multiSelect: true
问题 2:视觉灵感
- 标题:“视觉风格”
- 问题:“我应该参考哪些产品或品牌来获得视觉灵感?”
- 选项:
- “Stripe” - 简洁、简约、可信赖
- “Linear” - 密集、键盘优先、开发者导向
- “Notion” - 灵活、内容导向、有趣
- “Apple” - 高级、宽敞、精致
- multiSelect: true
问题 3:功能灵感
- 标题:“交互”
- 问题:“我应该模仿哪些交互模式?”
- 选项:
- “内联编辑” - 无需弹窗即可就地编辑
- “渐进式披露” - 根据需要显示更多内容
- “乐观更新” - 即时反馈,后台同步
- “快捷键” - 高效用户操作
步骤 1.3:品牌与风格方向
问题 1:品牌形容词
- 标题:“品牌调性”
- 问题:“哪 3-5 个形容词描述了所需的品牌感觉?”
- 选项:
- “极简” - 干净、简单、不杂乱
- “高级” - 高端、精致、优雅
- “有趣” - 快乐、友好、平易近人
- “实用” - 功能导向、高效、不说废话
- multiSelect: true
问题 2:密度
- 标题:“密度”
- 问题:“你更喜欢哪种信息密度?”
- 选项:
- “紧凑” - 显示更多信息,间距更紧
- “舒适” - 间距均衡,易于扫描
- “宽敞” - 留白充足,专注注意力
问题 3:深色模式
- 标题:“深色模式”
- 问题:“是否需要深色模式?”
- 选项:
- “需要” - 必须支持深色模式
- “不需要” - 仅限浅色模式
- “有则更好” - 如果容易实现则支持,非必需
步骤 1.4:用户画像与待完成任务
问题 1:主要用户
- 标题:“用户”
- 问题:“主要最终用户是谁?”
- 选项:
- “开发者” - 技术人员,键盘导向
- “设计师” - 视觉导向,注重细节
- “业务用户” - 效率导向,技术性较弱
- “最终消费者” - 普通大众,技术能力各异
问题 2:使用场景
- 标题:“场景”
- 问题:“主要使用场景是什么?”
- 选项:
- “桌面优先” - 主要用于大屏幕
- “移动优先” - 主要用于手机
- “同等重要” - 必须在所有设备上良好运行
问题 3:关键任务
- 标题:“关键任务”
- 问题:“用户必须完成的前 3 个关键任务是什么?”
- 选项:(让用户通过“其他”提供 - 此选项为开放式)
步骤 1.5:约束
问题 1:必须保留的元素
- 标题:“保留”
- 问题:“哪些元素必须保留?”
- 选项:
- “现有文案/标签” - 保留当前文本
- “当前字段/输入” - 保留表单结构
- “导航结构” - 保留当前导航
- “无” - 可以自由更改所有内容
问题 2:技术约束
- 标题:“约束”
- 问题:“有任何技术限制吗?”
- 选项:
- “无新依赖” - 仅使用现有库
- “使用现有组件” - 基于当前设计系统构建
- “必须可访问 (WCAG)” - 严格的可访问性要求
- “无” - 无特殊约束
- multiSelect: true
阶段 2:生成设计摘要
访谈结束后,创建一个结构化的设计摘要 JSON 并保存到 .claude-design/design-brief.json:
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["过于密集", "主要操作不明确"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["内联验证"]
},
"brand": {
"adjectives": ["极简", "可信赖"],
"density": "舒适",
"darkMode": true
},
"persona": {
"primary": "开发者",
"context": "桌面优先",
"keyTasks": ["完成结账", "查看订单", "应用折扣"]
},
"constraints": {
"mustKeep": ["现有字段"],
"technical": ["无新依赖", "WCAG 可访问"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
在继续之前向用户显示摘要。
阶段 3:生成设计实验室
目录结构
在 .claude-design/ 下创建所有文件:
.claude-design/
├── lab/
│ ├── page.tsx # 主实验室页面(框架特定)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # 实验室布局包装器
│ ├── feedback/ # 交互式反馈系统
│ │ ├── types.ts # TypeScript 接口
│ │ ├── selector-utils.ts # 元素标识
│ │ ├── format-utils.ts # 反馈格式化
│ │ ├── FeedbackOverlay.tsx # 主覆盖层组件
│ │ └── index.ts # 模块导出
│ └── data/
│ └── fixtures.ts # 共享模拟数据
├── design-brief.json
└── run-log.md
反馈系统设置(关键 - 从不跳过)
FeedbackOverlay 是设计实验室的主要功能。 没有它,用户无法提供交互式反馈。永远不要在缺少 FeedbackOverlay 的情况下生成设计实验室。
可靠性策略: 为避免在不同项目配置中出现导入路径问题,将 FeedbackOverlay 直接创建在路由目录中(例如,app/design-lab/FeedbackOverlay.tsx),而不是在 .claude-design/ 中。这确保了简单的相对导入(./FeedbackOverlay)始终有效。
路由目录中的必需文件:
app/design-lab/ # 或 app/__design_lab/(如果下划线有效)
├── page.tsx # 包含变体的主实验室页面
└── FeedbackOverlay.tsx # 自包含的覆盖层组件(从模板复制)
模板来源: design-and-refine/templates/feedback/FeedbackOverlay.tsx
为什么采用这种方法:
- 由于打包器配置,
.claude-design/路径可能失败 - 来自同一目录的相对导入始终有效
- 无论如何,路由目录在清理过程中都会被删除
路由集成
Next.js App Router:
创建 app/__design_lab/page.tsx 并从 .claude-design/lab/ 导入
Next.js Pages Router:
创建 pages/__design_lab.tsx 并从 .claude-design/lab/ 导入
Vite React:
- 如果存在 React Router:为
/__design_lab添加路由 - 如果没有路由器:基于
?design_lab=true查询参数在App.tsx中创建条件渲染
其他框架: 为检测到的框架创建最合适的临时路由。
变体生成指南
重要提示: 阅读 DESIGN_PRINCIPLES.md 以了解 UX、交互和动效最佳实践。但不要使用预定义的视觉样式——从项目中推断它们。
应用通用原则(来自 DESIGN_PRINCIPLES.md):
- UX:Nielsen 启发式、认知负荷降低、渐进式披露
- 组件行为:按钮状态、表单结构、卡片结构
- 交互:反馈模式、状态处理、乐观更新
- 动效:时机(150-300ms)、缓动(缓出进入、缓入退出)
- 可访问性:聚焦状态、ARIA 模式、触摸目标(最小 44px)
从项目中推断视觉风格:
- 颜色 → 来自 Tailwind 配置、CSS 变量或现有组件
- 排版 → 来自代码库中现有的标题和正文文本
- 间距 → 来自项目的间距尺度或现有模式
- 圆角 → 来自现有卡片、按钮、输入框
- 阴影 → 来自现有的提升组件
每个变体必须探索不同的设计轴。不要创建微小的变化——使它们在意义上截然不同。所有变体都使用项目现有的视觉语言。
变体 A:信息层次结构焦点
- 重组内容层次结构(什么最重要?)
- 应用 Gestalt 邻近原则——将相关项分组得更近
- 每个视图一个主要操作
- 使用现有的排版尺度创建清晰的层级
变体 B:布局模型探索
- 尝试不同的布局方法(卡片 vs 列表 vs 表格 vs 分割面板)
- 应用 DESIGN_PRINCIPLES 中的卡片结构或表格行为模式
- 考虑每个断点处的响应式行为
- 使用项目现有的网格/布局系统
变体 C:密度变化
- 如果摘要说是“舒适”,尝试更紧凑的版本
- 如果摘要说是“紧凑”,尝试更宽敞的版本
- 使用项目现有的间距令牌——只需以不同方式应用它们
- 展示权衡:更多可见数据 vs 更易扫描
变体 D:交互模型
- 不同的交互模式(模态框 vs 内联 vs 面板 vs 抽屉)
- 应用反馈模式:即时 → 进度 → 完成
- 实现所有必需状态(加载、错误、空、禁用)
- 考虑对非破坏性操作进行乐观更新
变体 E:表现力方向
- 推动用户在访谈中描述的品牌方向
- 探索项目现有设计令牌的不同使用方式
- 或多或少地使用阴影、边框、背景色
- 在有意义的地方应用动效(悬停、聚焦、转场)
实验室页面要求
设计实验室页面必须包括:
-
头部包含:
- 设计摘要摘要(目标、范围、关键需求)
- 查看说明
-
变体网格包含:
- 清晰的标签(A, B, C, D, E)
- 每个变体的简要理由(“为什么存在这个变体”)
- 实际渲染的变体
…
[已截断以进行翻译]