Communitygithub.com

ulasalyesil/personal-website-v2

產品設計層框架導向 —— 請優先載入此技能;它提供所有其他技能依賴的上下文脈絡。

personal-website-v2 是什麼?

此技能為「產品設計層次框架」(Layers of Product Design) 的基礎引導,應在任何設計階段開始時優先載入。它將設計工作組織為三個區域中的七個層次,從「現實」(Reality)、「問題空間」(Problem Space) 到「解決方案空間」(Solution Space),各層具有邏輯依賴性:下層是上層的基礎,薄弱的下層會產生向上傳播的使用者體驗債務。技能強調設計的本質是決策制定,並定義了四種進展類型:做出決策、發現未做的決策、評估決策、排定優先順序。此外,還涵蓋時間維度的常見疏漏(如過渡狀態、讀模型延遲、樂觀/悲觀更新)以及故障模式信號(如變形人、偽裝、破碎、孤立物件),並提供與 Nielsen 啟發式的根層次對應。最後引導使用者選擇輸出格式(Mermaid 圖、Notion 或對話記錄),並建議從 `/layers-orient` 或直接進入對應層次技能開始工作。

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

在你喜歡的 AI 中提問

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

說明文件

/layers-intro

請在任何設計階段開始時載入此技能。它提供所有其他 /layers-* 技能依賴的框架上下文。


框架

產品設計層次將設計工作組織為三個區域中的七個層次。層次之間具有邏輯依賴性:下層是上層的基礎。薄弱的下層會產生向上傳播的使用者體驗債務。

現實 —— 複雜、矛盾、不斷演進。所有學習的來源。

問題空間 —— 從現實中收集的知識:

  1. 觀察到的行為 —— 使用者實際做什麼
  2. 領域 —— 獨立於任何產品存在的概念、術語與心智模型
  3. 使用者需求 —— 我們認為使用者試圖達成什麼及其原因

解決方案空間 —— 關於建構什麼的審慎決策: 4. 產品與服務策略 —— 服務哪些需求,以及瞄準哪些業務成果 5. 概念模型 —— 物件、關係、狀態、詞彙 —— 獨立於任何介面 6. 互動結構與流程 —— 位置、可供性、連接與流程邏輯 7. 表面 —— 文字、視覺、回饋、層級 —— 使用者實際接觸到的部分

這些層次並非線性流程。你可以從任何地方進入 —— 但務必檢查下層基礎是否穩固。

靈感來自 Jesse James Garrett 的《使用者體驗要素》(2000 年)。


設計就是決策制定

設計 = 對解決方案的形式做出決策 (Christopher Alexander)。形式是解決方案;脈絡是它必須符合的需求、限制與環境。好的設計就是好的符合。

四種進展類型:

  1. 做出決策 —— 解決未決定的事
  2. 發現未做的決策 —— 發現尚未決定的事(通常比第 1 項更有價值)
  3. 評估決策 —— 識別已做出的決策中哪些有風險、不一致或錯誤
  4. 排定優先順序 —— 下層更基礎,如果出錯風險也更高

每個技能的任務是幫助設計師做出更好的決策 —— 而不是替他們做決策。


原則 —— 適用於所有階段

  1. 決策,而非產出。 文件僅在它代表已做出或浮現的決策時才有用。說出決策名稱,而不只是圖表。
  2. 先發現,再解決。 浮現設計師不知道他們需要做的決策,通常比回答他們已知的決策更有價值。
  3. 一次只處理一個層次。 混淆問題空間與解決方案空間,或表面與概念模型,會產生混亂的產出。
  4. 往上建構前先檢查基礎。 在處理上層之前,先審查下層。標記不穩定的部分。
  5. 概念模型是最常被忽略的承重層。 給予它比感覺舒適更多的關注。
  6. 標記錯誤決策,而不只是遺漏的決策。 已做出的決策如果有風險或不一致,需要被點名,而不是繞過去。
  7. 主導,不要被牽著走。 在基礎決策完成之前,不要跳到表面輸出。
  8. 設計原則 vs. 實作決策。 有些決策可以在不知道系統限制的情況下陳述 —— 從使用者角度應該發生什麼。其他決策則與實作糾纏:闡述使用者體驗需求,形成一個明確的問題,然後帶入設計+工程的對話。不要強求過早的答案。

時間維度 —— 主動探查

時間相關的決策常被忽略。它們集中在兩個層次:

概念模型層:

  • 中間動作狀態 —— 物件是否會經歷過渡狀態(儲存中、處理中、待審核)才解決?這些是模型狀態。
  • 讀模型延遲 —— 資料寫入到可見之間的時間差?闡述使用者需求,並標記為一個待解決的問題給工程團隊。
  • 關係時間性 —— 「歐洲所有產品」是指當下的群組,還是隨時間變動的成員?這是一個設計決策。
  • 刪除語義 —— 封存、垃圾桶、永久刪除或法規刪除?說明哪一種及其原因。實作隨後跟上。
  • 歷史記錄 —— 物件過去的狀態是否重要?說明它重要本身就是一個設計決策。

互動結構層:

  • 動作後狀態 —— 提交後使用者看到什麼?重新導向的列表是否立即反映變更?
  • 樂觀 vs. 悲觀更新 —— 在伺服器確認前顯示假設結果,還是等待?說明偏好;如果實作不確定,則標記為待解決問題。
  • 空狀態、載入狀態、部分狀態 —— 每個位置都有時間上的生命週期。設計所有這些狀態。
  • 錯誤與失敗路徑 —— 驗證失敗、伺服器錯誤、網路斷線、並行編輯。這些是必需的設計步驟,而非事後才想。

故障模式信號

OOUX 物件故障模式 (Sophia Prater):

  • 變形人 —— 同一個物件在不同脈絡中以顯著不同的形式出現。表面修復:一致的物件處理。更深層的修復:如果模型沒有明確定義該物件。
  • 偽裝 —— 不同的物件類型看起來一模一樣。表面修復:不同的視覺處理。更深層的修復:如果模型沒有區分它們。
  • 破碎 —— 物件的資料與動作分散在各畫面中,沒有交叉連結。互動結構問題 → /layers-interaction-flow。
  • 孤立 —— 物件存在但與其他物件之間沒有可見的關係。概念模型問題 → /layers-conceptual-model。

Nielsen 啟發式 —— 根層次對應: 「系統與真實世界之間的匹配」違規幾乎總是根源於概念模型,而非表面。「使用者控制與自由」則是互動結構的決策。在表面修補這些問題只是處理症狀,而非原因。


記錄工作

在任何設計階段開始時,詢問要將輸出儲存在哪裡:

「我應該將本次階段的工作捕捉到哪裡?建議是在你的專案中建立一個 Markdown 檔案 —— 圖表以內嵌 Mermaid 撰寫,並可在 VSCode 中透過 Markdown Preview Mermaid Support 擴充功能原生渲染。其他選擇:

  • Notion —— 如果你已連接 Notion MCP
  • 僅保留在對話中 —— 不需檔案」

在階段結束時將摘要儲存到選擇的目的地。

撰寫 Mermaid 圖表時,節點標籤內的換行請使用 <br/> —— 不要使用 \n,因為它會顯示為文字字串。


從哪裡開始

  • 不確定該專注在哪裡? → /layers-orient —— 快速診斷所有七個層次
  • 知道目前位於哪個層次? → 直接跳到對應的技能

技能:/layers-observed-behaviour · /layers-domain · /layers-user-needs · /layers-product-strategy · /layers-conceptual-model · /layers-interaction-flow · /layers-surface

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

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

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

相關技能