Communitygithub.com

ulasalyesil/個人網站-v2

定義產品的物件、關係、狀態與詞彙,獨立於任何介面——這是最承重的層級。

個人網站-v2 是什麼?

這項技能專注於構建「概念模型」(Conceptual Model),這是多層架構中最關鍵但最常被忽略的基礎層。它負責定義產品認可的物件、它們之間的關係、可處於的狀態,以及所有使用的詞彙,所有這些都獨立於任何使用者介面或實作細節。此模型並非捕捉使用者混亂的心智模型(那是領域層的工作),而是針對產品如何建模其領域所做的刻意設計決策。 此技能提供了一整套方法論,包括「名詞覓食(Noun Foraging)」、「事件風暴(Event Storming)」、「卡片分類(Card Sorting)」以及「領域驅動設計(DDD)的限制上下文對應(Bounded Context Mapping)」,以引導使用者從頭開始建立模型或改造現有產品。它還包含一個六階段的引導工作坊,用以發掘物件、定義屬性與關係、建立關係圖、處理狀態轉換、制定詞彙,最後產出物件定義、關聯圖、狀態圖以及一份統一的語言詞彙表。這套架構讓開發者與設計師在開始繪製線框圖或編寫程式碼之前,就能確保對產品領域有共同且清晰的理解。

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

在你喜歡的 AI 中提問

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

說明文件

/layers-概念模型

假設已載入 /layers-簡介 以取得框架背景。

概念模型是最常被忽略的承重層。它定義了產品能識別的物件、物件間的關係、物件可能的狀態,以及所有事物所使用的詞彙。它存在於解決方案空間:它不是捕捉使用者現有的心智模型(心智模型是矛盾且混亂的——那是領域層的工作),而是一個關於產品將如何建模其領域的刻意設計決策。

它是什麼——以及不是什麼:

  • 一個設計決策,將混亂的領域轉化為一致且有主見的結構
  • 不是資料庫綱要——工程師會自行決定資料,但此模型與其實作之間的差距至關重要。一個巨大且未經檢驗的差距既是 UX 債(使用者遇到與模型矛盾的產品),也是技術債(系統更難以演進)。
  • 不是線框圖或流程——沒有畫面,沒有導覽。那些屬於上層。
  • 不是中立的——每一個命名決策、每一個關係邊界、每一個包含或排除的物件,都反映了一個觀點。

此層需要做出的決策:

  • 這個產品將識別哪些物件,它們的邊界是什麼?
  • 這些物件彼此之間如何關聯?
  • 使用者可以對每個物件做什麼?
  • 每個物件可以處於哪些狀態,哪些轉換是重要的?
  • 產品的詞彙是什麼——每個概念一個名稱,並選擇且堅持使用?

方法:

方法使用時機
名詞覓食 + OOUX (Sophia Prater)當你有研究或領域筆記可挖掘時的預設方法。從自然語言中提取物件。
語義互動設計 / 動作語法 (Daniel Rosenberg)當你跨多個物件有許多動作,並想稽核動詞的一致性和精確性時。
事件風暴——指令/策略階段 (Brandolini)當領域有複雜流程時。從發生的事件開始,反向推導出涉及的物件。
卡片分類當詞彙在使用者或團隊之間不明確或有爭議時。
DDD 限制上下文對應當不同使用者類型使用相同詞彙但意義不同時——可以顯現模型中的自然接縫。
走查現有產品進行重新設計時。現有 UI 會揭露隱含的模型——比較它與使用者實際思考方式。

預設方法:名詞覓食與物件定義。

品質訊號——什麼是好的表現:

  • 每個物件對使用者來說都是獨立有意義的——不是 UI 元素,不是模糊的抽象概念
  • 當一個物件可以扮演多種角色時,關係角色被明確命名
  • 被發現其實是關係的屬性已被挑戰並轉換
  • 沒有投機性的添加——每個物件、屬性和關係都追溯到一個使用者需求
  • 對於那些狀態會實質改變使用者能做什麼的物件,定義了狀態轉換
  • 時間性決策已被處理:刪除語意、關係時間性、歷史記錄
  • 建立了共通語言:每個概念一個名稱,每個名稱一個概念

引導工作坊

告訴我你要為哪個產品或功能定義模型,或者說「引導我」來開始名詞覓食和物件定義。

提問:「我要把這次工作坊的成果記錄在哪裡?」(關於選項,請參閱 /layers-簡介)

檢查設計師從問題空間取得的資料——領域筆記、研究、使用者需求。如果毫無資料:繼續進行,但請標記出一個在沒有領域知識下建立的模型,通常反映的是假設而非使用者的現實。

如果是重新設計:「描述現有的模型,即使是非正式的——現有產品隱含了什麼樣的模型?」


階段 1 — 界定範圍

  1. 我們要為哪個產品或功能定義概念模型?
  2. 使用者想要用它完成的核心工作是什麼?
  3. 你有哪些可用的資料?

階段 2 — 發掘物件

從研究或領域筆記中: 提取每一個名詞——事物、人物、角色、文件、地點、狀態、概念、事件。盡可能廣泛地收集;暫時不要過濾。呈現原始清單,然後提問:遺漏了哪些名詞?有不同名稱但實質相同的東西嗎?

從現有產品中: 一起走查它。「使用者現在在看什麼?這個東西叫什麼?」

從第一原則出發: 「如果使用者能伸手從產品中拿出某樣東西遞給同事,他們會遞出什麼?」

分類為:

  • 物件——持續存在、擁有自己的屬性、且對使用者本身有意義的事物
  • 屬性——描述物件的特性,而不是物件本身
  • 暫放——UI 元素、模糊的抽象概念、偽裝成名詞的動作

一個真正的物件必須對使用者是獨立有意義的,而不僅僅是其他東西的屬性。

階段 3 — 定義每個物件

逐一處理每個核心物件:

物件:[名稱]
它是什麼:[從使用者角度的一句描述]
屬性:[使用者知道或關心的特性]
關係:[與其他物件的連線——基數和角色名稱]
動作(呼籲行動):[使用者可以對這個物件做什麼]

四項紀律檢查:

  1. 關係角色: 當一個關係連接到一個可以扮演多種角色的物件(例如一個使用者既是推薦人也是被推薦人),請明確命名角色:「屬於一個使用者(作為推薦人)」而非「屬於一個使用者」。

  2. 其實是關係的屬性: 如果一個屬性只是模型中另一個物件的名稱或 ID,它就是一個關係——建模它,不要把它複製為屬性。

  3. 沒有投機性的添加: 不要添加未基於陳述的使用者需求的屬性、關係或動作。概念模型層的範圍蔓延會傳播到上面的每一層。

  4. 實作 vs. 設計決策: 當對話偏離到某事物如何產生、儲存或計算時——引導回來:「如何產生是工程問題。這裡重要的是:使用者能改變這個嗎?已經引用它的東西會發生什麼事?」

  5. 動詞精確性: 對於每個動作,問這個動詞是否告訴使用者他們最終會得到什麼,或者他們正在執行什麼真實世界的操作。「輸入 PIN 碼」失敗,因為它暗示 PIN 碼已經存在——「建立」是精確的。更關鍵的是:檢查一個通用動詞(編輯、刪除、更新)是否隱含了具有完全不同真實世界後果的操作。「編輯地址」將修正打字錯誤與記錄搬家混為一談——前者保留歷史記錄,後者則否,需要不同的系統行為和使用者意圖。一個演繹式介面使用通用動詞,要求使用者將意圖映射到它們上;一個歸納式介面則命名真實世界的操作(「登記地址變更」)並保留其意義。當一個通用動詞可能根據使用者實際想做的事而代表不同的意義時,請分別命名這些操作。

階段 4 — 物件圖

產生一個關聯式物件圖:實體作為節點,關係作為帶有基數標記的標籤線。沒有固定方向——遵循最能讓關係清晰可讀的配置。使用 Mermaid:erDiagram。

呈現時,解釋基數:|| = 恰好一個,o{ = 零或多個,|{ = 一個或多個。烏鴉腳永遠在「多」的那一端。關係標籤按照宣告的方向閱讀(第一個實體 → 第二個實體)。

提問:「這反映了你對這些事物的看法嗎?有遺漏的關係、方向相反的、不該存在的連結嗎?」

階段 5 — 狀態轉換與時間性決策

對於每個生命週期或狀態重要的物件:「一個 [物件] 可以處於哪些狀態?什麼使它從一個狀態移動到另一個狀態?在每個狀態下,哪些事情變得不可能?」

產生一個狀態圖:狀態作為節點,轉換作為帶有標籤的箭頭,並有一個明確的起始狀態。根據狀態數量,採用從上到下或從左到右的配置。使用 Mermaid:stateDiagram-v2。

同時探討時間性決策(來自 /layers-簡介):中間動作狀態、讀取模型延遲、關係時間性、刪除語意、歷史記錄。對於與實作糾纏的問題,不要強迫給出過早的答案——闡明使用者體驗需求,並將其標記為一個待解決的命名問題,以待後續與工程團隊討論。

階段 6 — 共通語言

共通語言涵蓋名詞(物件、屬性)和動詞(動作)。同樣的原則適用於兩者:每個概念一個詞彙,每個詞彙一個概念。

名詞: 列出每個選擇的物件和屬性名稱。對於任何存在同義詞或命名衝突的名詞:

詞彙:[選擇的名稱]
被拒絕的替代方案:[其他出現過的名稱]
決策:[為何選擇這個詞彙]

動詞——動作詞彙: 編譯所有跨所有物件的動作動詞。應用兩個測試:

同義詞檢查: 是否使用了多個動詞來表示相同的操作?對於「建立」和「新增」這類相同動作類型的詞應該合併。最小化動詞詞彙減少使用者需要學習的東西——相同的動詞在所有物件上一致運作(如剪下/複製/貼上)表示使用者只需學習一次即可到處應用。每個同義詞都是一個新的需記憶項目。

扁平化檢查: 相反的風險——一個動詞涵蓋了本質上不同的操作。「編輯地址」聽起來很簡單,直到你意識到它混淆了兩件事:修正打字錯誤(覆寫即可)和記錄搬家(應該建立一個新記錄並保留舊記錄)。領域對這兩者的處理方式不同;介面不應隱藏這一點。對於每個通用的 CRUD 動詞(編輯、刪除、更新、建立),問:它是否可能涵蓋具有不同真實世界後果的操作——不同的歷史記錄影響、不同的下游效應、使用者實際想完成的不同事情?如果是,給它們各自的名稱。「登記地址變更」和「修正地址」並不冗長——它們是精確的。

動詞:[選擇的動作名稱]
適用於:[哪些物件]
被拒絕的替代方案:[其他考慮過的動詞]
決策:[為何選擇這個動詞;它命名了哪個真實世界的操作]

「這是你的產品的共通語言。在 UI、說明文字、API 名稱和內部對話中一致地使用這些詞彙。這個模型與表層之間的每一個不一致,都會為使用者增加認知負擔。」


完成

產出:

  1. 物件定義——屬性、關係和動作
  2. 物件圖——erDiagram
  3. 狀態轉換圖——針對具有意義生命週期的物件
  4. 共通語言——已選擇的名詞和動詞,並附有解決的衝突和決策
  5. 待解決問題——延遲的決策、感覺薄弱的物件、任何被標記但未解決的事項

結束語:「概念模型定義了這個產品中存在的事物。下一步:設計使用者如何與這些物件互動。執行 /layers-互動流程。」

如果尚未進行領域研究:「這個模型是在沒有領域研究的情況下建立的——它是一個假設。一旦你有了證據,請計劃重新審視它。」

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

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

相關技能