技能:Token 构建
将 DTCG Token 事实源转换为平台就绪的输出。Token 只需编写一次;每个平台的输出自动生成。
步骤
- 阅读
workflows/token-build.md(架构、工具选项、解析规则、输出目标、CI)。 - 选择工具:Style Dictionary(多平台,默认)、Tokens Studio(Figma 拥有的 Token —— 与
figma-integration配合使用)、W3C DTCG 导出,或小型自定义脚本(参考scripts/validate_tokens.py)。 - 遵循解析规则:将别名解析为每个平台的最终值;暴露语义 Token + 组件 Token(基础 Token 保持内部);仅以增量形式输出基础/暗色/品牌/密度覆盖(
tokens/theming.json);按$type格式化。 - 生成请求的目标:CSS
:root变量、Tailwind v4@theme、类型化 JS/TS、iOS 资源目录 +Color.DS/Spacing、Androidcolors.xml/Compose 主题。 - 配置 CI:当
tokens/*.json发生更改时,运行scripts/validate_tokens.py,重新生成产物,如果提交的产物已过时则失败;使用scripts/contrast.py对颜色进行把关。
验证(完成定义)
python3 scripts/validate_tokens.py通过(无未解析的别名)。- 重新生成与已提交产物相比无差异。
- 暗色/品牌/密度输出仅包含增量,而不是完整副本。