约束工程

📌 Skill基础信息

技能名称: ARIA Patterns (无障碍富互联网应用模式)

技能简称: aria-patterns

来源: 社区第三方 (Intense-Visions)

运行宿主: Claude-Code CLI

核心定位: 提供ARIA角色、状态和属性的正确使用模式，为自定义组件增强辅助技术支持，提升Web应用的无障碍访问能力。

🧩 内部核心组成

技能类型: 知识参考型技能 (非工具执行型)

核心组件:

• 知识文档: 包含ARIA使用的最佳实践、模式和常见错误
• 机械约束规则: 集成到 harness-accessibility 扫描器中的两条强制规则
• 模式库: 覆盖对话框、选项卡、组合框、表单验证等常见组件模式

机械约束规则表:

规则编号	检测内容	执行方式
A11Y-014	在可聚焦元素上使用 aria-hidden="true"	静态代码扫描
A11Y-042	使用正数 tabindex 破坏自然Tab顺序	静态代码扫描

知识范畴: 角色定义、状态管理、属性配置、动态内容播报、表单验证等ARIA全领域

🛠 安装与启用方式

安装命令:

skills install --user Intense-Visions/harness-engineering

前置要求:

• Claude-Code CLI 环境
• 已配置 harness-engineering 框架

集成方式: 作为知识库被其他技能和Agent消费使用，无需单独启动

📋 标准工作流

1. 开发阶段: 开发者在编写自定义组件时参考本技能提供的ARIA模式
2. 代码编写: 按照文档指导应用正确的ARIA角色、状态和属性
3. 静态检测: AriaScanner 自动检测违反 A11Y-014 和 A11Y-042 规则的代码
4. 人工审查: 对于无法机械检测的规则（如键盘可操作性、动态状态同步），依赖开发者人工审查
5. 测试验证: 使用浏览器开发者工具的无障碍树验证ARIA属性效果

⚠️ 关键限制、缺陷、注意事项

技术限制:

• 仅支持静态可判定值的机械检测，动态表达式（如 aria-hidden={expr}）无法检测
• 部分重要规则（如可访问名称存在性、键盘支持）无法自动化 enforcement
• 依赖开发者的理解和正确实施，非全自动解决方案

适用性:

• ✅ 适合：自定义组件开发、需要增强无障碍支持的Web应用
• ❌ 不适合：纯原生HTML组件、无需无障碍要求的内部工具

生产环境: 可作为开发参考指南使用，但需要配合其他测试工具确保完整无障碍合规

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景:

• 开发自定义交互组件（无原生HTML等效元素）
• 需要为元素添加可访问名称或描述
• 需要向屏幕阅读器播报动态内容变化
• 需要指示展开/折叠、选中、错误等状态
• 原生HTML语义不足时的补充方案

❌ 不适合场景:

• 已有原生HTML元素可满足需求的场景（违反ARIA第一原则）
• 简单的静态内容页面，无需复杂交互
• 对无障碍要求极低或不存在的内部工具
• 无法保证键盘操作支持的组件开发

skills install --user Intense-Visions/harness-engineering