accessibility-contrast-audit

[设计系统] UI可访问性定量审计 - 对比度、字体大小、点击目标、标题层次结构。当(1)检查WCAG颜色对比度合规性,(2)审计文本大小以提高可读性,(3)验证触摸/点击目标大小,(4)审查标题结构和地标,(5)用户要求"检查可访问性"、"审计对比度"、"WCAG合规性"或"a11y检查"时使用。

📖 中文导读:[设计系统] UI可访问性定量审计 - 对比度、字体大小、点击目标、标题层次结构。当(1)检查WCAG颜色对比度合规性,(2)审计文本大小以提高可读性,(3)验证触摸/点击目标大小,(4)审查标题结构和地标,(5)用户要求"检查可访问性"、"审计对比度"、"WCAG合规性"或"a11y检查"时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: accessibility-contrast-audit description: "[Design System] Quantitative accessibility audit for UI - contrast ratios, font sizes, tap targets, heading hierarchy. Use when (1) checking WCAG color contrast compliance, (2) auditing text sizes for readability, (3) validating touch/click target sizes, (4) reviewing heading structure and landmarks, (5) user asks to 'check accessibility', 'audit contrast', 'WCAG compliance', or 'a11y check'."

Accessibility & Contrast Audit

Quantitative accessibility checks for contrast, font size, hit areas, and semantic structure.

Quick Start

python3 scripts/audit_accessibility.py --source src/ --tokens tokens.json

WCAG Standards Reference

Criterion Level AA Level AAA
Normal text contrast 4.5:1 7:1
Large text contrast (18px+ or 14px bold) 3:1 4.5:1
UI components/graphics 3:1 3:1
Minimum touch target 44×44px 44×44px
Minimum font size (body) 16px 16px

Problem Types

Type Severity Description
low-contrast error Text/background contrast below WCAG threshold
text-too-small warning Font size below recommended minimum
hit-area-too-small warning Touch/click target below 44×44px
heading-skip warning Heading levels skipped (h1→h3)
missing-alt error Image missing alt text