mcpField
T
token-build

token-build

github.com/plugin87设计与 UI3.0k492 次安装1 天前更新
代码仓库

关于 token-build

token-build 是用于将 DTCG 令牌源转换为平台就绪文件的设计系统 Skill,指导团队生成输出、验证令牌并配置 CI 检查。

主要功能

  1. 01生成 CSS、Tailwind、JS/TS、iOS 和 Android 输出
  2. 02解析别名并处理平台值
  3. 03将主题覆盖输出为差异
  4. 04验证令牌与颜色对比度
  5. 05在 CI 中检查生成文件

适用场景

  1. 01为多个平台生成设计令牌
  2. 02在 CI 中加入令牌生成与验证

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill token-build

安装后在 Claude Code 中输入/token-build确认已加载。

详细介绍

技能:令牌构建

步骤 0:工具包是否在此处? 此技能会读取工具包中的文件。请检查一次: ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING 仅当结果为 KIT_MISSING 时,才表示只安装了技能文件夹,这是 npx skills add 的行为。请明确说明这一点,告诉用户使用 npx ux-ui-agent-skills init 或安装插件,然后停止。不要猜测 无法打开的文件内容。

将 DTCG 令牌事实来源转换为适用于各平台的输出。令牌只需编写一次;每个平台的输出都会自动生成。

步骤

  1. 阅读 ${CLAUDE_SKILL_DIR}/../../../workflows/token-build.md(架构、工具选项、解析规则、输出目标、CI)。
  2. 选择工具:Style Dictionary(支持多平台,默认选项)、Tokens Studio(由 Figma 管理的令牌;与 figma-integration 配合使用)、W3C DTCG 导出,或小型自定义脚本(参照 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py)。
  3. 遵循解析规则:按平台将别名解析为最终值;公开语义令牌和组件令牌(基础令牌保持内部使用);生成基础、深色、品牌和密度覆盖项(${CLAUDE_SKILL_DIR}/../../../tokens/theming.json),且只输出差异;按 $type 格式化。
  4. 生成所需目标:CSS :root 变量、Tailwind v4 @theme、类型化 JS/TS、iOS Asset Catalog 和 Color.DS/Spacing、Android colors.xml/Compose 主题。
  5. 接入 CI:当 ${CLAUDE_SKILL_DIR}/../../../tokens/*.json 变更时,运行 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py,重新生成,并在已提交的产物过期时失败;使用 ${CLAUDE_SKILL_DIR}/../../../scripts/contrast.py 检查颜色。

验证(完成标准)

  • python3 ${CLAUDE_SKILL_DIR}/../../../scripts/validate_tokens.py 运行通过(没有未解析的别名)。
  • 重新生成后,与已提交的产物相比没有差异。
  • 深色、品牌和密度输出只包含差异,而非完整副本。

评论

支持 Markdown