用途:将 DTCG 令牌源文件(.claude/skills/_ux-ui-shared/tokens/*.json)作为唯一事实来源,生成各平台可直接使用的产物,主要构建目标为 app/globals.css(Tailwind v4 @theme inline),并保持 blue-primary 主题。
主要能力:支持多平台输出,包括 CSS :root 变量、Tailwind v4 @theme、带类型的 JS/TS、iOS Asset Catalog 与 Color.DS/Spacing、Android colors.xml 与 Compose 主题。工具可选 Style Dictionary(默认,多平台)、Tokens Studio(配合 figma-integration)、W3C DTCG 导出或自定义脚本(参考 validate_tokens.py)。
解析规则:按平台把别名解析为最终值;只暴露语义令牌与组件令牌,基础令牌保持内部;主题覆盖(theming.json 中的 dark/brand/density)仅以增量形式输出;按 $type 格式化。
使用方式:先阅读 workflows/token-build.md 了解架构、工具选项、解析规则、输出目标与 CI;选择工具后生成所需目标;在 CI 中监听 tokens/*.json 变更,运行 validate_tokens.py 校验并重新生成,若已提交产物过期则失败,并用 contrast.py 对颜色做对比度门禁。
完成标准:validate_tokens.py 通过(无未解析别名);重新生成与已提交产物无差异;dark/brand/density 输出只含增量而非完整副本。
限制:资料未提供具体安装命令、依赖版本、收费与平台支持细节;构建 UI 的工作交由 shadcn-ui-design 处理。