关于 rgaa
rgaa 是依据法国 RGAA 4.1.2 无障碍标准检查代码的审计技能。它引导审查 13 个主题,并以 Markdown 文件和对话内容输出结构化合规报告。
主要功能
- 01检查 HTML、JSX 和 CSS
- 02审查 13 个主题的标准
- 03标记符合、不符合或不适用
- 04说明问题并分配优先级
- 05保存带日期的 Markdown 审计报告
适用场景
- 01审计页面或组件中的无障碍问题
- 02记录项目的 RGAA 审查结果
- 03确定影响辅助技术用户的问题优先级
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ etalab-ia/ skills --skill rgaa安装后在 Claude Code 中输入/rgaa确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/criteres-formulaires.mdcriteres-images-cadres-couleurs.mdcriteres-multimedia-tableaux-liens-scripts.mdcriteres-navigation-consultation.mdcriteres-structure-presentation.md详细介绍
RGAA 4.1.2 — 合规审计工具
法国数字无障碍参考标准。106 项标准,分为 13 个主题。基于 WCAG 2.1 AA 级。
来源:https://accessibilite.numerique.gouv.fr/
审计工作流
- 分析提供的代码(HTML、JSX、CSS)
- 遍历 RGAA 的 13 个主题,查阅详细的参考文件
- 针对每项标准,评定一个状态:
- C — 合规:标准得到遵守
- NC — 不合规:标准被违反(指出相关元素和问题)
- NA — 不适用:该标准对此内容无对象(说明理由)
- 生成结构化报告,按照以下格式
- 导出报告:将报告写入一个 Markdown 文件,并在对话中显示
合规报告格式
## Audit RGAA 4.1.2 — Rapport de conformité
**Date :** JJ/MM/AAAA
**Périmètre audité :** [description du code / page / composant]
**Résultat global :** X% conforme
(X critères applicables — X conformes, X non conformes, X non applicables)
---
### Tableau de synthèse
| Thème | C | NC | NA |
|-------|---|----|----|
| 1. Images | | | |
| 2. Cadres | | | |
| 3. Couleurs | | | |
| 4. Multimédia | | | |
| 5. Tableaux | | | |
| 6. Liens | | | |
| 7. Scripts | | | |
| 8. Éléments obligatoires | | | |
| 9. Structuration | | | |
| 10. Présentation | | | |
| 11. Formulaires | | | |
| 12. Navigation | | | |
| 13. Consultation | | | |
| **Total** | | | |
---
### Non-conformités détectées
**[NC] {ID} — {Intitulé du critère}**
- **Élément concerné :** `<code>` ou description de l'endroit dans la page
- **Problème :** description précise de la violation
- **Correction :** action concrète à mener
- **Priorité :** 🔴 Bloquant / 🟠 Majeur / 🟡 Mineur
---
### Critères conformes
{ID1}, {ID2}, {ID3}... (liste compacte)
### Critères non applicables
- **{ID}** — {justification courte}
报告导出
生成报告后,始终:
- 如果项目根目录下不存在
audits/文件夹,则创建它 - 将完整报告写入
audits/rgaa-AAAA-MM-JJ.md(当天日期,ISO 格式) - 同时在对话中显示报告
如果同名文件已存在,则添加递增后缀:rgaa-2026-03-26-2.md。
示例:
audits/rgaa-2026-03-26.md
优先级网格
| 优先级 | 定义 | 示例 |
|---|---|---|
| 🔴 阻塞 | 阻碍 AT 用户访问内容或功能 | 缺少 alt 的图片、没有 label 的字段、空链接、键盘陷阱 |
| 🟠 重大 | 对体验有强烈影响,但某些 AT 可以绕过 | 对比度不足、焦点不可见、标题层级断裂、链接不明确 |
| 🟡 轻微 | 轻度妨碍,体验下降但无阻塞 | 缺少 autocomplete、缺少表格 caption、未提示新窗口 |
标准详细参考
每个参考文件列出各项标准及其条件、代码测试、典型不合规情况和优先级。
- 图片、框架、颜色(主题 1–3,14 项标准):references/criteres-images-cadres-couleurs.md
- 多媒体、表格、链接、脚本(主题 4–7,28 项标准):references/criteres-multimedia-tableaux-liens-scripts.md
- 必备元素、结构、呈现(主题 8–10,28 项标准):references/criteres-structure-presentation.md
- 表单(主题 11,13 项标准):references/criteres-formulaires.md
- 导航、浏览(主题 12–13,23 项标准):references/criteres-navigation-consultation.md
评论
支持 Markdown