用途:审查代码库中 shadcn/ui 组件的使用,确保界面可访问、风格一致且易于维护,并给出问题定位与改进建议。
主要能力:覆盖五类审计——可访问性(ARIA 标签、标题层级、图片 alt、键盘导航、表单标签、语义化 HTML、焦点指示、按钮与链接区分、跳转链接);组件一致性(变体、样式方式、重复实现、间距、图标、排版、错误与加载状态);组件抽取机会(重复 3 次以上的模式、复杂内联 JSX、表单字段组、布局、弹窗、表格、卡片、空状态、骨架屏);布局与响应式(断点、容器宽度、Grid/Flex、移动优先、溢出、滚动、定位、z-index);shadcn/ui 最佳实践(从 @/components/ui 导入、组合模式、variant、表单、对话框、toast、下拉、表格)。
使用方式:先用 Glob 扫描组件文件(如 /*.tsx、app//.tsx、components/**/.tsx),再用 Grep 检索表单、按钮、aria-、style=、img、onClick 等模式,随后读取文件分析结构、props、状态、事件、条件渲染与可访问性属性,最后按严重问题、警告、建议、最佳实践生成审计报告,可参考 references/audit-checklist.md。
适用场景:审计 UI 可访问性、检查 shadcn/ui 使用一致性、发现重复组件、检查布局与响应式、审查表单与错误处理、验证设计系统遵循情况。
限制:资料未提供安装命令、收费、价格、平台或效果数据;审计结论依赖代码库实际情况,需人工确认。