设计系统工程原则

# 务实设计系统工程师的设计系统品味 - 在单一源文件中定义颜色、间距、排版、圆角和动效的设计令牌，并从中生成CSS变量和平台输出。置信度：0.90 - 按用途命名令牌，如color-text-muted或space-inset-md，而非按原始值如gray-500或16px。置信度：0.85 - 通过交换语义令牌值来支持亮色和暗色主题，绝不覆盖单个组件样式。置信度：0.90 - 基于可访问的无头原语构建组件，如Radix UI或React Aria，而非重新实现焦点和键盘逻辑。置信度：0.85 - 为每个令牌配对满足WCAG 2.2 AA对比度，并在令牌变化时自动检查。置信度：0.90 - 保持组件API精简：几个命名良好的变体和尺寸胜过数十个布尔属性。置信度：0.85 - 对于对话框和菜单等复杂组件，优先使用插槽或子元素的组合，而非配置对象。置信度：0.80 - 转发ref并将剩余属性展开到根元素上，使组件适用于表单、工具提示和测试。置信度：0.85 - 绝不在组件内部硬编码颜色、间距或字体大小；使用Stylelint或ESLint规则对原始值进行lint检查。置信度：0.85 - 在Storybook中记录每个组件，包含使用指南、做与不做的示例以及实时控件。置信度：0.85 - 在每个拉取请求上使用Chromatic或Playwright截图运行视觉回归测试。置信度：0.80 - 在组件测试中运行axe自动化可访问性检查，并在发布前仍手动测试键盘和屏幕阅读器流程。置信度：0.85 - 将库作为带语义化版本和由Changesets生成的变更日志的版本化包发布。置信度：0.90 - 将重命名属性或移除变体视为破坏性变更，并为大型迁移提供codemods。置信度：0.75 - 先弃用再移除：标记旧API，记录仅开发环境的警告，并在下一个主版本中移除。置信度：0.85 - 提供ESM格式，支持按组件拆分的可摇树入口点，并正确标记CSS文件的副作用。置信度：0.80 - 尊重prefers-reduced-motion，并保持动效令牌简短且有目的性。置信度：0.80 - 将图标作为独立包，包含优化的SVG组件，并保持一致的大小和描边令牌。置信度：0.75 - 使用逻辑CSS属性如margin-inline-start，使组件适用于从右到左的布局。置信度：0.75 - 通过共享令牌名称并在每次发布时审查漂移，保持Figma组件和代码组件同步。置信度：0.70 - 通过扫描产品仓库中的库导入和一次性覆盖来衡量采用情况。置信度：0.65 - 通过简短的提案模板接受贡献，该模板在任何代码之前涵盖用例、API和可访问性。置信度：0.70