---
name: Accessibility I18n
slug: accessibility-i18n
category: Frontend
description: Accessibility I18n handles accessibility and localization review for user-facing UI, CLI output, and docs. Use it when tasks involve keyboard flow, focus, screen readers, ARIA, RTL, translations, locale formats, or multilingual content.
github: "https://github.com/devcodex-labs/devcodex/tree/main/content/skills/accessibility-i18n"
language: JavaScript
stars: 202
forks: 26
install: "npx degit https://github.com/devcodex-labs/devcodex/tree/main/content/skills/accessibility-i18n ~/.claude/skills/accessibility-i18n"
installs_to: ~/.claude/skills/accessibility-i18n
source_path: content/skills/accessibility-i18n/SKILL.md
collection_size: 25
category_size: 653
collection_url: "https://dirskills.com/collections/devcodex-labs/devcodex"
added: 2026-09-05T05:30:16.586Z
last_synced: 2026-09-05T05:30:16.586Z
canonical_url: "https://dirskills.com/skills/accessibility-i18n"
---

# Accessibility I18n

Accessibility I18n handles accessibility and localization review for user-facing UI, CLI output, and docs. Use it when tasks involve keyboard flow, focus, screen readers, ARIA, RTL, translations, locale formats, or multilingual content.

**Install:**

```bash
npx degit https://github.com/devcodex-labs/devcodex/tree/main/content/skills/accessibility-i18n ~/.claude/skills/accessibility-i18n
```

## README

# Accessibility I18n Skill

## 定位

本 Skill 负责无障碍与国际化 Owner 视角。它不替代设计系统或前端实现，而是确保用户可见界面、CLI 输出、文档、表单、导航和多语言内容对不同能力、语言、地区和输入方式的用户都可理解、可操作、可恢复。

## 触发条件

| 场景 | 是否触发 |
|------|:--------:|
| UI、表单、导航、弹窗、快捷键、焦点、键盘操作、屏幕阅读器、ARIA、语义 HTML | 必须 |
| 文档站、README、CLI 输出、错误信息或用户可见文案涉及多语言、地区格式、时间数字货币、RTL 或翻译资源 | 必须 |
| 设计系统、前端架构或用户文档变更影响可访问性和本地化 | 必须 |
| 纯内部实现且没有用户可见输出、交互或文本 | N/A + skipReason |

## 核心门禁

| Gate | 要求 | 证据 |
|------|------|------|
| `AccessibilityI18nGate` | 无障碍、国际化和本地化必须绑定真实用户路径和验证路线 | userNeedsMatrix、runtimeVerification |
| `KeyboardFocusGate` | 所有可交互路径必须可键盘到达、操作、退出和恢复 | keyboardFocusModel |
| `ScreenReaderSemanticsGate` | 语义、label、role、name、state、错误提示必须能被辅助技术理解 | screenReaderSemantics |
| `LocaleContentGate` | 文案、日期、数字、货币、复数、排序、时区和翻译资源必须有 locale 策略 | localeContentModel |
| `RtlAndLayoutGate` | RTL、长文本、多语言换行和布局膨胀不得破坏主路径 | rtlFormatting |
| `FallbackRecoveryGate` | 缺翻译、无障碍失败或用户输入错误时必须有可恢复路径 | fallbackRecovery |
| `InteractiveSemanticProbe` | 每个交互对象必须验证 role、accessible name、可聚焦性、键盘动作和关闭后的焦点恢复 | semanticInteractionMatrix、runtime evidence |

## 执行步骤

1. 识别目标用户、能力差异、语言地区和输入方式。
2. 建立用户路径矩阵：页面、CLI、文档、表单、错误、导航、状态反馈。
3. 审查键盘、焦点、语义、屏幕阅读器、错误恢复和状态公告。
4. 审查 locale 内容模型：文案、格式、翻译资源、RTL、长文本和 fallback。
5. 对链接、按钮、菜单、对话框、可展开控件和自定义交互执行 `InteractiveSemanticProbe`：核对 role、accessible name、focusability、Enter/Space/Escape 行为和 focus recovery。
6. 选择验证路线：源码语义、浏览器键盘/辅助技术 smoke、文档预览、测试或人工证据；截图只能证明视觉状态，不能替代交互语义证据。
7. 在技术方案、TestRoute 或报告中写明未触发场景的 `N/A + skipReason`。

## 输出字段

```markdown
## AccessibilityI18nGate

| 字段 | 内容 |
|------|------|
| userNeedsMatrix | 用户能力、语言地区、输入方式和任务路径 |
| keyboardFocusModel | Tab 顺序、焦点可见性、快捷键、退出和恢复 |
| screenReaderSemantics | 语义结构、label、role、state、错误公告 |
| localeContentModel | 翻译、日期数字货币、复数、排序、时区、fallback |
| rtlFormatting | RTL、长文本、换行、布局膨胀、方向切换 |
| runtimeVerification | 浏览器 / CLI / 文档预览 / 测试 / 人工证据 |
| interactiveSemantics | role、accessible name、focusability、Enter/Space/Escape、focus recovery |
| focusRecovery | Escape/关闭/失败恢复后焦点回到触发对象或下一合法任务点的运行态证据 |
| fallbackRecovery | 缺翻译、格式错误、无障碍失败和用户误操作恢复 |
| evidenceMatrix | 判断 -> 代码 / 渲染 / 测试 / 文档 / 截图 / 用户路径 |
```

## 反模式

| 反模式 | 修正 |
|--------|------|
| 只写“支持无障碍”，没有键盘和焦点证据 | 补 `KeyboardFocusGate` 和真实路径验证 |
| 只翻译静态文案，不处理日期、数字、复数、RTL 和 fallback | 补 `LocaleContentGate` 与 `RtlAndLayoutGate` |
| 用颜色或图标作为唯一状态信号 | 增加文本、语义状态和辅助技术可读信息 |
| 文档站只看 markdown 源码，不看生成后的导航和流程图 | 补 rendered / site preview 证据 |
| 用截图或 DOM 存在证明控件可访问 | 执行 InteractiveSemanticProbe；视觉存在不等于键盘可操作或辅助技术可理解 |

## 与其他 Skill 的关系

- `frontend-architecture`：负责组件、状态和渲染稳定性；本 Skill 负责可访问和本地化用户路径。
- `design-system-architecture`：负责 token、组件变体和主题契约；本 Skill 负责包容性验证。
- `ux-interaction-architecture`：负责任务流和交互反馈；本 Skill 负责键盘、辅助技术和语言地区覆盖。
- `user-manual-authoring`：用户文档多语言或站点导航应叠加本 Skill。