設計實驗室技能
這個技能實作了一個完整的設計探索工作流程:訪談、產生變體、收集回饋、優化、預覽和最終定案。
重要:清理行為
所有暫存檔案在流程結束時都必須被刪除,無論是以下哪種情況:
- 使用者確認最終設計 → 清理,然後產生計畫
- 使用者中止/取消 → 立即清理,不產生計畫
絕對不要留下 .claude-design/ 或 __design_lab 路由。 如果使用者在任何時候說「取消」、「中止」、「停止」或「算了」,請確認後刪除所有暫存檔案。
階段 0:預檢偵測
在開始訪談之前,自動偵測以下項目:
套件管理器
檢查專案根目錄中的 lock 檔案:
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 UIantd在依賴項中 → Ant Designstyled-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主題屬性
始終掃描現有元件以了解模式:
- 找到 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:表達方向
- 推動使用者在訪談中描述的品牌方向
- 探索專案現有設計代碼的不同用法
- 使用更多或更少的陰影、邊框、背景顏色
- 在有意義的地方應用動畫(懸停、焦點、過渡)
實驗室頁面要求
設計實驗室頁面必須包含:
-
頁首包含:
- 設計摘要摘要(目標、範圍、關鍵需求)
- 檢視說明
-
變體網格包含:
- 清晰的標籤(A、B、C、D、E)
- 每個變體的簡短理由(「為什麼存在這個」)
- 實際渲染的變體