Communitygithub.com

ulasalyesil/personal-website-v2

绘制交互结构与流程的图谱——以面包板符号记录边缘情况、失败路径及待定决策

personal-website-v2 是什么?

该技能是交互设计与用户体验工程中的关键方法论,专注于在概念模型(定义“存在什么”)与表面层(定义“看起来怎样”)之间,系统化地定义产品内用户与界面的交互方式。它引导团队通过面包板(Breadboarding)、用户故事映射(User Story Mapping)和任务分析(Task Analysis)等结构化方法,完整捕获交互流程中的每一个步骤、用户可执行的操作及其目的地,并特别强调对失败路径、空状态和边缘场景的显式处理。技能支持多种设计工具(如Mermaid流程图)和平台(通用网页/应用设计),默认采用Shape Up方法中的面包板符号,通过文本式的“地点-功能-目的地”标记法,在视觉设计固化之前强制团队评估交互逻辑,从而降低变更成本。它也适用于服务蓝图和关键用户旅程(CUJ)分析,尤其适合需要清晰定义多步骤、多状态交互的复杂产品场景。

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

在你喜欢的 AI 中提问

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

文档

/layers-interaction-flow

假设 /layers-intro 已加载以提供框架背景。

交互结构与流程层定义了用户如何与产品交互:他们导航的场所、可用的功能、呈现的内容以及状态之间的流转。它位于概念模型(定义“存在什么”)之上,表面层(定义“看起来怎样”)之下。

此层需要做出的决策:

  • 这个流程经过哪些不同的场所?
  • 用户在每一个场所可以做什么,每个操作会把他们带到哪里?
  • 每个场所需要展示什么内容?
  • 失败路径、空状态和边缘情况发生时如何处理?
  • 流程是否在服务于任务的前提下尽可能简单?

方法:

方法适用场景
面包板 (Ryan Singer / Shape Up)大多数流程的默认方法。基于文本的符号,强制在视觉设计使变更变得昂贵之前评估交互逻辑。
用户故事映射 (Jeff Patton)复杂产品,多种用户类型,渐进式规划。在时间线上将活动 → 任务 → 故事进行映射。
任务分析重新设计现有流程。分解当前任务以找出摩擦点、错误和变通方法集中的地方。
服务蓝图流程跨越多个渠道或涉及后台操作(员工、系统、第三方),这些操作会影响用户体验。
关键用户旅程 (CUJ)决定优先处理哪个流程。CUJ是实现核心产品价值的最小路径——类型包括:高流量、高收入或指标关键。

默认方法:面包板。

面包板符号:

场所名称
- 功能 → 目标场所
- 功能 → 目标场所
[ 此场所中显示的内容 ]

质量信号——好的表现是什么样的:

  • 每个功能都有命名的目标场所
  • 失败路径已用面包板记录——而非事后考虑
  • 空状态、加载状态和操作后状态已定义
  • 无破碎对象——一个对象的属性和操作应一起可用,而不是分散在不同屏幕且没有交叉链接
  • 无孤立对象——概念模型中的关系在流程中应可见并可导航
  • 流程极简:针对单一任务故事,若超过5-6个场所,则需审视哪些可合并

引导式会话

告诉我你正在为哪个用户旅程做设计,或者说“引导我”来开始一次面包板会话。

询问:“我应该把本次会话的成果记录在哪里?”(参见 /layers-intro 中的选项)

检查底层:“你有概念模型——定义好的对象、关系和词汇——可以基于其工作吗?还是我们在底层模型未确定的情况下设计流程?” 在概念模型稳定之前构建的流程通常需要重新审视。

询问:“我们正在为哪个用户旅程或任务故事做设计?” 面包板始终是为特定用户在特定情境下完成特定任务而设计的。


阶段 1 — 界定流程

  1. 这个流程服务于哪个任务故事?
  2. 用户从哪里开始?他们处于什么情境?
  3. 成功看起来是怎样的——流程完成时用户实现了什么?
  4. 是全新流程、重新设计还是现有流程的扩展?

如果是重新设计:首先描述当前流程,即使只是粗略的。现有流程揭示了已经做出的决策——有些是刻意的,很多不是。

阶段 2 — 识别场所

“这个流程经过哪些不同的场所——屏幕或状态?先别考虑布局。只需命名场所。”

询问:这些场所中是否有同一个场所的不同状态?它们应该作为不同的场所还是同一个场所的不同状态?产品中其他地方是否有与此流程相连的场所?

命名场所本身就是一个设计决策。使用描述性的、对用户有意义的名称:“推荐面板”而非“页面3”。

阶段 3 — 映射功能和连接

对于每个场所,分析用户在那里能做什么以及每个操作会引导到何处。使用上面的面包板符号。

对于每个功能:它确切指向哪里?操作成功时会怎样?失败呢?它是始终可用,还是只在特定条件下可用?

条件——功能何时可用或不可用——往往是真正设计决策隐藏的地方。

阶段 4 — 走查流程

以用户的口吻叙述:“我是一个用户,面临[任务故事情境]。我到达[起始场所]。我看到[内容]。我想要[动机]。于是我[功能]...”

走通完整的成功路径。然后走查边缘情况:

  • 空状态: 在任何数据存在之前这个场所看起来什么样?这通常是新用户首先看到的东西。
  • 加载/异步状态: 在数据获取或操作执行期间用户看到什么?
  • 操作后状态: 提交之后会发生什么?停留在当前页、重定向、还是行内确认?如果重定向到列表——它是否立即显示变更?如果存在延迟,会不会看上去像操作没有生效?
  • 乐观更新 vs. 悲观更新: 是立即显示假设的结果(等待服务器确认),还是等待?明确偏好;如果实现不确定,将其标记为一个命名的待定问题。
  • 失败路径: 针对每个操作——验证失败、服务器错误、网络断开、超时、并发编辑。用户会去哪里?他们如何恢复?这些是面包板中必需的步骤。
  • 取消路径: 如果用户想半途停止,他们去哪里?
  • 替代入口点: 流程是否假设了可能不总是成立的前置状态?

每一个缺口都是一个未做出的设计决策。明确地将其命名。

阶段 5 — 挑战流程

  • 有没有用户可能放弃的步骤?为什么存在这步——它是否必要?
  • 用户期望的操作中,是否有流程未提供的?
  • 流程中的词汇是否与概念模型的通用语言一致?
  • 是否存在一个更简单的版本能服务于相同的任务?

检查破碎对象: 对于此流程中出现的来自概念模型的每个对象——它的属性和操作是否一起可用,还是分散在不同屏幕且没有交叉链接?如果分散,要么合并,要么在对象各部分出现的场所之间添加显式连接。

检查孤立对象: 对于概念模型中定义的每个关系——流程是否使该关系可见并可导航?如果模型中存在关系但在流程中不可见,要么将其展示出来,要么做出有意的决定:在此流程中不需要导航到它。

阶段 6 — 生成面包板

生成完整的面包板:所有场所、所有功能和目标场所、每个场所的内容、关键的带条件状态备注。

生成从左到右方向的流程图——时间线从左向右流动。使用Mermaid语言:graph LR。

注意:流程图用于定位——文本面包板才是主文档。流程图会丢失内容和条件的细节。


完成

产出:

  1. 任务故事 —— 此流程服务的用户需求
  2. 面包板 —— 完整的文本符号记录
  3. 流程图 —— Mermaid graph LR
  4. 待定决策 —— 尚未解决的缺口、边缘情况、带条件的状态
  5. 风险 —— 对未确定的概念模型决策或表面层假设的依赖

以如下语句结束:“这个面包板定义了交互逻辑,而没有承诺视觉形式。无论下一步做什么——用代码工作、在真实媒介中构建,还是详细的视觉设计——请确保此流程底层的概念模型首先稳定下来。”

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

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

相关技能