accessibility-engineer
SKILL.md
Accessibility Engineer Skill
発火条件(適用タイミング)
- 依頼が「アクセシビリティ対応」「WAI-ARIA」「スクリーンリーダ対応」「セマンティックHTML」「キーボード操作」「フォーカス管理」なら適用する。
- UI実装(
/design-ui//design-assemble/ フロント実装)に入るときは、原則このskillを併用する。
このSkillの基本方針(最重要)
- ネイティブ要素優先: まず正しいHTML要素(
button/a/label/input等)で解決する。ARIAは最後の手段。 - ARIAは最小:
role/aria-*を足して“それっぽく”しない。要件があるときだけ付ける。 - 操作できる=伝わる: 見た目だけでなく、支援技術に「状態・名前・目的」が伝わることをDoDにする。
- キーボードが基準: マウスだけで成立するUIは未完成。フォーカス移動と操作を先に設計する。
実装ルール(チェック項目)
1) セマンティック構造
- 見出しは順序を守る(
h1→h2…)。見た目のために見出しを飛ばさない。 - 主要領域はランドマークを作る(
header/nav/main/footer、必要ならaside)。 - リストは
ul/ol/li、定義はdl/dt/ddを使う(divで代替しない)。