Communitygithub.com

ulasalyesil/personal-website-v2

進行設計訪談,在臨時設計實驗室中產生五種不同的 UI 變體,收集回饋,並產出實作計畫。當使用者想要探索 UI 設計選項、重新設計現有元件或建立多種可比較的新 UI 時使用。

personal-website-v2 是什麼?

這個技能實作了一個完整的設計探索工作流程,從設計訪談、產生變體、收集回饋、迭代優化,一直到預覽與最終定案。它能自動偵測專案的技術堆疊(框架、套件管理器、樣式系統),並從現有程式碼中推斷視覺語言,確保所有產生的變體都與專案風格一致。技能會建立一個暫時的設計實驗室(位於 .claude-design/ 目錄下),其中包含五個有意義區別的 UI 變體、一個互動式回饋系統,以及詳細的設計摘要。在流程結束時,所有暫時檔案都會被自動清理,只留下最終的實作計畫。支援 Next.js、Vite、Remix、Nuxt、Astro 等主流框架,以及 Tailwind CSS、Material UI、Chakra 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:預檢偵測

在開始訪談之前,自動偵測以下項目:

套件管理器

檢查專案根目錄中的 lock 檔案:

  • 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 主題屬性

始終掃描現有元件以了解模式:

  • 找到 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
  • 如果沒有 router:在 App.tsx 中根據查詢參數 ?design_lab=true 建立條件渲染

其他框架: 為偵測到的框架建立最合適的暫時路由。

變體產生指南

重要: 閱讀 DESIGN_PRINCIPLES.md 以了解 UX、互動和動畫的最佳實踐。但不要使用預定義的視覺樣式——從專案中推斷它們。

套用通用原則(來自 DESIGN_PRINCIPLES.md):

  • UX:尼爾森啟發式評估、認知負荷減少、漸進式揭露
  • 元件行為:按鈕狀態、表單結構、卡片結構
  • 互動:回饋模式、狀態處理、樂觀更新
  • 動畫:時機(150-300 毫秒)、緩動(進入用 ease-out,離開用 ease-in)
  • 無障礙:焦點狀態、ARIA 模式、觸控目標(最小 44px)

從專案推斷視覺樣式:

  • 顏色 → 來自 Tailwind 設定、CSS 變數或現有元件
  • 排版 → 來自程式碼庫中現有的標題、內文
  • 間距 → 來自專案的間距比例或現有模式
  • 邊框半徑 → 來自現有的卡片、按鈕、輸入框
  • 陰影 → 來自現有的浮動元件

每個變體必須探索不同的設計軸線。不要建立微小的變化——讓它們具有實質性的區別。所有變體都使用專案現有的視覺語言。

變體 A:資訊層級焦點

  • 重構內容層級(什麼最重要?)
  • 應用格式塔鄰近原則——將相關項目分組在一起
  • 每個視圖一個主要操作
  • 使用現有的排版比例來建立清晰的層級

變體 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

相關技能