Communitygithub.com

ulasalyesil/personal-website-v2

审核现有界面是否与底层决策一致,并生成界面决策清单——包括词汇、对象一致性、完整性、反馈、层级结构和可访问性。

personal-website-v2 是什么?

该技能专注于审核和指导用户界面(表层)的设计决策,确保其与通过“/layers-intro”引入的底层框架决策(如概念模型、交互流程等)保持一致。它帮助开发者或设计师识别界面中的问题,区分哪些可以在表层直接修复,哪些需要回溯到更底层。此技能支持任何类型的界面媒介,包括屏幕UI、语音界面、物理设备等。技能分为“审核”和“决策清单”两部分,通过系统化的阶段(共10个阶段),逐一检查词汇一致性、对象表现、完整性、情绪基调、反馈机制、视觉层级、可访问性、一致性等关键维度。最终输出审核发现、待办决策列表和跨层问题列表,确保表层设计忠实于整体产品策略。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/layers-surface

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

表层是将下层所有决策转化为用户实际体验的层面:文字、声音、视觉、物理触感、动效、反馈。这是最特定于媒介的层面,但首要做出的最重要决策是通用的——无论表层是屏幕、语音界面、物理设备还是服务触点,这些决策都适用。

表层问题通常是深层问题的症状。此技能区分可以在表层修复的问题和需要重新审视下层的问题。

该层面需要做出的决策:

  • 表层是否尊重概念模型中的词汇和对象?
  • 面包板中的每个功能是否都存在——是否存在没有模型支撑的表层内容?
  • 表层是否传达了用户完成工作所需的正确情绪基调?
  • 用户如何知道发生了什么、正在进行什么、以及哪里出错了?
  • 什么是最突出的,应该如此吗?
  • 每条信息是否对需要它的用户可访问?

方法:

方法适用场景
直接在真实媒介中工作(代码、生产环境UI)当你需要真实交互的真实反馈时。避免原型图与实际使用行为之间的差距。
高保真原型(Figma 等)探索布局、视觉层级和视觉形式——尤其适用于新颖模式或利益相关者对齐。
设计系统/组件库当产品具有已建立的组件和设计令牌时。表层决策必须扩展系统,而非与之矛盾。
风格瓷砖早期建立视觉语言,无需限定布局。比高保真原型更快,用于初始基调对齐。
原型测试交互行为——过渡、反馈时机、流程——静态原型无法传达的内容。
文案优先当语言是主要设计材料时——消息传递、引导流程、错误状态。先写文案,再设计容器。

质量信号——好的表层决策应具备的特征:

  • 每个术语与概念模型中的通用语言匹配
  • 每个对象在不同上下文中具有一致的表示——不是变形者,不戴面具
  • 面包板中的每个功能都存在;每个表层元素都有模型支撑
  • 情绪基调与用户需求中的情绪和社交任务匹配
  • 错误消息做三件事:诊断(发生了什么)、解释(为什么)、恢复(下一步做什么)。“出了点问题”这三件事都没做到
  • 突出程度反映重要性——流程需要用户注意的内容就是突出的内容
  • 可访问性决策是明确做出的,而不是留作默认设置

引导式会话

此技能分为两部分。请告诉我你需要什么:

  • 审核 —— 评估现有表层工作与下层决策的一致性(阶段 1–5)
  • 决策清单 —— 处理未决的表层决策(阶段 6–10)

描述你已有的内容,或者说“引导我”开始。

提问:“会话中的工作应记录在哪里?”(参见 /layers-intro 获取选项)

提问:

  1. 我们正在处理什么产品或功能?
  2. 什么媒介——屏幕UI、语音/对话式、物理设备、服务触点?
  3. 你已有下层哪些内容?概念模型(对象 + 通用语言)?面包板或流程图?包含情绪和社交任务的用户故事?

第一部分 — 审核

阶段 1 — 定义表层框架

现有的表层工作是否存在——工作代码、已部署的UI、文案、视觉设计?或者表层尚未开始?如果尚未开始,跳至第二部分。

阶段 2 — 词汇和语言

取出概念模型中的通用语言列表。请设计师分享表层文案——标签、标题、按钮文字、错误消息、通知、帮助文本。

检查每个术语。标记:

  • 直接违规 —— 模型术语使用错误或不一致(在一处使用“账户”,另一处使用“工作空间”)
  • 未列表的术语 —— 表层上出现但不在通用语言中的词语。是需添加到模型的新术语,还是表层噪音?
  • 基调不匹配 —— 技术上正确但情绪基调与情绪/社交任务不符

对于每个违规:是表层修复(重写文案)还是深层修复(更新概念模型词汇)?

阶段 3 — 对象一致性

对于概念模型中的每个对象:它在表层上出现在哪里?以多少种形式出现?

  • 变形者 —— 同一对象在不同上下文中以显著不同的视觉或结构形式出现
  • 蒙面对象 —— 对象以用户无法识别其为该对象类型的形式出现

对于每个:这是表层决策(建立一致的处理方式)还是概念模型问题(即使在模型中对象的身份也不清晰)?

阶段 4 — 完整性检查

取出面包板。对于每个位置和功能:

  • 面包板中的每个功能是否都存在于表层?
  • 是否存在没有对应面包板元素的表层内容?

未在面包板中的新增内容通常是交互层决策的遗漏——标记它们并建议重新审视 /layers-interaction-flow。

阶段 5 — 情绪基调

回到用户故事,特别是情绪和社交任务。

“用户在此处正在完成什么情绪任务——不仅是功能任务,还有他们希望如何感受?” “涉及什么社交任务——他们希望如何被看待?”

常见不匹配:

  • 表层强调产品收益(“我们获得推荐”)而非用户任务(“我帮助同事”)
  • 文案将交互表述为交易性,但用户的任务是关系性的
  • 當用户需要安心或自信时,基调显得专业/临床

第二部分 — 决策清单

阶段 6 — 反馈和错误

对于每个重要操作和状态转换:

  • “用户如何知道他们的操作成功了?”
  • “用户如何知道某事正在进行中?”
  • “用户如何知道某事出错了,以及该怎么做?”

错误消息必须诊断、解释并告诉用户下一步做什么。标记每个不满足所有三点的错误状态。为每个差距生成决策:“我们需要决定如何向用户传达 [X]。选项有 [Y]。”

阶段 7 — 层级和强调

对于每个关键位置:

  • “用户需要注意到或在此处操作的最重要的事情是什么?”
  • “当前表层是否使该内容最突出?”
  • “是否有不应该突出的内容在视觉上很突出?”

这些首先是媒介无关的决策(什么应该是主要的),然后才是媒介特定的决策(如何在视觉、听觉或触觉上使其突出)。

阶段 8 — 可访问性

标记与声明的媒介相关的注意事项:

  • 屏幕UI: 颜色对比度、文本大小、触摸目标、键盘导航、交互元素和图像的屏幕阅读器标签、流程步骤中的焦点管理
  • 语音/对话式: 所有信息通过口头传达(没有“点击左侧按钮”),无需视觉上下文的错误恢复
  • 物理设备: 可达性、触觉区分、不同光照下的可见性、无需精细运动技能的操作

生成可访问性决策列表:“我们需要决定如何使 [X] 对 [Y] 用户可访问。”

阶段 9 — 一致性

  • 类似事物是否以类似方式处理?(相同操作看起来和行为相同;相同对象类型表现一致)
  • 不同事物是否以不同方式处理?(主要与次要、破坏性与安全)
  • 此表层是否符合其媒介的惯例?违反平台规范是一个有代价的决策——有时值得,总是有意的。

区分:内部不一致(在表层内修复)与惯例违反(故意选择或疏忽——决定哪种情况)。

阶段 10 — 未决决策

生成所有待处理表层决策的汇总列表:

  • 需优先解决的跨层问题 —— 根因在较低层;单独列出;需在表层正确之前重新审视相关技能
  • 现在要做的表层决策 —— 决策是什么?选项有哪些?适用哪些约束(来自较低层、媒介、品牌/一致性)?
  • 延期 —— 现在无需做出,但应跟踪

完成

生成:

  1. 审核发现 —— 词汇违规、蒙面/变形对象、完整性缺口、情绪基调不匹配——每个都归类为表层修复或深层问题
  2. 决策清单 —— 所有未决的表层决策,分组并排序优先级
  3. 跨层问题 —— 需要在较低层解决的事项,以便表层正确
  4. 有效内容 —— 已做好的表层决策;在修订中不要丢失这些

结束语:“表层是用户接触的层面。下层决定的每件事都在这里被尊重或破坏。在概念模型或交互结构发生重大变化后重新审视此技能。”

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

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

相关技能