ux-review — UX 规范审查

技能目的

审查指定 UX 规范的无障碍性合规度与 SRS 需求对齐度，检查 ARIA 标注、键盘导航、焦点管理、状态覆盖与需求追溯，输出审查报告。

参数说明

• [UX规范路径]：待审查的 UX 规范文件路径，例如 docs/design/ux/login.md。

分阶段工作流

阶段 1：读取 UX 规范与关联 SRS

• 输入：UX 规范路径参数
• 处理：
  1. 使用 Read 读取 UX 规范文件
  2. 使用 Grep 提取规范中引用的 SRS 需求编号
  3. 使用 Read 读取关联 SRS 的用户故事列表
  4. 使用 Read 读取 docs/design/design-system-spec.md 获取组件规范
• 输出：UX 规范内容 + 关联需求

阶段 2：无障碍性检查

• 输入：UX 规范内容
• 处理：
  1. 检查是否定义 ARIA 角色与标签
  2. 检查键盘导航路径是否完整（Tab 顺序、快捷键）
  3. 检查焦点管理是否覆盖模态、抽屉等容器
  4. 检查色彩对比度是否达到 WCAG AA 标准
  5. 检查屏幕阅读器兼容性
• 输出：无障碍性检查清单

阶段 3：SRS 对齐度检查

• 输入：UX 规范 + 关联 SRS
• 处理：
  1. 逐条验证 SRS 用户故事是否在 UX 规范中有对应界面设计
  2. 检查界面状态是否覆盖所有需求场景
  3. 检查事件流是否满足需求中的业务流程
  4. 标记未覆盖或偏离的需求
• 输出：SRS 对齐度矩阵

阶段 4：设计系统一致性检查

• 输入：UX 规范 + 设计系统规范
• 处理：
  1. 验证 UX 规范引用的组件是否在设计系统中定义
  2. 验证使用的令牌是否与设计系统一致
  3. 标记未定义的自定义组件或令牌
• 输出：设计系统一致性报告

阶段 5：输出审查报告

• 输入：以上所有检查结果
• 处理：
  1. 汇总无障碍性、SRS 对齐度、设计系统一致性三个维度结论
  2. 使用 Write 生成审查报告
  3. 给出 PASS / CONCERNS / FAIL 结论
• 输出：UX 审查报告

协作协议引用

• 遵循 .claude/docs/templates/collaborative-protocols/design-agent-protocol.md 审查规范
• 参考 WCAG 2.1 AA 标准进行无障碍性检查
• 审查报告写入 docs/design/ux/{界面名}-review.md

推荐下一步

根据审查报告修复问题项。修复后重新运行本技能验证。通过后进入预开发阶段使用 /create-epics 创建 Epic。