Communitygithub.com

ulasalyesil/personal-website-v2

定義互動結構與流程,產出包含邊界情況、失敗路徑與待決事項的白板記號(breadboard notation)。

personal-website-v2 是什麼?

這個技能引導你為產品建立互動結構與流程層,使用白板記號(breadboard notation)來清楚描述使用者如何與產品互動。它支援多種方法論,包括 Ryan Singer 的 Shape Up 白板法、Jeff Patton 的使用者故事地圖、任務分析、服務藍圖以及關鍵使用者旅程(CUJ),預設採用白板法。過程分為六個階段:界定流程框架、識別場域(places)、對應功能與連接、走查流程、挑戰流程,最後產出完整的白板記號。它特別強調失敗路徑、空狀態、載入/非同步狀態、樂觀/悲觀更新等邊界情況,並要求明確標記未決的設計決策。產出內容包括工作故事、完整白板、Mermaid 流程圖、待決事項與風險,確保互動邏輯在視覺化設計之前就被充分驗證。此技能適用於任何需要設計使用者流程的開發者或產品設計師,可與 Claude Code、Cursor、Codex 等 AI 代理工具整合。

相容平台~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 以取得框架上下文。

互動結構與流程層定義了使用者如何與產品互動:他們導航的場域、可用的功能 (affordances)、呈現的內容,以及狀態間的流動。它位於概念模型(定義存在什麼)之上,以及表面層(定義看起來如何)之下。

這一層需要做出的決策:

  • 流程會經過哪些不同的場域?
  • 使用者在每個場域可以做什麼,每個動作會帶他們去哪裡?
  • 每個場域需要顯示什麼內容?
  • 失敗路徑、空狀態和邊界情況如何處理?
  • 流程是否能盡可能簡潔,同時仍能完成任務?

方法:

方法適用時機
白板法 (Ryan Singer / Shape Up)大部分流程的預設選擇。基於文字的表達方式,迫使在視覺設計使變更成本變高之前先評估互動邏輯。
使用者故事地圖 (Jeff Patton)複雜產品、多種使用者類型、逐步規劃。將活動 → 任務 → 故事映射到時間軸上。
任務分析重新設計既有流程。分解現有任務,找出摩擦、錯誤和應急措施的集中點。
服務藍圖流程跨越多個渠道,或涉及影響使用者體驗的後台操作(員工、系統、第三方)。
關鍵使用者旅程 (CUJs)決定要處理哪個流程。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

相關技能