核心定位
AIOZ UI V2 Skill 是专为 React 组件开发打造的设计系统工具，核心价值在于消除设计与开发之间的 Token 映射摩擦。它并非通用 UI 库，而是围绕 AIOZ 品牌设计系统构建的代码生成规范，强制要求开发者通过预设 Token（如 --sf-neu-block、text-title-01）而非原始 Tailwind 类名进行样式编写。
显著优点
1. 严格的 Token-first 架构：彻底禁止 text-gray-500、bg-white 等原始 Tailwind 写法，通过 bg-sf-screen、text-subtitle-neutral 等语义化 Token 确保跨项目视觉一致性，降低设计漂移风险。
2. Figma MCP 无缝衔接：提供从 Figma 设计稿到生产代码的完整工作流——颜色 Token、字体样式、图标层名均有明确映射表，显著缩短设计还原周期。
3. Typography 原子化：text-body-02、text-title-03 等工具类已内聚 font-size、line-height、weight、font-family，避免样式堆叠导致的不可预测性。
4. 组件化优先：推荐直接使用 @aioz-ui/core-v2/components 的原子组件（Button、Input、Badge、Table），减少手写 div 的维护成本。
潜在局限
- 生态锁定：高度依赖 AIOZ 私有包（
@aioz-ui/core-v2、@aioz-ui/icon-react），无法直接迁移至其他设计系统或开源方案（如 shadcn/ui）。 - 学习曲线：开发者需记忆大量 Token 命名规则（如
sf-neu-blockvssf-neutral-block的区别），参考文档缺一不可。 - Tailwind 版本耦合：
tw-inline.css提供自定义工具类，若项目 Tailwind 配置与预期不符，可能导致类名失效。
适合人群
- 使用 AIOZ 设计系统的内部开发团队
- 需将 Figma 设计稿快速转化为符合品牌规范的 React 代码的前端工程师
- 追求设计系统一致性、愿接受约束换取可维护性的项目
常规风险
| 风险点 | 说明 |
|--------|------|
| Token 误用 | 直接使用 Tailwind 原生色值导致视觉不一致 |
| 图标导入错误 | 未按 PascalCase+`Icon` 后缀规范导入，或混用其他图标库 |
| Typography 堆叠 | 在 `text-body-02` 上追加 `font-medium` 破坏预设字重 |
| 状态遗漏 | 忽略 hover/focus/disabled 的 Token 类名，交互体验降级 |