Communitygithub.com

ulasalyesil/personal-website-v2

審查現有表層成果是否遵循下層決策,並產出表層決策清單 — 包含詞彙、物件一致性、完整性、回饋、階層與無障礙性

personal-website-v2 是什麼?

這個技能(基於 `/layers-intro` 提供的框架)專注於產品設計的「表層」——也就是使用者實際接觸到的所有元素:文字、聲音、視覺、觸覺、動態與回饋。它是一個專業審計與決策工具,可應用於螢幕 UI、語音/對話介面、實體裝置或服務接觸點等多種媒介。技能的核心價值在於區分「表層可修復的瑕疵」與「需要回到底層重新決策的結構性問題」,幫助團隊避免頭痛醫頭、腳痛醫腳。 技能分為兩大部分:「審計」階段(第1-5階段)會系統性比對表層實作與下層概念模型、麵包板(breadboard)及工作故事(job stories),找出詞彙偏差、物件不一致、完整性缺口與情緒音調錯位。而「決策清單」階段(第6-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 以取得框架脈絡。

表層是將下層所有決策化為使用者實際體驗的地方:文字、聲音、視覺、實體觸感、動態、回饋。這是最具媒介專一性的層級,但最優先要做的決定是通用的——無論表層是螢幕、語音介面、實體裝置還是服務接觸點,這些決策都適用。

表層的瑕疵往往是更深層問題的症狀。此技能區分兩種情況:可以在表層修復的問題,以及需要回到較低層級重新審視的問題。

此層級需要做出的決策:

  • 表層是否遵循概念模型中的詞彙與物件?
  • 來自麵包板的每個可操作元素(affordance)是否都存在?是否有表層內容背後沒有模型支撐?
  • 表層是否傳達了符合使用者工作之情緒的正確音調(emotional register)?
  • 使用者如何知道發生了什麼事、什麼正在進行中,以及哪裡出了錯?
  • 什麼最顯眼?它應該最顯眼嗎?
  • 每一項資訊對於需要它的使用者來說是否都可及?

方法:

方法使用時機
直接在真實媒介中工作(程式碼、正式 UI)當你需要關於真實互動的實際回饋時。避免草稿圖看起來的樣子與實際使用行為之間的差距。
高擬真草稿(Figma 等)探索佈局、視覺層級與視覺形式——特別是新穎的模式或需要利害關係人達成共識時。
設計系統 / 元件庫當產品已有既定的元件與設計符號(design tokens)。表層決策必須擴展現有系統,而非與之矛盾。
風格圖版(Style tiles)在尚未確定佈局時建立初步的視覺語言。比高擬真草稿更快,適合初期調性對齊。
原型測試互動行為——轉場、回饋時機、流程——靜態草稿無法表達的部分。
文案優先(Copy-first)當語言是主要的設計材料時——訊息傳遞、新手引導、錯誤狀態。先寫文案,再設計容器。

品質訊號——好的表層決策看起來像什麼:

  • 每個術語都符合概念模型中的通用語言(ubiquitous language)
  • 每個物件在不同脈絡中都有一致的呈現——不是變形金剛,也不是偽裝者
  • 麵包板中的每個可操作元素都存在;每個表層元素背後都有模型支撐
  • 情緒音調符合使用者需求中的情緒性與社交性工作
  • 錯誤訊息需做到三件事:診斷(發生什麼事)、解釋(為什麼)、恢復(接下來該怎麼做)。「發生錯誤」這三個要求都做不到
  • 顯眼程度反映重要性——流程需要使用者注意的內容就是最突出的
  • 無障礙決策是明確做出的,而非依賴預設值

引導式工作階段

此技能有兩個部分。告訴我你需要什麼:

  • 審計 — 評估現有表層成果是否符合下層決策(第1–5階段)
  • 決策清單 — 逐步處理未決的表層決策(第6–10階段)

描述你現有的內容,或說「引導我」來開始。

提問:「本次工作階段的成果應該記錄在哪裡?」(請參閱 /layers-intro 中的選項)

提問:

  1. 我們正在處理哪個產品或功能?
  2. 媒介是什麼——螢幕 UI、語音/對話式、實體、服務接觸點?
  3. 你從下層獲得了什麼?概念模型(物件 + 通用語言)?麵包板或流程圖?包含情緒性與社交性工作的工作故事(job stories)?

第一部分 — 審計

第1階段 — 界定表層

現有表層成果是否存在——包含可運作的程式碼、已部署的 UI、文案、視覺設計?還是表層尚未開始?如果尚未開始,請跳到第二部分。

第2階段 — 詞彙與語言

從概念模型中取出通用語言清單。請設計師分享表層文案——標籤、標題、按鈕文字、錯誤訊息、通知、輔助說明文字。

檢查每個術語。標記:

  • 直接違規 — 模型術語被錯誤或不一致地使用(例如一處寫「帳戶」,另一處寫「工作區」)
  • 未列出的術語 — 表層上出現但不在通用語言中的詞彙。是應新增至模型的新術語,還是表層雜訊?
  • 音調錯位 — 技術上正確,但情緒/社交工作的音調錯誤

針對每個違規:這是表層修復(重寫文案)還是更深層修復(更新概念模型詞彙)?

第3階段 — 物件一致性

對於概念模型中的每個物件:它在表層的哪些地方出現?有多少種形式?

  • 變形金剛(Shapeshifters) — 同一物件在不同脈絡中以顯著不同的視覺或結構形式出現
  • 偽裝者(Masked objects) — 物件以使用者無法辨識其物件類型的形式出現

針對每個情況:這是表層決策(建立一致的處理方式)還是概念模型問題(即使在模型中,物件的身分也不明確)?

第4階段 — 完整性檢查

取出麵包板。針對每個地點(place)與可操作元素(affordance):

  • 麵包板中的每個可操作元素在表層中都存在嗎?
  • 是否有表層內容沒有對應的麵包板元素?

不存在於麵包板中的額外內容,通常是互動層級的決策不慎滲入——標記出來,並建議重新審視 /layers-interaction-flow。

第5階段 — 情緒音調

回到工作故事,特別關注情緒性與社交性工作。

「使用者在這裡進行的情緒性工作是什麼——不只是功能任務,還有他們希望感受到什麼?」 「涉及什麼社交性工作——他們希望如何被看待?」

常見錯位:

  • 表層強調產品的益處(「我們獲得推薦」)而非使用者的工作(「我幫助同事」)
  • 當使用者的工作是關係導向時,文案將互動框架為交易性質
  • 當使用者需要感到安心或有信心時,語氣卻顯得專家/冷冰冰

第二部分 — 決策清單

第6階段 — 回饋與錯誤

針對每個重要動作與狀態轉換:

  • 「使用者如何知道他們的動作成功了?」
  • 「使用者如何知道某件事正在進行中?」
  • 「使用者如何知道出了問題,以及該怎麼處理?」

錯誤訊息必須做到診斷、解釋,並告知使用者下一步。標記每個未滿足這三個條件的錯誤狀態。針對每個缺口產出一個決策:「我們需要決定如何向使用者溝通 [X]。選項有 [Y]。」

第7階段 — 階層與強調

針對每個關鍵地點:

  • 「這裡使用者最需要注意或採取行動的是什麼?」
  • 「目前的表層是否讓那個東西最顯眼?」
  • 「是否有任何東西在視覺上不應該那麼顯眼?」

這些首先是與媒介無關的決策(什麼應該是主要的),然後才變成與媒介相關的決策(如何在視覺、聽覺或觸覺上使其成為主要)。

第8階段 — 無障礙性

針對宣告的媒介標記相關考量:

  • 螢幕 UI: 色彩對比、文字大小、觸控目標、鍵盤導航、螢幕閱讀器標籤(針對互動元素與圖片)、流程各步驟間的焦點管理
  • 語音/對話式: 所有資訊都需以口語傳達(不能說「點擊左邊的按鈕」),錯誤回復無需仰賴視覺環境
  • 實體: 可觸及範圍、觸覺區分、多種光線下的可見度、無需精細動作技能即可操作

產出一份無障礙決策清單:「我們需要決定 [X] 將如何對需要 [Y] 的使用者保持可及。」

第9階段 — 一致性

  • 相似的事物是否以相似的方式處理?(相同動作看起來與行為一致;相同物件類型代表方式一致)
  • 不同的事物是否以不同的方式處理?(主要 vs. 次要,破壞性 vs. 安全)
  • 此表層是否符合其媒介的慣例?違反平台慣例是一個有代價的決策——有時值得,但永遠是有意為之的。

區分:內部不一致(在表層內修復)vs. 慣例違反(刻意選擇或疏忽——需要決定是哪一種)。

第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

相關技能