Communitygithub.com

Ulasalyesil/个人网站-v2

定义产品的对象、关系、状态和词汇,独立于任何界面——这是最关键的承重层。

个人网站-v2 是什么?

该技能聚焦于概念模型(Conceptual Model),这是产品架构中常被忽视但至关重要的承重层。它旨在帮助开发者或产品设计师,在脱离具体界面设计的情况下,明确产品需要识别哪些对象(Objects)、它们之间的关系(Relationships)、可能的状态(States)以及统一的词汇表(Vocabulary)。与仅捕获用户现有混乱心智模型的领域层不同,这个模型是解决方案空间中的**设计决策**,需要将混乱的领域重塑为清晰、有主见的结构。该技能支持从研究笔记、现有产品逆向工程或第一性原理出发,通过名词搜寻(Noun Foraging)、事件风暴(Event Storming)等方法定义对象。其核心产出包括对象定义、对象关系图(ER图)、状态转换图以及统一语言(Ubiquitous Language),旨在减少用户体验债务和技术债务,确保从设计到实现的连贯性。

兼容平台~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-conceptual-model

假设已加载 /layers-intro 以获取框架上下文。

概念模型是最常被忽视的承重层。它定义了产品认识的对象、它们之间的关系、它们可以处于什么状态以及用于所有内容的词汇表。它存在于解决方案空间:它不是对用户现有心智模型(这些模型是矛盾且混乱的——那是领域层的职责)的捕获,而是关于产品将如何建模其领域的刻意设计决策。

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

  • 一个设计决策,将混乱的领域解析为连贯的、有主见的结构
  • 不是数据库模式 —— 工程师自己做数据决策,但这个模型与他们所构建内容之间的差距很重要。一个未被审视的巨大差距既是UX债务(用户遇到与模型矛盾的产品)也是技术债务(系统更难演进)。
  • 不是线框图或流程图 —— 没有屏幕,没有导航。那些属于上面的层。
  • 不是中立的 —— 每一个命名决策,每一个关系边界,每一个包含或排除的对象都反映了一个观点。

这一层需要做出的决策:

  • 该产品将识别哪些对象,它们的边界是什么?
  • 这些对象如何相互关联?
  • 用户可以对每个对象做什么?
  • 每个对象可以处于什么状态,哪些转换是重要的?
  • 产品的词汇表是什么 —— 每个概念一个名称,选择并坚持使用?

方法:

方法使用时机
名词搜寻 + OOUX (Sophia Prater)默认方法,当你已有研究或领域笔记可供挖掘时。从自然语言中提取对象。
语义交互设计 / 动作语法 (Daniel Rosenberg)当你在许多对象上有许多动作,并希望审计动词的一致性和精确性时。
事件风暴 —— 命令/策略阶段 (Brandolini)领域有复杂流程时。从发生的事情开始,反向推导到涉及的对象。
卡片分类当词汇表在用户或团队之间不明确或存在争议时。
DDD限界上下文映射当多种用户类型以不同方式使用相同词语时 —— 揭示模型自然而然的接缝所在。
审视现有产品在重新设计时。现有UI揭示了隐含模型 —— 将其与用户的真实思考方式进行比较。

默认:名词搜寻和对象定义。

质量信号 —— 好的表现:

  • 每个对象对用户来说都是独立有意义的 —— 不是UI元素,也不是模糊的抽象
  • 当一个对象可以扮演多个角色时,关系角色被显式命名
  • 本质上是关系的属性已被质疑和转换
  • 没有投机性添加 —— 每个对象、属性和关系都可追溯到用户需求
  • 状态转换是为那些状态改变会实质性影响用户操作能力的对象定义的
  • 时间性决策已处理:删除语义、关系时间性、历史
  • 统一语言已建立:每个概念一个名称,每个名称一个概念

引导式会话

告诉我您正在为哪个产品或功能定义模型,或者说 "引导我" 来开始名词搜寻和对象定义。

询问:"我应该将会话的成果保存在哪里?"(关于选项,请参阅 /layers-intro)

检查设计者从问题空间获得了什么 —— 领域笔记、研究、用户需求。如果什么都没有:继续进行但要标记,一个没有领域知识构建的模型往往更多地反映假设而非用户的现实。

如果是重新设计:"描述当前模型,即使是非正式的 —— 现有产品的隐含模型是什么?"


第一阶段 —— 界定范围

  1. 我们要为哪个产品或功能定义概念模型?
  2. 用户使用它的核心工作是什么?
  3. 你有哪些可用的素材?

第二阶段 —— 发现对象

从研究或领域笔记出发: 提取每个名词 —— 事物、人、角色、文档、地点、状态、概念、事件。铺开范围;暂时不要筛选。展示原始列表,然后询问:缺少名词吗?相同的事物有不同的名称吗?

从现有产品出发: 一起审视它。"用户在这里看什么?这个东西叫什么?"

从第一性原理出发: "如果一个用户能够伸手把某个东西交给同事,他们会交什么?"

分类为:

  • 对象 —— 持续存在、拥有自己的属性并且对用户自身有意义的事物
  • 属性 —— 描述对象的性质,而不是对象本身
  • 搁置一旁 —— UI元素、模糊的抽象、伪装成名词的动作

一个真正的对象必须对用户是独立有意义的,而不仅仅是其他事物的属性。

第三阶段 —— 定义每个对象

逐一处理核心对象:

对象:[名称]
它是什么:[从用户角度用一句话描述]
属性:[用户知道或关心的性质]
关系:[与其他对象的连接 —— 基数和角色名称]
动作(CTA):[用户可以对或与这个对象做什么]

四项纪律检查:

  1. 关系角色: 当一个关系连接到一个可以扮演多个角色的对象(例如,一个用户既是推荐人又是被推荐人)时,显式命名该角色:"属于一个用户(作为推荐人)" 而不是 "属于一个用户"。

  2. 本质上是关系的属性: 如果一个属性只是模型中另一个对象的名称或ID,那么它就是关系 —— 建模它,不要将其作为属性重复。

  3. 没有投机性添加: 不要添加没有基于所述用户需求的属性、关系或动作。概念模型层的作用域蔓延会传播到上面的每一层。

  4. 实现 vs. 设计决策: 当对话转向某物如何生成、存储或计算时 —— 引导:"它如何生成是工程问题。这里重要的是:用户可以改变这个吗?那些已经引用了它的东西会怎么样?"

  5. 动词精确性: 对于每个动作,要问这个动词是否告诉用户他们会得到什么或者他们在执行什么现实世界操作。"输入PIN码" 失败了,因为它暗示PIN码已经存在 —— "创建" 才精确。更关键的是:检查一个泛动词(编辑、删除、更新)是否隐藏了具有完全不同现实世界后果的操作。"编辑地址" 混淆了纠正打字错误与记录搬家 —— 两种操作,一个保留历史记录,一个不保留,需要不同的系统行为和不同的用户意图。一个演绎界面使用泛动词并要求用户将他们的意图映射到其上;一个归纳界面命名现实世界操作("登记地址变更")并保留其含义。当一个泛动词根据用户实际尝试做的事情可能意味着不同的事情时,分别命名这些操作。

第四阶段 —— 对象图

生成一个关系对象图:实体作为节点,关系作为带有基数标记的标注线。没有固定方向 —— 遵循使关系最易读的方式。在Mermaid中:erDiagram。

呈现时,解释基数:|| = 恰好一个,o{ = 零个或多个,|{ = 一个或多个。乌鸦脚总是在 "多" 侧。关系标签按声明的方向读取(第一个实体 → 第二个实体)。

询问:"这反映了你如何看待这些事物吗?关系缺失、方向颠倒、不该存在的连接?"

第五阶段 —— 状态转换和时间性决策

对于每个生命周期或状态重要的对象:"一个[对象]可以处于什么状态?是什么让它从一个状态移动到另一个?在每个状态下什么变得不可能?"

生成一个状态图:状态作为节点,转换作为标注箭头,并有一个明确的起始状态。根据状态数量采用从上到下或从左到右布局。在Mermaid中:stateDiagram-v2。

同时探究时间性决策(来自 /layers-intro):中间动作状态、读模型延迟、关系时间性、删除语义、历史。对于与实现纠缠的问题,不要强迫过早的答案 —— 阐明用户体验需求,并将其标记为一个用于工程对话的具名开放问题。

第六阶段 —— 统一语言

统一语言涵盖名词(对象、属性)和动词(动作)。同样的原则适用于两者:每个概念一个词,每个词一个概念。

名词: 列出每个选定的对象和属性名称。对于任何具有同义词或命名冲突的名词:

术语:[选定的名称]
已拒绝的替代选项:[出现的其他名称]
决策:[为什么选择这个术语]

动词 —— 动作词汇: 编译所有对象上的所有动作动词。应用两个测试:

同义词检查: 多个动词是否用于相同的操作?对于相同的动作类型,“创建”和“添加”应当合并。最小化动词词汇量减少了用户需要学习的内容 —— 相同的动词在所有对象上以相同方式工作(如剪切/复制/粘贴)意味着用户学习一次就能到处迁移。每个同义词都是一个需要记忆的新事物。

扁平化检查: 相反的风险 —— 一个动词涵盖了真正不同的操作。“编辑地址”听起来很简单,直到你意识到它混淆了两件事:纠正打字错误(覆盖即可)和记录搬家(应该创建新记录并保留旧记录)。领域对这些操作区分对待;界面不应掩盖这一点。对于每个泛CRUD动词(编辑、删除、更新、创建),询问:它是否可能涵盖具有不同现实世界后果的操作 —— 不同的历史记录影响、不同的下游效应、用户实际尝试完成的不同事情?如果是,给它们分别命名。“登记地址变更”和“纠正地址”并不冗长 —— 它们很精确。

动词:[选定的动作名称]
适用于:[哪些对象]
已拒绝的替代选项:[考虑过的其他动词]
决策:[为什么选这个动词;它命名了什么现实世界操作]

"这就是你产品的统一语言。一致地使用这些术语 —— 在UI中、在帮助文本中、在API名称中、在内部对话中。这个模型与表面之间的每个不一致都会给用户带来认知负荷。"


完成

产出:

  1. 对象定义 —— 属性、关系和动作
  2. 对象图 —— erDiagram
  3. 状态转换图 —— 对于具有有意义生命周期的对象
  4. 统一语言 —— 选定的名词和动词,附带已解决的冲突和决策
  5. 开放问题 —— 延迟决策、感觉薄弱的对象、任何已标记但未解决的事项

结束语:"概念模型定义了该产品中存在什么。下一步:设计用户如何与这些对象交互。运行 /layers-interaction-flow。"

如果领域工作尚未完成:"这个模型是在没有领域研究的情况下构建的 —— 它是一个假设。一旦你有证据,计划重新审视它。"

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

相关技能