Communitygithub.com

ulasalyesil/personal-website-v2

进行设计访谈,在临时设计实验室中生成五种不同的UI变体,收集反馈,并生成实施计划。当用户想要探索UI设计选项、重新设计现有组件或创建具有多种可供比较方法的新UI时使用。

personal-website-v2 是什么?

此技能实现了一个完整的设计探索工作流程,包括访谈、变体生成、反馈收集、优化、预览和最终确定。它主要用于当用户想要探索UI设计选项、重新设计现有组件或创建多个设计方法进行比较时。该技能会创建一个临时的设计实验室(`.claude-design/`目录及相应的路由),生成五个不同维度的UI变体,并提供一个交互式反馈覆盖层供用户评价。最终,它会根据反馈进行一轮优化或生成最终的实施计划,并**清理所有临时文件**。该技能支持Next.js、Vite、Remix、Nuxt和Astro等框架,并能自动检测项目的包管理器、样式系统(Tailwind CSS、Material UI等)以及现有的设计记忆文件,以推断出项目的视觉语言,从而确保生成的变体与现有代码库风格一致。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/design-lab

在你喜欢的 AI 中提问

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

文档

设计实验室技能

此技能实现了一个完整的设计探索工作流程:访谈、生成变体、收集反馈、优化、预览和最终确定。

关键:清理行为

当流程结束时,无论是通过以下哪种方式,所有临时文件都必须被删除:

  • 用户确认最终设计 → 清理,然后生成计划
  • 用户中止/取消 → 立即清理,不生成计划

永远不要留下.claude-design/或__design_lab路由。 如果用户在任意时刻说“取消”、“中止”、“停止”或“算了”,请确认,然后删除所有临时工件。


阶段 0:预检检测

在开始访谈之前,自动检测:

包管理器

检查项目根目录中的锁定文件:

  • pnpm-lock.yaml → 使用 pnpm
  • yarn.lock → 使用 yarn
  • package-lock.json → 使用 npm
  • bun.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 → Vite
  • remix.config.js → Remix
  • nuxt.config.js 或 nuxt.config.ts → Nuxt
  • astro.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.md
  • DESIGN_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:表现力方向

  • 推动用户在访谈中描述的品牌方向
  • 探索项目现有设计令牌的不同使用方式
  • 或多或少地使用阴影、边框、背景色
  • 在有意义的地方应用动效(悬停、聚焦、转场)

实验室页面要求

设计实验室页面必须包括:

  1. 头部包含:

    • 设计摘要摘要(目标、范围、关键需求)
    • 查看说明
  2. 变体网格包含:

    • 清晰的标签(A, B, C, D, E)
    • 每个变体的简要理由(“为什么存在这个变体”)
    • 实际渲染的变体

…

[已截断以进行翻译]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相关技能