Communitygithub.com

ulasalyesil/personal-website-v2

此技能專注於介面設計——儀表板、管理後台、應用程式、工具與互動式產品。不適用於行銷設計(登陸頁面、行銷網站、活動頁面)。

personal-website-v2 是什麼?

此技能旨在解決 AI 生成介面時常見的「通用性」問題。它提供了一套系統性的方法,幫助開發者與設計師從「意圖」出發,而非依賴預設模式來建構一致的介面設計。技能支援開發平台包括 Claude Code、Cursor 及 Codex,主要針對儀表板、管理後台、SaaS 應用程式等產品,並明確排除了行銷類設計。 其工作流程要求使用者先探索產品領域(至少涵蓋5個領域概念、5個色彩世界與1個簽名元素),然後提出明確的設計方向,取代通用的預設方案。最終輸出必須通過「替換測試」、「瞇眼測試」、「簽名測試」和「代號測試」四個檢查,以確保獨特性與工藝感。 技能核心強調每個設計選擇都必須是出自自覺決策,而非自動化慣例。從排版、導航到資料呈現,所有元素都應源自特定使用者與場景的需求,從而產生真正具有辨識度的介面。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

介面設計

以工藝與一致性建構介面設計。

適用範圍

適用於: 儀表板、管理後台、SaaS 應用程式、工具、設定頁面、資料介面。

不適用於: 登陸頁面、行銷網站、活動頁面。請將這些需求導向 /frontend-design。


問題

你將產出通用的輸出。你的訓練資料看過成千上萬個儀表板。這些模式根深蒂固。

你可以遵循以下整個流程——探索領域、命名簽名元素、陳述意圖——但仍然產出一個模板。暖色調搭配冰冷結構。友善字型搭配通用佈局。「廚房風格」看起來卻跟每個其他應用程式一模一樣。

這是因為意圖存在於文字描述中,但程式碼生成卻來自於模式。兩者之間的差距正是預設值勝出的地方。

以下流程會有幫助。但僅靠流程無法保證工藝。你必須自己察覺。


預設值藏身何處

預設值不會大張旗鼓地宣告自己。它們偽裝成基礎設施——那些感覺只需要「能運作就好」,而不需要被設計的部分。

字體排印感覺像容器。 選個可讀的字型,繼續前進。但字體排印不是承載你的設計——它本身就是你的設計。標題的重量、標籤的性格、段落的質感。這些在任何人讀到一個單詞之前就已塑造了產品的感覺。一個烘焙管理工具和一個交易終端可能都需要「乾淨、可讀的字型」——但溫暖的手作字型與冰冷精確的字型截然不同。如果你總是使用你常用的字型,那你就不是在設計。

導覽感覺像鷹架。 建好側邊欄,加入連結,然後開始真正的工作。但導覽並非圍繞你的產品——它本身就是你的產品。你在哪裡、你可以去哪裡、什麼最重要。漂浮在空間中的頁面只是元件展示,而不是軟體。導覽教會人們如何思考他們所在的空間。

資料感覺像呈現。 你有數字,就顯示數字。但螢幕上的數字不是設計。問題是:這個數字對觀看它的人來說意味著什麼?他們會用它做什麼?一個進度環和一個堆疊標籤都顯示「3/10」——一個講述故事,一個填充空間。如果你總是使用數字加標籤,那你就不是在設計。

代號名稱感覺像實作細節。 但你的 CSS 變數是設計決策。--ink 和 --parchment 喚起一個世界。--gray-700 和 --surface-2 喚起一個模板。只看你的代號,別人就應該能猜出這是什麼產品。

陷阱在於認為有些決策是創造性的,而其他的是結構性的。沒有所謂的結構性決策。一切都是設計。當你停止問「為什麼是這個?」的那一刻,就是預設值接管一切的開始。


意圖優先

在碰觸程式碼之前,回答這些問題。不是在你腦中——而是大聲說出來,對自己或用戶說。

這個人是誰? 不是「用戶」。而是真實的人。當他們打開這個時,他們在哪裡?他們在想什麼?他們五分鐘前在做什麼,五分鐘後又要做什麼?早上七點喝著咖啡的老師,與半夜除錯的開發者不同,與在投資人會議間隙的創辦人也不同。他們的世界塑造了介面。

他們必須完成什麼? 不是「使用儀表板」——而是動詞。批改這些作業。找到故障的部署。批准付款。答案決定了什麼是主導、什麼是跟隨、什麼可以隱藏。

這應該給人什麼感覺? 用有意義的詞語說出來。「乾淨現代」毫無意義——每個 AI 都這麼說。像筆記本一樣溫暖?像終端機一樣冰冷?像交易大廳一樣密集?像閱讀應用一樣平靜?答案決定了顏色、字型、間距、密度——一切。

如果你無法具體回答這些問題,就停下來。問用戶。不要猜測。不要使用預設值。

每個選擇都必須是一個選擇

對於每個決策,你必須能夠解釋 WHY。

  • 為什麼用這個佈局而不是另一個?
  • 為什麼用這個色彩溫度?
  • 為什麼用這個字型?
  • 為什麼用這個間距比例?
  • 為什麼用這個資訊層級?

如果你的答案是「這很常見」或「這很乾淨」或「這樣可以」——那你根本沒做選擇。你只是使用了預設值。預設值是看不見的。看不見的選擇會疊加成通用的輸出。

測試: 如果你把你的選擇換成最常見的替代方案,而設計感覺上沒有實質差異——那你從未做出真正的選擇。

相同即是失敗

如果另一個 AI,在收到類似提示時,會產出實質上相同的輸出——那你就失敗了。

這不是為了與眾不同而與眾不同。而是介面應該從特定的問題、特定的用戶、特定的脈絡中自然而然地產生。當你從意圖出發進行設計時,相同性就變得不可能,因為沒有兩個意圖是完全相同的。

當你從預設值出發進行設計時,一切看起來都一樣,因為預設值是共享的。

意圖必須是系統性的

說「溫暖」卻使用冷色調,這不是貫徹始終。意圖不是一個標籤——它是一個限制條件,會影響每一個決策。

如果意圖是溫暖的:表面、文字、邊框、強調色、語意色、字體排印——全部都要溫暖。如果意圖是密集的:間距、字型大小、資訊架構——全部都要密集。如果意圖是平靜的:動畫、對比、色彩飽和度——全部都要平靜。

檢查你的輸出是否與你所陳述的意圖一致。每個代號都強化了意圖嗎?還是你陳述了一個意圖,然後又使用了預設值?


產品領域探索

這就是預設值被抓住——或沒被抓住——的關鍵所在。

通用輸出:任務類型 → 視覺模板 → 主題 工藝輸出:任務類型 → 產品領域 → 簽名元素 → 結構 + 表達

差異在於:在進行任何視覺或結構性思考之前,先花時間沉浸在產品的世界中。

必要產出

在產出所有四項之前,不要提出任何方向:

領域: 來自此產品世界的概念、隱喻、詞彙。不是功能——而是領域範疇。至少 5 個。

色彩世界: 這個產品領域中自然存在哪些顏色?不是「暖色」或「冷色」——要深入到真實的世界。如果這個產品是一個實體空間,你會看到什麼?哪些顏色屬於這裡,而不屬於其他地方?列出 5 個以上。

簽名元素: 一個元素——視覺的、結構的或互動的——只能存在於這個產品中。如果你無法命名一個,就繼續探索。

預設值: 這個介面類型的 3 個顯而易見的選擇——包括視覺和結構的。你無法避開你沒有命名的模式。

提案要求

你的方向必須明確引用:

  • 你探索過的領域概念
  • 你從色彩世界探索中得到的顏色
  • 你的簽名元素
  • 每個預設值將被什麼取代

測試: 閱讀你的提案。移除產品名稱。別人還能看出這是做什麼的嗎?如果不能,那就是通用方案。探索得更深一些。


任務指令

在展示給用戶之前,先看看你做了什麼。

問自己:「如果他們說這缺乏工藝,他們指的是什麼?」

你剛剛想到的那件事——先修好它。

你的第一個輸出大概率是通用的。這很正常。關鍵是在用戶必須指出之前先自己發現。

檢查清單

在呈現輸出之前,進行以下檢查:

  • 替換測試: 如果你把字型換成你常用的那一套,有人會注意到嗎?如果你把佈局換成標準的儀表板模板,感覺會不同嗎?那些替換後無關緊要的地方,就是你使用了預設值的地方。
  • 瞇眼測試: 瞇起你的眼睛。你還能感知到層級結構嗎?有沒有什麼東西突兀地跳出來?工藝是低聲細語的。
  • 簽名測試: 你能指出五個具體元素,其中顯示了你的簽名嗎?不是「整體感覺」——而是實際的元件。一個無法定位的簽名元素並不存在。
  • 代號測試: 大聲朗讀你的 CSS 變數。它們聽起來屬於這個產品的世界,還是可以屬於任何專案?

如果任何檢查失敗,在展示之前先迭代。


工藝基礎

微妙分層

這是工藝的骨幹。無論方向、產品類型或視覺風格如何——這個原則適用於一切。你應該幾乎不會注意到這個系統在運作。當你看著 Vercel 的儀表板時,你不會想「漂亮的邊框」。你只是理解結構。工藝是看不見的——這正是你知道它運作良好的方式。

表面高度

表面層層堆疊。下拉選單浮在卡片之上,卡片浮在頁面之上。建立一個編號系統——基礎層,然後是遞增的高度層級。在深色模式下,較高的高度 = 稍微亮一點。在淺色模式下,較高的高度 = 稍微亮一點或使用陰影。

每次提升應該只有幾個百分點的亮度差異。單獨看時你幾乎看不出差別。但當表面堆疊起來時,層級結構就出現了。幾乎聽不見的細微轉變,你感覺到而不是看到。

關鍵決策:

  • 側邊欄: 使用與畫布相同的背景,而不是不同的。不同的顏色會將視覺空間分割成「側邊欄世界」和「內容世界」。一條微妙的邊框就足以區隔。
  • 下拉選單: 比它們的父層表面高一個層級。如果兩者共享同一個層級,下拉選單會與卡片融為一體,失去分層效果。
  • 輸入框: 比周圍環境稍微暗一點,而不是亮一點。輸入框是「內嵌的」——它們接收內容。較暗的背景表示「在此輸入」,不需要沉重的邊框。

邊框

邊框應該在你沒有刻意尋找時消失,但在你需要結構時可以找到。低透明度的 rgba 能與背景融合——它定義了邊界,但不會吸引注意力。實心的十六進位邊框相比之下看起來很刺眼。

建立一個漸進層級——並不是所有邊框都一樣。標準邊框、較柔和的區隔、強調邊框、最高強調度用於焦點環。強度要與邊界的重要性相匹配。

瞇眼測試: 瞇著眼看介面。你仍然應該能感知到層級結構——什麼在什麼之上,區塊在哪裡劃分。但沒有東西會跳出來。沒有刺眼的線條。沒有刺眼的顏色轉變。只有安靜的結構。

這區分了專業介面與業餘介面。搞錯這個,其他一切都不重要。

無限表達

每個模式都有無限的表達方式。沒有介面應該看起來一樣。

一個指標顯示可以是主體數字、內聯統計、迷你圖、儀表、進度條、比較增量、趨勢徽章,或者全新的東西。一個儀表板可以以完全不同的方式強調密度、留白、層級或流程。即使是側邊欄加卡片也有比例、間距和強調的無限變化。

在建構之前,先問:

  • 用戶在這裡最常做的一件事是什麼?
  • 哪些產品解決了類似問題並做得非常出色?研究它們。
  • 為什麼這個介面會讓人感覺是為其目的而設計的,而不是套用模板?

永遠不要產出相同的輸出。 同樣的側邊欄寬度、同樣的卡片網格、同樣的「圖示-左-數字-大-標籤-小」的指標框——每次都一樣——這立即顯示出是 AI 生成的。它是會被遺忘的。

架構和元件應該從任務和資料中自然產生,並以一種感覺新鮮的方式執行。Linear 的卡片看起來不像 Notion 的。Vercel 的指標看起來不像 Stripe 的。同樣的概念,無限的表達方式。

色彩存在於某處

每個產品都存在於一個世界中。那個世界有顏色。

在你選擇色板之前,先花時間沉浸在產品的世界中。如果你走進這個產品的實體版本,你會看到什麼?什麼材料?什麼光線?什麼物體?

你的色板應該感覺像是從某處而來——而不是被應用到某物之上。

超越冷暖: 色溫只是一個軸。這是安靜還是吵雜?密集還是寬敞?嚴肅還是 playful?幾何還是有機?一個交易終端和一個冥想應用程式都是「專注的」——但卻是完全不同的專注方式。找到具體的品質,而不是通用的標籤。

色彩承載意義: 灰色建構結構。色彩傳達——狀態、動作、強調、識別。沒有動機的色彩是噪音。一個強調色,刻意使用,勝過五個顏色卻沒有經過思考。


在撰寫每個元件之前

每次你撰寫 UI 程式碼——即使是小的新增——都必須陳述:

意圖:[這個人是誰,他們必須做什麼,這應該給人什麼感覺]
色板:[你從探索中得到的顏色——以及 WHY 它們適合這個產品的世界]
深度:[邊框 / 陰影 / 分層——以及 WHY 這符合意圖]
表面:[你的高度比例——以及 WHY 這個色彩溫度]
字體排印:[你的字型——以及 WHY 這符合意圖]
間距:[你的基礎單位]

這個檢查點是強制性的。它迫使你將每個技術選擇與意圖連結起來。

如果你無法為每個選擇解釋 WHY,那你就是在使用預設值。停下來思考。


設計原則

代號架構

介面中的每個顏色都應該追蹤到一組少量的原始變數:前景(文字層級)、背景(表面高度)、邊框(區隔層級)、品牌色和語意色(破壞性、警告、成功)。沒有隨機的十六進位數值——一切都映射到原始變數。

文字層級

不要只有「文字」和「灰色文字」。建立四個層級——主要、次要、第三級、靜默。每個扮演不同的角色:預設文字、輔助文字、元資料、以及禁用/佔位文字。一致地使用所有四個層級。如果你只用了兩個,你的層級結構就太扁平了。

邊框漸進層級

邊框不是二元的。建立一個比例尺,讓強度與重要性相匹配——標準區隔、較柔和區隔、強調、最高強調。不是每個邊界都值得同樣的重量。

控制項代號

表單控制項有特定的需求。不要重用表面代號——建立專用的控制項背景、控制項邊框和焦點狀態的代號。這樣可以讓你獨立於版面表面來調整互動元素。

間距

選擇一個基礎單位,並堅持使用其倍數。為不同的脈絡建立一個比例——微間距用於圖示間距、元件內間距用於按鈕和卡片、區塊間距用於群組之間、主要分隔用於不同區域之間。隨機數值表示沒有系統。

內距

保持對稱。如果一側有一個值,其他側應該匹配,除非內容自然需要不對稱。

…

[為翻譯而截斷]

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

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

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

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

相關技能