技能:设计令牌
按照项目三级系统生成和维护 DTCG($type/$value)令牌。
步骤
- 读取
.claude/rules/tokens-and-color.md→ “令牌系统” + “颜色指南”以及.claude/rules/typography-and-spacing.md中的规则(4px 基础网格、Major Third 比例、OKLCH 调色板生成、深色模式在语义层处理)。 - 读取
tokens/中相关的现有文件,以匹配结构:colors.json、typography.json、spacing.json、shadows.json、borders.json、breakpoints.json、motion.json、gradients.json、opacity.json、blur.json、sizing.json、states.json、theming.json。 - 生成/扩展令牌:
- 基础层 = 原始值(从不直接使用)。语义层 = 用途别名。组件层 = 组件作用域。
- 新调色板:生成 11 个 OKLCH 色阶;验证 500 色阶在白色背景上的对比度 ≥ 4.5:1(文本),600 色阶的对比度 ≥ 3:1(UI),使用
a11y-audit技能 /scripts/contrast.py。 - 多品牌/密度 →
theming.json。
- 验证:运行
python3 scripts/validate_tokens.py(JSON 有效性 + 别名解析)。
输出
DTCG JSON。每个令牌保留 $description。引用,绝不硬编码。