用途:该技能用于任何涉及用户界面的工作,在生成、修改或审查渲染、样式或连接用户界面的代码前调用,提供无障碍 UI 的检查清单。每条规则先给出平台无关原则,再在适用时给出 Web(HTML+ARIA+CSS)实现;仅当输出为 Web 时应用 Web 指南。
主要能力:包含无障碍“宪法”与检查清单。核心原则包括:无障碍是核心成果而非收尾步骤;面向屏幕阅读器、纯键盘、低视力、认知、听障、运动/语音/开关及情境用户等真实人群;实现优先级为复用现有组件、组件库、原生语义、原生元素加最少 ARIA、最后才自定义 ARIA 组件;无障碍与性能、安全、视觉设计是共同约束而非取舍;尊重现有代码,范围外问题先记录并询问。
检查清单覆盖:优先复用现有组件;平台原生语义;区域/地标;标题层级;跳过重复导航;名称/角色/值;名称与可见标签一致;标签与帮助文本;分组;必填字段;键盘可操作性;焦点管理;隐藏内容;图形替代文本;对比度;尊重系统无障碍设置;重排;导航;表格/网格;状态消息;测试;规格与文档。
使用方式:先识别请求涉及的组件类型(表单、复选框组、单选组、展开、模态、整页等),打开对应的 components/<name>.md 一次,再按清单执行;仅在条目不清楚或需要具体修复模式时打开 references/*.md,不要预加载,避免重复读取。
适用场景:任何渲染、样式或连接用户界面的代码工作。不适用于:仅后端变更、数据迁移、构建/CI 配置、非 UI 测试,或不触及 UI 层的任务。
限制:不得声称输出“完全无障碍”,应说明已处理内容与已知局限。测试方面,除非项目明确选择退出,否则需添加并运行自动化无障碍测试,且最终测试必须针对提交的确切产物,通过后任何编辑都会使测试失效,需重新运行。Web 优先使用与现有测试运行器匹配的 @axe-core/* 绑定;其他平台使用原生审计工具。具体文件内容与更多细节暂未提供。