用途:用于在 StyleSeed 设计系统中查看、添加或修改设计令牌(design tokens),覆盖颜色、排版、间距、圆角和阴影等类型。
主要能力:支持 list(以格式化表格显示当前令牌)、add(新增令牌)、update(修改已有令牌)。令牌按类型维护:颜色位于 tokens/colors.json 与 css/theme.css 的 :root 及 @theme inline;排版位于 tokens/typography.json 与 css/fonts.css、css/base.css;间距位于 tokens/spacing.json,对应 Tailwind 工具类;圆角位于 tokens/radii.json 与 css/theme.css 的 @theme inline;阴影位于 tokens/shadows.json 与 css/theme.css 的 :root。
使用方式:按动作与令牌类型调用,参数为 $ARGUMENTS(动作 $0、令牌类型 $1)。新增令牌需同时写入 tokens/*.json 源文件与 css/theme.css 的 :root;如需 Tailwind 工具类,加入 @theme inline 块;如有暗色模式变体,加入 .dark 块。修改令牌时更新 JSON 与 theme.css,并检查可能受影响的组件直接用法。规则要求 JSON 与 CSS 始终同步,使用语义化命名(如 --success 而非 --green-500),颜色支持明暗两种模式,新令牌必须同时落在 JSON 源与 CSS 实现中。
适用场景:针对 StyleSeed 设计系统的令牌维护与审查。
限制:不适用于在组件中应用令牌(用 /ss-component 或 /ss-pattern)、查找现有代码中的令牌违规(用 /ss-lint)、尚未定义的品牌级色彩/字体选择(先定义 skin 再添加令牌),以及非 CSS 令牌体系(Figma、原生 iOS/Android)——仅支持 Tailwind v4 / CSS 变量。使用前需确认任务与上游来源及本地项目上下文匹配,并自行验证命令、生成代码、依赖、凭据与外部服务行为。以上资料未提供价格、平台支持与效果信息。