mcpField
U
ui-tokens

ui-tokens

github.com/sickn33设计与 UI48.7k67 次安装今天更新
代码仓库

关于 ui-tokens

这项 Skill 用于查看和修改现有 StyleSeed 项目中的设计令牌,涵盖 JSON 令牌源及其 Tailwind v4/CSS 实现,并要求保持两者同步。

主要功能

  1. 01以表格列出令牌
  2. 02在 JSON 和 CSS 中添加令牌
  3. 03修改令牌值
  4. 04管理颜色、字体、间距、圆角和阴影
  5. 05保持 JSON 与 CSS 同步

适用场景

  1. 01检查 StyleSeed 当前令牌值
  2. 02添加令牌及其 CSS 实现
  3. 03更新令牌并检查组件用法

安装

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill ui-tokens

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

详细介绍

设计令牌管理器

适用场景

当你需要查看、添加或修改 StyleSeed 设计系统中的设计令牌时,请使用此技能。

不适用场景

  • 在组件中应用令牌 → 使用 /ss-component 或 /ss-pattern
  • 查找现有代码中的令牌违规 → 使用 /ss-lint
  • 对尚不存在的品牌级颜色/字体进行选择——先定义皮肤,再添加令牌
  • 用于非 CSS 令牌系统(Figma、原生 iOS/Android)——仅支持 Tailwind v4 / CSS 变量

操作:$0 | 令牌类型:$1 参数:$ARGUMENTS

令牌文件位置

类型JSON 源文件CSS 实现
颜色tokens/colors.jsoncss/theme.css 中的 :root + @theme inline
排版tokens/typography.jsoncss/fonts.css + css/base.css
间距tokens/spacing.jsonTailwind 实用类(无需自定义 CSS)
圆角tokens/radii.jsoncss/theme.css 中的 @theme inline
阴影tokens/shadows.jsoncss/theme.css 中的 :root

说明

list — 显示当前令牌

读取请求的令牌文件,并以格式化表格显示。

add — 添加新令牌
  1. 将令牌添加到 JSON 源文件(tokens/*.json)
  2. 在 css/theme.css 的 :root 下添加 CSS 自定义属性
  3. 如果需要 Tailwind 实用类,则添加到 @theme inline 块中
  4. 如果有深色模式变体,则添加到 .dark 块中
update — 修改现有令牌
  1. 更新 JSON 源文件中的值
  2. 更新 theme.css 中的 CSS 自定义属性
  3. 检查所有组件中可能需要更新的直接用法

规则

  • 始终保持 JSON 和 CSS 同步
  • 使用语义名称,而非描述性名称(使用 --success,而非 --green-500)
  • 颜色应同时支持浅色和深色模式
  • 新令牌必须同时添加到 JSON 源文件和 CSS 实现中

示例

用户请求:

使用 @ui-tokens 审查此界面,找出影响最大的问题,并提出可直接用于实现的改进方案。

限制

  • 仅当任务与其上游来源和本地项目上下文明确匹配时,才使用此技能。
  • 应用更改前,先验证命令、生成的代码、依赖项、凭据和外部服务行为。
  • 不要将示例视为环境专属测试、安全审查或用户批准破坏性或高成本操作的替代品。

执行边界

本指南面向现有的 StyleSeed 项目。此单文件入口未包含列出的项目路径、组件、令牌和 /ss-* 命令。编辑前,请确认实际项目根目录并验证这些前置条件;如果资源不存在,请如实说明,不要凭空编造。使用宿主环境支持的调用方式和项目现有约定。布局数值是设计系统的选择,不代表通用的可用性保证。请在实际界面中测试键盘操作、响应式溢出和减少动态效果的设置。

评论

支持 Markdown