Communitygithub.com

ulasalyesil/personal-website-v2

产品设计层框架的入门技能——请先加载此技能;它为所有其他相关技能提供上下文。

personal-website-v2 是什么?

该技能是“产品设计层”框架的入门引导,必须在任何设计会话开始时加载。它为所有其他 `/layers-*` 技能提供必要的框架上下文。框架将设计工作组织为七个层,跨越三个区域:现实、问题空间和解决方案空间。每个层具有逻辑依赖性,底层是上层的基础,底层薄弱会产生向上传播的用户体验债务。技能强调设计即决策制定,并提供四种进展类型(做出决策、发现未做决策、评估决策、优先处理决策)。它还包含八个跨所有会话适用的原则、时间维度的探测建议、失败模式信号(如OOOX对象失败模式和尼尔森启发式的根层映射),以及关于工作捕获和Mermaid图表的实用指导。此技能是确保设计会话高效、一致且稳健的基础工具。

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

尼尔森的启发式——根层映射: “系统与现实世界匹配”的违反几乎总是根源于概念模型,而非表层。“用户控制和自由”是一项交互结构决策。在表层修补这些违反只是治标不治本。


捕获工作

在任何设计会话开始时,询问保存产出的位置:

“我应该将本次会话的工作保存到哪里?推荐的设置是项目中的一个 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

相关技能