用途
w-ui 用于构建或重塑面向用户的界面。它聚焦于有目的地设计 UI，复用现有设计令牌，实现无障碍交互，并进行有边界的渲染验证。如果只是规划功能而不涉及 UI 工作，应使用 /w-plan；如果只是安装原语组件，应使用 /w-shadcn。
主要能力
- 遵循仓库中已有的设计令牌和根目录 DESIGN.md（若存在），不自行发明 PRODUCT.md 或 DESIGN.md。
- 不安装动画库或设计检测钩子。
- 加载前端设计（frontend-design）以获取视觉方向，加载组合模式（composition-patterns）以获取可复用 API，加载网页设计指南（web-design-guidelines）以获取 UI 代码检查清单。
- 持久性任务记录在匹配的 MDX/README/DESIGN.md 中。
- 明确任务名称、目标用户和界面模式：操作（Operate，应用/任务）、说服（Persuade，营销）或阅读（Read，文档）。
- 使用简报、现有屏幕或指定的美学风格。如果仓库有令牌和共享组件，优先检查这些。
- 优先使用共享原语。在第二个调用点进行组合。不为一次性路由提取复合 API。不将服务器数据提升到客户端提供者。
- 移动优先布局，可见焦点，键盘路径，prefers-reduced-motion。不添加新的动效库。
- 覆盖加载、空、错误、成功和溢出等适用状态。
- 实现完成该任务的最小切片。
使用方式
- 明确任务、目标用户和界面模式。
- 检查现有设计令牌、共享组件和 DESIGN.md。
- 加载 frontend-design、composition-patterns 和 web-design-guidelines 参考。
- 实现最小切片，遵循移动优先、无障碍和状态覆盖要求。
- 同时检查桌面端和移动端，测试主要交互和键盘导航。
- 评审截图，批量修复有证据的问题。
- 最多再确认一次，然后停止。
- 如果缺少浏览器工具，需说明。类型检查不是视觉 QA。
可选步骤：
- 使用 /w-a11y 对照现有无障碍文档和测试（不要自行发明 WCAG 等级）。
- 仅当已有 Playwright E2E 规范覆盖该路径时使用 Playwright E2E。
- 如果行为或命令发生变化，使用 /w-docs 更新文档。
适用场景
- 需要构建或重塑用户界面，且希望遵循现有设计系统。
- 需要确保无障碍交互和响应式布局。
- 需要覆盖多种 UI 状态（加载、空、错误、成功、溢出）。
- 需要以最小切片方式完成 UI 任务并进行渲染验证。
限制
- 不适用于纯功能规划（应使用 /w-plan）。
- 不适用于仅安装原语组件（应使用 /w-shadcn）。
- 不自行发明 PRODUCT.md 或 DESIGN.md。
- 不安装动画库或设计检测钩子。
- 不添加新的动效库。
- 不将服务器数据提升到客户端提供者。
- 不为一次性路由提取复合 API。
- 类型检查不能替代视觉 QA。
- 缺少浏览器工具时需说明，无法进行渲染验证。
- 使用 /w-a11y 时不要自行发明 WCAG 等级。
- Playwright E2E 仅在已有规范覆盖路径时使用。