review-ux-ui
Über
Diese Fähigkeit führt umfassende UX/UI-Prüfungen durch, indem sie Nielsens Heuristiken, WCAG 2.1-Barrierefreiheitsaudits und User-Flow-Analysen anwendet. Sie ist für Usability-Checks vor der Veröffentlichung, die Überprüfung der Barrierefreiheitskonformität und heuristische Schnittstellenbewertungen konzipiert. Entwickler sollten sie nutzen, wenn sie Designs vor dem Einsatz auf Effizienz, kognitive Belastung und Formularnutzbarkeit bewerten.
Schnellinstallation
Claude Code
Empfohlennpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/review-ux-uiKopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren
Dokumentation
察介
評介之用、達、效也。
用
- 釋前察用→用
- WCAG 2.1 達合→用
- 流之效→用
- 表設→用
- 啟發評既介→用
入
- 必:所察之介(URL、原型、源碼)
- 必:標用述(職、技、境)
- 可:研果(訪、問、析)
- 可:WCAG 標(A、AA、AAA)
- 可:所察之流
- 可:助技(讀屏、開關)
行
一:啟發評(Nielsen 十則)
逐則察介:
| # | 則 | 問 |
|---|---|---|
| 1 | 狀顯 | 系恆告用所事乎? |
| 2 | 介合實 | 用熟語熟念乎? |
| 3 | 用控自由 | 易撤、復、退乎? |
| 4 | 一致規範 | 同元同行乎? |
| 5 | 防誤 | 設防誤先發乎? |
| 6 | 識勝憶 | 選、行、訊皆顯乎? |
| 7 | 靈效 | 有捷徑而不亂初乎? |
| 8 | 簡美 | 元皆有用乎?無冗乎? |
| 9 | 助識診復誤 | 誤訊明、具、建乎? |
| 10 | 助文 | 助易尋乎? |
各則評重:
| 級 | 述 |
|---|---|
| 0 | 非問題 |
| 1 | 飾 — 暇修 |
| 2 | 微 — 低先 |
| 3 | 大 — 必修 |
| 4 | 災 — 釋前必修 |
## Heuristic Evaluation Findings
| # | Heuristic | Severity | Finding | Location |
|---|-----------|----------|---------|----------|
| 1 | System status | 3 | No loading indicator during data fetch — users click repeatedly | Dashboard page |
| 3 | User control | 2 | No undo for item deletion — only a confirmation dialog | Item list |
| 5 | Error prevention | 3 | Date field accepts invalid dates (Feb 30) | Booking form |
| 9 | Error recovery | 4 | Form submission error clears all fields | Registration |
得:十則皆評,各有具體發現與重級。
敗:時迫→重 1、3、5、9。
二:達察(WCAG 2.1)
可知
- 1.1.1 非文容:圖皆有 alt(飾圖
alt="") - 1.3.1 訊關:用語意 HTML
- 1.3.2 序意:DOM 序合視序
- 1.4.1 色用:色非唯傳訊
- 1.4.3 對比:文 ≥ 4.5:1(常)、≥ 3:1(大)
- 1.4.4 縮文:可縮 200% 不失功
- 1.4.11 非文對:UI 元 ≥ 3:1
- 1.4.12 文距:增距仍可用
可操
- 2.1.1 鍵:諸功皆鍵可操
- 2.1.2 無鍵困:焦不困
- 2.4.1 跳鏈:有跳導鏈
- 2.4.3 焦序:Tab 序合理
- 2.4.7 焦顯:焦印明顯
- 2.4.11 焦不蔽:焦元不藏
- 2.5.5 標尺:互動 ≥ 24x24px
可解
- 3.1.1 頁語:
<html>設lang - 3.2.1 焦時:焦不引意外
- 3.2.2 入時:入不引意外
- 3.3.1 誤識:誤明述於文
- 3.3.2 標令:表入有顯標
- 3.3.3 誤建:誤訊建修法
健
- 4.1.1 解析:HTML 有效
- 4.1.2 名色值:自定元有 ARIA
- 4.1.3 狀訊:動容變宣告
得:WCAG 2.1 AA 系察、各條過/敗。
敗:先用 axe-core、Lighthouse 自動掃,後人評需判者。
三:鍵與讀屏察
鍵導測
僅用 Tab、Shift+Tab、Enter、Space、箭、Esc:
## Keyboard Navigation Audit
| Task | Completable? | Issues |
|------|-------------|--------|
| Navigate to main content | Yes — skip link works | None |
| Open dropdown menu | Yes | Arrow keys don't work within menu |
| Submit a form | Yes | Tab order skips the submit button |
| Close a modal | No | Escape doesn't close, no visible close button in tab order |
| Use date picker | No | Custom date picker not keyboard accessible |
讀屏測
NVDA、VoiceOver、TalkBack 測:
## Screen Reader Audit
| Element | Announced As | Expected | Issue |
|---------|-------------|----------|-------|
| Logo link | "link, image" | "Home, link" | Missing alt text on logo |
| Search input | "edit, search" | "Search products, edit" | Missing label association |
| Nav menu | "navigation, main" | Correct | None |
| Error message | (not announced) | "Error: email is required" | Missing live region |
| Loading spinner | (not announced) | "Loading, please wait" | Missing aria-live or role="status" |
得:全流以鍵獨、讀屏皆測。
敗:無讀屏→察 ARIA 與語意 HTML 為代。
四:流析
繪要流:
## User Flow: Complete a Purchase
### Steps
1. Browse products → 2. View product → 3. Add to cart → 4. View cart →
5. Enter shipping → 6. Enter payment → 7. Review order → 8. Confirm
得:要流繪、摩擦點識別評級。
敗:無分析→按複雜與步數評。
五:認負察
- 訊密:屏訊量適乎?
- 漸顯:複訊漸顯乎?
- 塊:相關視覺成組乎?
- 識勝憶:見而非憶乎?
- 一致式:同務同式乎?
- 決疲:選過多乎?
- 工憶:跨步需憶乎?
得:認負察、過載/不足區明。
敗:難客評→「眯測」(眯眼察結構顯否)。
六:表用察
各表:
- 標:每入有顯關標
- 占文:僅作例非標
- 入型:HTML 入型正
- 驗時:失焦或提交時誤
- 誤訊:具非泛
- 必欄:明標
- 欄組:相關視覺組
- 自完:
autocomplete設 - Tab 序:合視覺
- 多步表:進度顯
- 持:離返保
得:每表察、具體問題錄。
敗:表多→重高量者(註冊、結算、聯)。
七:書察報
## UX/UI Review Report
### Executive Summary
[2-3 sentences]
### Top 5 Improvements (Prioritised)
1. **[Issue]** — Severity: [N] — [Specific recommendation]
得:察給優先可行建、附重級。
敗:問題過多→分「必修」(3-4)「宜修」(1-2)。
驗
- 十則皆評
- WCAG 2.1 至少 1.1.1、1.4.3、2.1.1、2.4.7、3.3.1、4.1.2 察
- 鍵導要流測
- 讀屏測(或 ARIA/語意 HTML 代)
- 至少一要流析摩擦
- 認負察
- 表用察
- 發現按重排可行建
忌
- 混 UX 與視設:UX 為何運、視為何貌。美而 UX 劣可有
- 僅測順路:誤、空、載、邊例為 UX 問題藏處
- 忽真機:瀏覽器代之。真機觸、性、視口問題
- 達為後思:晚發貴修。早續察
- 私好為 UX 反:「吾偏好…」非 UX 反。引則、研、規
參
review-web-designscaffold-nextjs-appsetup-tailwind-typescript
GitHub Repository
Verwandte Skills
executing-plans
DesignVerwenden Sie die Fähigkeit "executing-plans", wenn Sie einen vollständigen Implementierungsplan zur Ausführung in kontrollierten Batches mit Überprüfungspunkten vorliegen haben. Sie lädt den Plan und überprüft ihn kritisch, führt dann Aufgaben in kleinen Batches (standardmäßig 3 Aufgaben) aus und meldet den Fortschritt zwischen jedem Batch zur Überprüfung durch den Architekten. Dies gewährleistet eine systematische Implementierung mit integrierten Qualitätskontrollpunkten.
requesting-code-review
DesignDiese Fähigkeit sendet einen Unteragenten für Code-Review, um Codeänderungen anhand der Anforderungen zu analysieren, bevor fortgefahren wird. Sie sollte nach dem Abschließen von Aufgaben, der Implementierung größerer Funktionen oder vor dem Zusammenführen in den Hauptzweig verwendet werden. Die Überprüfung hilft dabei, Probleme frühzeitig zu erkennen, indem die aktuelle Implementierung mit dem ursprünglichen Plan verglichen wird.
connect-mcp-server
DesignDiese Fähigkeit bietet Entwicklern eine umfassende Anleitung, um MCP-Server über HTTP-, stdio- oder SSE-Transports mit Claude Code zu verbinden. Sie behandelt Installation, Konfiguration, Authentifizierung und Sicherheit für die Integration externer Dienste wie GitHub, Notion und benutzerdefinierter APIs. Nutzen Sie sie beim Einrichten von MCP-Integrationen, bei der Konfiguration externer Tools oder bei der Arbeit mit Claude's Model Context Protocol.
web-cli-teleport
DesignDiese Fähigkeit unterstützt Entwickler bei der Wahl zwischen Claude Code Web- und CLI-Schnittstellen basierend auf Aufgabenanalysen und ermöglicht nahtloses Session-Teleporting zwischen diesen Umgebungen. Sie optimiert den Workflow, indem sie den Sitzungsstatus und Kontext beim Wechsel zwischen Web, CLI oder Mobilgeräten verwaltet. Nutzen Sie sie für komplexe Projekte, die in verschiedenen Phasen unterschiedliche Werkzeuge erfordern.
