无障碍修复技能
用小范围修正审查名称、键盘操作、焦点、语义与状态播报。
社区 · ibelick| 作者 | ibelick |
|---|---|
| 许可证 | MIT |
| 来源 | ibelick/ui-skills · GitHub 上的 SKILL.md |
| 项目官网 | www.ui-skills.com |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
fixing-accessibility 指导代理在现有技术栈内修复具体 UI 无障碍问题。
优先检查控件名称、键盘访问、焦点、原生语义与关联的表单错误。检查表审查不等于合规认证。
摘自该技能的 SKILL.md: # fixing-accessibility
功能
- 查找缺失名称、无法到达的控件和异常焦点行为。
- 使用原生语义,将错误与对应字段关联。
- 审查状态播报、对比度、字幕和动态效果偏好。
产出内容
- 针对性的 HTML、ARIA、CSS 或组件修改。
- 对应准确代码片段与故障的审查说明。
适用场景
- 交付前审查表单、对话框或交互组件。
- 在当前 UI 库内修复键盘与读屏问题。
不适用的场景
- 将单纯源码审查视为完整辅助技术审计。
所需条件
- 目标界面的源码访问权限及实施所需修复的授权。
- 运行验证需要浏览器和辅助技术;不强制依赖软件包、账号或 MCP 服务器。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 按优先级排列的无障碍规则与示例。 |
2026-11-17 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 修复此对话框的初始焦点、焦点限制、Escape 关闭与焦点恢复。
- 用原生标签与适当 ARIA 将这些表单错误关联到输入框。
- 审查工具栏的键盘可达性与控件无障碍名称。
如何安装 fixing-accessibility
现有技术栈
将技能文件夹复制到可检查项目的代理中即可。它不会安装 UI 库或自动审计工具。
用浏览器和读屏测试验证修改后的行为,不要声称运行了实际未做的测试。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p ~/.claude/skills
cp -R ui-skills/skills/fixing-accessibility ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /fixing-accessibility,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/ibelick/ui-skills.git
mkdir -p .agents/skills
cp -R ui-skills/skills/fixing-accessibility .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
以运行证据支持小范围修正
源码要求准确片段、具体故障和有限修正,不鼓励无关重构或迁移库。
修复后检查完整交互,包括错误播报和焦点是否回到正确控件。
关于 fixing-accessibility 的常见问题
需要无障碍库吗?
不需要。它优先使用项目已有的原生元素与成熟基础组件。
应该到处添加 ARIA 吗?
不应该。优先使用原生语义,多余 ARIA 可能反而让界面难用。
它涵盖动态效果吗?
包含减少动态效果与媒体指导,同时优先处理名称、键盘和焦点规则。
完成审查就能证明符合 WCAG 吗?
不能。范围、内容与真实辅助技术行为仍需更全面验证。
更多 AI 技能
相关技能
MJML HTML 邮件技能
社区 · Framix生成 MJML 邮件源码与编译后 HTML,执行严格校验及邮件客户端专项检查。Improve UI 界面审查技能
社区 · ibelick根据已证实的设计依据审查一个产品界面,并为选定问题编写实施计划。动画性能修复技能
社区 · ibelick检查测量、滚动工作、绘制成本与合成行为,修复动画卡顿。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。引用卡片与文字图形 技能
社区 · Frank Heijdenrijk选择一句有力原文并正确署名,规划易读文字卡片,不编造引文。