SkillAtlasSkill 详情

product-ux-expert

106 Cross-Runtime Skills | 7 Claude Code Agents | One Command Install

审核状态:已审核Quality 72Security 90

复制安装命令

用 Codex 或 Claude 安装复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它先审查 Skill 页面再帮你安装。

复制前请先查看来源、License 和安全提示。

项目 README

来源文件:README.md

抓取于 2026年9月7日

Spellbook

106 Cross-Runtime Skills | 7 Claude Code Agents | One Command Install

A cross-runtime skill library for Claude Code, Codex, and multi-agent workflows.

Stars License Skills Agents

Quick Start • Runtime Targets • Pick a Workflow • Skills • Agents • Changelog • Release Status • Contributing • 中文


Rename notice: Spellbook was formerly Claude Arsenal. Claude Code remains a first-class target; the new name reflects the broader roadmap for Claude Code, Codex, and cross-runtime agent skills. See the migration note for details.


Quick Start

Start with one job-shaped workflow. The maintained skills CLI lets you choose the supported coding agents during installation and installs only these four skills:

npx skills add majiayu000/spellbook --skill frontend-design --skill app-ui-design --skill ui-design-system --skill figma-to-react

Use npx skills add majiayu000/spellbook --list to inspect the catalog before installing. See Pick a Workflow for four other focused starting points.

Advanced Cross-Runtime Installer

install.sh remains available when you want explicit Claude Code/Codex target paths or need to install the repository's Claude Code agents as well as skills.

# Install all skills and supported agents into both maintained runtimes
curl -fsSL https://raw.githubusercontent.com/majiayu000/spellbook/main/install.sh | bash -s -- --target all

# Or clone the repository and select skills explicitly
git clone https://github.com/majiayu000/spellbook.git
cd spellbook
./install.sh --target all --skills typescript-project,python-project,devops-excellence

Verify Installation

  • Claude Code: type / to see your installed skills.
  • Codex: restart Codex so it reloads ~/.agents/skills.

Runtime Targets

Spellbook keeps the skill source in one place and installs it into the runtime you use.

TargetInstalled ToStatus
Claude Code~/.claude/skills plus ~/.claude/agentsSkills and agents supported
Codex~/.agents/skillsSkills supported; agents skipped
AllBoth Claude Code and Codex pathsRecommended for multi-tool users

Claude Code remains a first-class target and search entry. The project was formerly known as Claude Arsenal; the new Spellbook name reflects the broader goal: reusable skills that can travel across coding agents. Older Spellbook versions installed Codex skills under ~/.codex/skills; reinstall with the current installer to use the documented Codex user-level skill path.


Pick a Workflow

Start with a small bundle that matches the job, then add more skills when the workflow sticks.

WorkflowInstallGood for
Frontend and UInpx skills add majiayu000/spellbook --skill frontend-design --skill app-ui-design --skill ui-design-system --skill figma-to-reactProduct UI, landing pages, design systems, Figma handoff
Code qualitynpx skills add majiayu000/spellbook --skill codebase-audit --skill flowguard --skill systematic-debugging --skill review-gateAudits, guarded delivery, root-cause debugging, pre-landing review
Ops and releasenpx skills add majiayu000/spellbook --skill release-engineering --skill server-security --skill clash-doctor --skill system-doctorRelease planning, server hardening, and local or network diagnosis
Product and docsnpx skills add majiayu000/spellbook --skill product-discovery --skill prd-master --skill technical-spec --skill product-analyticsDiscovery, PRDs, technical specs, metrics plans
Agent workflowsnpx skills add majiayu000/spellbook --skill codex-agent --skill multi-ai-research --skill flowguard --skill vibeguardCross-review, multi-AI research, context handoff, anti-hallucination checks

High-signal individual skills to try first: github-trending, harmonyos-app, app-ui-design, product-discovery, xiaohongshu, codebase-audit, and server-security.

See Showcase for copy-paste prompts and expected outputs. Use the Spellbook Skill Browser for curated first-party skills, or the Claude Skills Registry for broader community discovery. Release history lives in Changelog.


Why Spellbook

  • Cross-runtime install: one source tree can install into Claude Code and Codex.
  • Validated registry: every installable skill is checked by python3 scripts/validate_skills.py --check.
  • Progressive disclosure: larger skills use references/, templates/, scripts/, and eval files instead of one giant prompt.
  • Practical coverage: engineering, operations, product, UI, content, and agent workflows live in one catalog.

Skills

The generated full skill inventory lives in Skill Registry. Skill layout rules live in Skill Format Policy. Skill authoring quality rules live in Skill Quality Playbook.

Search the Registry

# Free-text query (AND semantics across name, description, category, tags)
python3 scripts/validate_skills.py search rust testing

# Filter by tag
python3 scripts/validate_skills.py search --tag agent

# Restrict to a description language
python3 scripts/validate_skills.py search --language zh deploy

# Machine-readable output
python3 scripts/validate_skills.py search --tag react --json

The tag index lives in registry/tags.json for tooling and dashboards. Curated overrides for skills the keyword heuristic cannot infer live in registry/tag_overrides.yml.

Audit non-blocking skill quality signals:

python3 scripts/audit_skill_quality.py
python3 scripts/audit_skill_quality.py skill-creator

AI & Agent Workflow

Skills for orchestrating, guarding, and maintaining AI agent workflows — the core of Spellbook's cross-runtime mission.

SkillDescription
multi-model-orchestratorCoordinate multi-agent tasks via a centralized handoff document
flowguardGuard long, ambiguous, or stateful agent tasks from drift
skill-lifeguardAdd reliable-skill contracts, checkpoints, smoke hooks, and drift signals
review-gateProduce review packs and require human approval before landing agent changes
skill-auditAudit, design, categorize, and measure agent skills
skill-ecosystem-doctorGovern canonical sources, projections, retirement, quarantine, and cross-runtime verification
threadsCodex-native subagents and parallel GitHub queue lanes
codex-fluentCodex session hygiene, archive strategy, and handoff discipline
codex-retrospectiveCodex self-review of recent history to improve behavior
brainstormingSocratic dialogue for design refinement and architecture exploration

See docs/agent-reliability-trio.md for the Reliable Skill + Context Engineering + Review Gate workflow.

Development Architecture

Build production-ready projects with language-specific best practices.

SkillLanguageKey Features
typescript-projectTypeScriptESM, Zod, Biome, Clean Architecture
python-projectPythonuv, Pydantic, Ruff, FastAPI
rust-projectRustCargo workspace, error handling, async
golang-webGoChi/Echo, sqlc, structured logging
zig-projectZigBuild system, memory management
architecture-foundationCross-languageRuntime, state ownership, adapters, and convergence specs
elegant-architectureCross-languageClean architecture with strict 200-line file limits

Product Lifecycle

End-to-end product development from discovery to deployment.

SkillPhaseWhat You Get
product-discoveryDiscoveryJTBD, user interviews, market research
prd-masterDefinitionPRD writing, user stories, RICE prioritization
technical-specDesignDesign docs, ADR, C4 diagrams
product-analyticsGrowthEvent tracking, A/B testing, AARRR
devops-excellenceDeploymentCI/CD, Docker, Kubernetes, GitOps
observability-sreOperationsMonitoring, logging, tracing, SLO/SLI
product-manager-toolkitDefinitionRICE, customer interviews, PRD templates, discovery frameworks

API & Backend

SkillDescription
api-designREST/GraphQL/gRPC patterns, OpenAPI 3.2
auth-securityOAuth 2.1, JWT, security best practices
database-patternsPostgreSQL, Redis, migrations, optimization
codebase-auditDeep adaptive repository audit with severity-ranked findings and repair roadmap
structured-logging-liteCentralized logging, field standards, and distributed tracing

Development Practices

SkillDescriptionOrigin
contributorEnd-to-end open source contribution workflow from issue discovery to PR submissionCustom
repo-agent-context-auditAudit and scaffold repo agent context across AGENTS, skills, and specsCustom
skill-creatorCreate, improve, and benchmark reusable skillsCustom
humanizerRemove obvious AI writing patterns from user-facing textExternal guide + custom adaptation

Delivery Workflow

Disciplined end-to-end delivery: testing, commits, health checks, and contribution flow.

SkillDescription
app-user-story-qaEnd-to-end app feature inventory, canonical tracker, user-story testing, fixes, and retest loop
test-driven-developmentEnforce RED-GREEN-REFACTOR TDD discipline
comprehensive-testingTest pyramid, unit/integration/E2E/property testing, framework best practices
git-commit-smartGenerate meaningful conventional commit messages from diff
push-allStage, commit, and push all changes after safety checks
project-health-auditorCodebase health, tech debt, dependency, and project risk analysis
contribution-architectMove from bug fixes to architectural improvements and debt discovery

Cross-Tool Interop

Skills for using multiple coding agents and CLI tools together.

SkillDescription
codexInvoke Codex CLI sessions from another agent workflow
codex-agentOptional second-opinion review, cross-verification, and alternatives through Codex CLI
sol-luna-routerKeep GPT-5.6 Sol as commander/reviewer while GPT-5.6 Luna performs bounded implementation
ask-opencliAsk Grok or Gemini through opencli and an existing browser session
multi-ai-researchParallel research across multiple AI tools and internal agents

UI/UX & Design

SkillDescription
app-ui-designiOS/Android UI design, Material Design 3, HIG
product-ux-expertUX evaluation, heuristics, accessibility
frontend-designWeb frontend design patterns
ui-designerExtract design systems from UI screenshots and references
ui-design-systemDesign system toolkit and design-dev handoff support
web-artifacts-builderClaude.ai HTML artifacts
react-best-practicesReact and Next.js performance patterns distilled from Vercel guidance
react-hooks-best-practicesReact hooks, effects, refs, and component design patterns
slidesSpeech-friendly slide deck and background slide generation
ui-ux-pro-maxCompact UI/UX tables for product patterns, landing pages, charts, and 9 stacks
figma-to-codeFigma designs to production React/Next.js with TypeScript and Tailwind
css-debugDiagnose CSS/layout issues, Tailwind conflicts, z-index stacking
playwright-automationBrowser automation and testing with Playwright

Tooling & Automation

SkillDescription
web-asset-generatorFavicons, app icons, OG images
github-trendingGitHub trending analysis
vibeguardTask contracts, finding scoring, and lightweight anti-hallucination reviews
clash-doctorClash proxy & network diagnostics
clash-routesInspect active proxy routes for specific processes via Mihomo API
optimize-networkSafe local network speed, latency, DNS, Wi-Fi, and bufferbloat diagnostics with VPN/proxy guardrails
disk-cleanerScan and reclaim disk space with interactive cleanup guidance
system-doctorDiagnose CPU, memory, and process-level system slowdowns
codex-log-guardDiagnose and mitigate excessive Codex local SQLite diagnostic log writes
server-securityAudit and harden Linux server SSH, firewall, and exposed services
cliproxy-newapi-stackAdd a loopback-first NewAPI metering layer to an independently verified CLIProxyAPI upstream

Operations & Deploy

Deploy models and diagnose local and remote environments.

SkillDescription
gemma4-local-deployDeploy Gemma 4 12B locally on Mac/Apple Silicon via llama.cpp or Ollama
gpu-useInspect remote server GPU usage (per-card VRAM, processes, containers)
rustdesk-doctorDiagnose RustDesk connection issues
vscode-doctorDiagnose slow or freezing VS Code-compatible editors

Content & Social Media

SkillDescription
xiaohongshuXiaohongshu content creation & publishing
trip-plannerTravel itinerary planning
weeklyWeekly report from Git, Claude Code, and Codex sessions
xiaohongshu-netfeel-guardianRemove translation-tone from Claude's Chinese content for native readability

Mobile & Cross-Platform

SkillDescription
harmonyos-appHarmonyOS with ArkTS, ArkUI, Stage Model

Rust Specific

SkillDescription
rust-best-practicesMicrosoft Rust guidelines, error handling

Agents

Specialized agents for complex tasks.

AgentExpertiseUse Case
tech-lead-orchestratorCoordinationMulti-step tasks, delegation
code-archaeologistExplorationLegacy codebase documentation
backend-typescript-architectArchitectureBun/Node.js, API design
senior-code-reviewerReviewSecurity, performance, architecture
kubernetes-specialistInfrastructureK8s, Helm, GitOps
security-auditorSecurityOWASP Top 10, SAST
opensource-contributorContributionOpen source workflow

Plugins

Spellbook is also a Claude Code plugin marketplace. Install the repo as a marketplace, then install plugins from it:

/plugin marketplace add majiayu000/spellbook
/plugin install idea-coach
/plugin install rust-dev
PluginDescription
idea-coachOpinionated product coach (idea -> PRD -> clickable HTML prototype) + multi-role idea group chat; plugin commands are /idea-coach:idea and /idea-coach:idea-team
rust-devRust best practices, code review, performance, and async patterns

Plugin skills are packaged copies of catalog skills; the catalog (installed by install.sh) remains the cross-runtime source of truth.


Skill Design Philosophy

Every skill in Spellbook follows these principles:

  1. Hard Rules - Mandatory constraints with FORBIDDEN / REQUIRED markers
  2. Practical Examples - Real code, not just theory
  3. Verification Checklists - Actionable validation steps
  4. Battle-Tested - Used in production environments

Documentation

DocumentDescription
ChangelogRelease history and current release status
Installation GuideDetailed setup instructions
Runtime TargetsClaude Code and Codex installation targets
ShowcaseCopy-paste workflow demos
Spellbook Operating ContractAgent behavior rules for autonomy, escalation, pushback, feedback loops, and done-when checks
Skill Format PolicyDirectory vs file skill layout rules
Skill Quality PlaybookTrigger descriptions, gotchas, progressive disclosure, and verification
Skill Testing GuideHow to validate skills work
Creating PluginsBuild your own skills
Product Lifecycle (EN)Full lifecycle coverage
Product Lifecycle (中文)产品生命周期覆盖

Release Status

Spellbook is in pre-1.0 release-readiness mode. No numbered GitHub release tag has been cut yet; the current install path uses the repository main branch. See Changelog for release history.

Current limitations:

  • Codex installs skills only; Claude Code agents are skipped for Codex targets.
  • Some skills depend on external CLIs, accounts, credentials, or platform access that are not bundled by the installer.
  • The registry validator checks installable skill structure, not every external workflow end to end.

Support paths:


Credits

Built on the shoulders of giants:


Contributing

Contributions welcome! Please read our Contributing Guide first.


The Agent Infra Stack

This project is one layer of an open-source stack for running coding agents (Claude Code, Codex) as serious infrastructure. Every piece works standalone; together they close the loop:

spellbook sits in the Extend layer — the authoring side of the skill story: write once, run on Claude Code and Codex. Discovery and distribution live in claude-skill-registry.

LayerProjectWhat it does
Extendclaude-skill-registryDiscover and search community Claude Code skills
Extendspellbook ◀ you are hereCross-runtime skills for Claude Code, Codex, and multi-agent workflows
TrustargusStatic install-time scanner for supply-chain attacks (npm / PyPI / crates.io)
TrustvibeguardRules, hooks, and guards against hallucinated or unverified agent changes
RememberrememLocal-first persistent memory for Claude Code and Codex sessions
OrchestrateharnessRust agent orchestration platform — rules, skills, GC, observability
Routelitellm-rsHigh-performance Rust AI gateway — 100+ LLM APIs via OpenAI format
KeepkeeplineSession command center — monitor, recover, never lose agent work

License

MIT License - Use freely in your projects.


If this helps you, consider giving it a ⭐

Made for builders using Claude Code, Codex, and multi-agent workflows

其他

低风险

  • 来源需自行核对维护者身份。
  • 未检测到明显脚本安装指令。
  • 可能需要外部 token、网络权限或第三方服务。
  • 未检测到高风险命令。
  • 扫描发现:0 条。

Codex — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/majiayu000/spellbook.git
  3. 将 "skills/product-ux-expert" 文件夹复制到 Codex 的 skills 目录中。
  4. 重启 Codex 让新的 skill 生效。

Codex — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Codex 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Codex 让新的 skill 生效。

Claude Code — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/majiayu000/spellbook.git
  3. 将 "skills/product-ux-expert" 文件夹复制到 Claude Code 的 skills 目录中。
  4. 重启 Claude Code 让新的 skill 生效。

Claude Code — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Claude Code 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Claude Code 让新的 skill 生效。

Cursor — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/majiayu000/spellbook.git
  3. 将 "skills/product-ux-expert" 文件夹复制到 Cursor 的 skills 目录中。
  4. 重启 Cursor 让新的 skill 生效。

Cursor — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Cursor 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Cursor 让新的 skill 生效。

GitHub Copilot — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/majiayu000/spellbook.git
  3. 将 "skills/product-ux-expert" 文件夹复制到 GitHub Copilot 的 skills 目录中。
  4. 重启 GitHub Copilot 让新的 skill 生效。

GitHub Copilot — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 GitHub Copilot 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 GitHub Copilot 让新的 skill 生效。

Windsurf — Git Clone 安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 克隆仓库:git clone https://github.com/majiayu000/spellbook.git
  3. 将 "skills/product-ux-expert" 文件夹复制到 Windsurf 的 skills 目录中。
  4. 重启 Windsurf 让新的 skill 生效。

Windsurf — 手动复制安装

  1. 安装前请先查看来源仓库和风险报告。
  2. 从源仓库下载 SKILL.md 及相关文件。
  3. 在 Windsurf 的 skills 目录中创建新文件夹。
  4. 将所有 skill 文件复制到新文件夹中。
  5. 重启 Windsurf 让新的 skill 生效。
查看 SKILL.md 原文
name: product-ux-expert
description: Product interaction and UX expert. Use when reviewing UI/UX, conducting heuristic evaluations, designing user journeys, applying cognitive psychology principles, or ensuring WCAG 2.2 accessibility compliance.

Product UX Expert

Core Principles

  • Reduce Cognitive Load — Minimize mental effort required for every interaction
  • Accessibility First — WCAG 2.2 AA is the baseline, not an afterthought
  • Evidence-Based — Decisions backed by user research, not assumptions
  • Anticipatory Design — Predict user needs before they ask
  • Ethical Design — No dark patterns, transparent data practices
  • Mobile First — Design for smallest screens, enhance for larger

Quick Reference

Nielsen's 10 Heuristics

#HeuristicKey Question
1Visibility of System StatusDoes the user always know what's happening?
2Match System & Real WorldDoes it use familiar language and concepts?
3User Control & FreedomCan users easily undo or exit?
4Consistency & StandardsDoes it follow platform conventions?
5Error PreventionDoes it prevent errors before they occur?
6Recognition over RecallIs information visible, not memorized?
7Flexibility & EfficiencyAre there shortcuts for experts?
8Aesthetic & Minimalist DesignIs every element necessary?
9Help Users with ErrorsAre error messages helpful and actionable?
10Help & DocumentationIs help available when needed?

Cognitive Psychology

Cognitive Load Types

Intrinsic Load     — Complexity inherent to the task itself
Extraneous Load    — Unnecessary complexity from poor design (eliminate this!)
Germane Load       — Mental effort for learning/understanding (support this)

Key Laws

Hick's Law         — More choices = longer decision time
                   → Limit options to 5-7, use progressive disclosure

Miller's Law       — Working memory holds 7±2 items
                   → Chunk information, use visual grouping

Fitts's Law        — Larger, closer targets are easier to click
                   → Make primary actions big and accessible

Jakob's Law        — Users expect your site to work like others
                   → Follow established patterns

Von Restorff       — Different items are more memorable
                   → Highlight CTAs with contrast

Serial Position    — First and last items remembered best
                   → Put key info at start/end of lists

Gestalt Principles

Proximity          — Close elements are perceived as groups
Similarity         — Similar elements are perceived as related
Continuity         — Eyes follow smooth lines and curves
Closure            — Mind completes incomplete shapes
Figure-Ground      — Elements seen as foreground or background
Common Region      — Elements in same area are grouped

Heuristic Evaluation

Process

1. Define scope         — What screens/flows to evaluate
2. Select evaluators    — 3-5 UX experts (80%+ issues found)
3. Independent review   — Each expert reviews alone
4. Apply heuristics     — Rate severity for each issue
5. Consolidate          — Merge findings, remove duplicates
6. Prioritize           — Rank by severity × frequency
7. Report               — Actionable recommendations

Severity Rating

LevelSeverityDescription
0Not a problemEvaluator disagrees it's an issue
1CosmeticFix only if extra time available
2MinorLow priority, causes friction
3MajorHigh priority, significant impact
4CatastrophicMust fix before release

Issue Template

## Issue: [Brief Description]

**Heuristic:** #N - Name
**Severity:** 0-4
**Location:** Screen / Component / Flow

**Problem:**
What's wrong and why it matters to users.

**Evidence:**
Screenshot or recording link.

**Recommendation:**
Specific fix with before/after comparison.

User Journey Mapping

Journey Map Structure

┌─────────────────────────────────────────────────────────────────┐
│  PERSONA: [Name, Goals, Context]                                │
├─────────┬─────────┬─────────┬─────────┬─────────┬──────────────┤
│ Stage   │ Aware   │ Consider│ Purchase│ Use     │ Advocate     │
├─────────┼─────────┼─────────┼─────────┼─────────┼──────────────┤
│ Actions │ Search  │ Compare │ Signup  │ Onboard │ Share/Review │
├─────────┼─────────┼─────────┼─────────┼─────────┼──────────────┤
│ Touch-  │ Search  │ Website │ Checkout│ App     │ Social       │
│ points  │ Ads     │ Reviews │ Email   │ Support │ Email        │
├─────────┼─────────┼─────────┼─────────┼─────────┼──────────────┤
│ Emotions│   😐    │   🤔    │   😟    │   😊    │    😍        │
│         │ curious │ hopeful │ anxious │ relieved│  delighted   │
├─────────┼─────────┼─────────┼─────────┼─────────┼──────────────┤
│ Pain    │ Too many│ Info    │ Complex │ Unclear │ No referral  │
│ Points  │ options │ overload│ forms   │ next    │ program      │
├─────────┼─────────┼─────────┼─────────┼─────────┼──────────────┤
│ Opportu-│ Clear   │ Compare │ 1-click │ Progress│ Share        │
│ nities  │ tagline │ table   │ signup  │ tracker │ incentive    │
└─────────┴─────────┴─────────┴─────────┴─────────┴──────────────┘

Touchpoint Analysis

For each touchpoint, evaluate:

1. Entry Point      — How do users arrive?
2. User Goal        — What are they trying to accomplish?
3. Friction         — What slows them down?
4. Emotion          — How do they feel?
5. Drop-off Risk    — Where might they abandon?
6. Opportunity      — How can we improve?

Accessibility (WCAG 2.2 AA)

POUR Principles

Perceivable     — Can users perceive the content?
                  ✓ Text alternatives for images
                  ✓ Captions for video
                  ✓ 4.5:1 color contrast
                  ✓ Resizable text (up to 200%)

Operable        — Can users operate the interface?
                  ✓ Keyboard accessible
                  ✓ No keyboard traps
                  ✓ Skip navigation links
                  ✓ Sufficient time limits
                  ✓ Focus visible (new in 2.2!)

Understandable  — Can users understand the content?
                  ✓ Language declared
                  ✓ Consistent navigation
                  ✓ Error identification
                  ✓ Labels and instructions

Robust          — Works with assistive technology?
                  ✓ Valid HTML
                  ✓ ARIA landmarks
                  ✓ Status messages announced

New in WCAG 2.2 (2023-2025)

Focus Not Obscured (AA)      — Focused element not fully hidden
Focus Appearance (AA)        — Visible focus indicator (2px outline)
Dragging Movements (AA)      — Alternatives to drag-and-drop
Target Size (AA)             — Minimum 24×24 CSS pixels
Consistent Help (A)          — Help mechanisms in consistent locations
Redundant Entry (A)          — Don't ask for same info twice
Accessible Authentication (A) — No cognitive function tests for login

Quick Checklist

## Accessibility Check

### Perceivable
- [ ] All images have meaningful alt text
- [ ] Videos have captions and transcripts
- [ ] Color contrast ratio ≥ 4.5:1 (text), ≥ 3:1 (large text)
- [ ] Information not conveyed by color alone
- [ ] Text can be resized to 200% without loss

### Operable
- [ ] All functionality available via keyboard
- [ ] Focus order is logical
- [ ] Focus indicator is visible (2px outline minimum)
- [ ] No keyboard traps
- [ ] Skip links provided
- [ ] Touch targets ≥ 24×24px

### Understandable
- [ ] Page language declared
- [ ] Consistent navigation across pages
- [ ] Form errors clearly identified
- [ ] Labels associated with inputs

### Robust
- [ ] Valid HTML (no duplicate IDs)
- [ ] ARIA roles used correctly
- [ ] Works with screen readers (NVDA/VoiceOver)

Interaction Patterns

Micro-interactions

Purpose of micro-interactions:
1. Feedback      — Confirm user action (button click, form submit)
2. Status        — Show current state (loading, progress)
3. Guidance      — Direct attention (onboarding tooltips)
4. Delight       — Create emotional connection (subtle animations)

Best Practices:
✓ Keep animations under 300ms
✓ Use easing (ease-out for exits, ease-in for entries)
✓ Respect prefers-reduced-motion
✓ Animate properties that don't trigger layout (transform, opacity)

Motion Design Principles

Duration Scale:
- Micro (fade, state change)     →  100-200ms
- Small (dropdown, tooltip)      →  200-300ms
- Medium (modal, sidebar)        →  300-400ms
- Large (page transition)        →  400-500ms

Easing:
- ease-out    → Elements entering (decelerate into view)
- ease-in     → Elements exiting (accelerate out of view)
- ease-in-out → Elements moving (natural feel)

Form Design

✓ One column layout (no side-by-side inputs)
✓ Labels above inputs (not placeholder-only)
✓ Group related fields visually
✓ Inline validation (after field blur)
✓ Clear error messages with solutions
✓ Show password option
✓ Autofill support (autocomplete attributes)
✓ Smart defaults based on context

Design System Integration

Component States

Every interactive component needs:

Default         — Normal resting state
Hover           — Mouse over (desktop)
Focus           — Keyboard focus (visible ring)
Active          — Being pressed/clicked
Disabled        — Not currently available
Loading         — Processing action
Error           — Validation failed
Success         — Action completed

Design Tokens

{
  "color": {
    "text": {
      "primary": "#1a1a1a",
      "secondary": "#6b6b6b",
      "disabled": "#a3a3a3",
      "inverse": "#ffffff"
    },
    "interactive": {
      "default": "#0066cc",
      "hover": "#0052a3",
      "active": "#003d7a",
      "focus": "#0066cc"
    },
    "feedback": {
      "error": "#d32f2f",
      "warning": "#f57c00",
      "success": "#388e3c",
      "info": "#1976d2"
    }
  },
  "spacing": {
    "xs": "4px",
    "sm": "8px",
    "md": "16px",
    "lg": "24px",
    "xl": "32px"
  },
  "radius": {
    "sm": "4px",
    "md": "8px",
    "lg": "16px",
    "full": "9999px"
  }
}

2025 UX Trends

AI-Driven Personalization

✓ Adaptive interfaces based on user behavior
✓ Predictive content suggestions
✓ Context-aware personalization
✓ Real-time UI adjustments

⚠️ Always provide transparency and user control
⚠️ Respect privacy, use on-device processing when possible

Anticipatory Design

Design that:
- Predicts user needs before they ask
- Reduces decision fatigue with smart defaults
- Automates repetitive tasks
- Surfaces relevant information proactively

Example: Pre-filling shipping address based on previous orders

Ethical Design Practices

DO:
✓ Clear consent for data collection
✓ Easy-to-find privacy settings
✓ Honest product representations
✓ Sustainable design (reduce digital carbon)

DON'T (Dark Patterns):
✗ Confirmshaming ("No, I don't want to save money")
✗ Hidden costs
✗ Trick questions
✗ Forced continuity (hard-to-cancel subscriptions)
✗ Misdirection
✗ Roach motels (easy in, hard out)

Evaluation Template

# UX Evaluation Report

## Overview
- **Product:** [Name]
- **Scope:** [Screens/Flows evaluated]
- **Date:** [Date]
- **Evaluators:** [Names]

## Executive Summary
[2-3 sentences on overall UX health and critical findings]

## Methodology
- Nielsen's 10 Heuristics
- WCAG 2.2 AA Compliance Check
- Cognitive Load Analysis

## Findings by Severity

### Catastrophic (Severity 4)
[Issues that must be fixed immediately]

### Major (Severity 3)
[High priority issues]

### Minor (Severity 2)
[Low priority improvements]

## Accessibility Status
- [ ] WCAG 2.2 A Compliance
- [ ] WCAG 2.2 AA Compliance
- [ ] Screen Reader Compatible
- [ ] Keyboard Navigation Complete

## Recommendations
[Prioritized action items with effort estimates]

## Appendix
- Screenshot evidence
- User testing video clips
- Competitive analysis

See Also

发现问题?提交给管理员复核

评分:

评论 (0)

暂无评论,成为第一个评论者吧!