用途
本技能是 design-method/SKILL.md 的路由第 1 步。在任何设计任务开始前、在选择或审计单个颜色/字体/间距值之前、在编写 design-system.md 之前,都应先阅读本文件。该读取也是让 harness 越过阶段 0 的条件。若设计问题纯粹关于某个令牌(颜色、字体搭配、间距值),本文件连同其参考索引即可回答;否则应回到 design-method 的路由继续。
主要能力
- 令牌策略单一来源:只提供策略,不提供数值;数值存放于 references/*.md 并从那里读取,不在本文件中重新推导。
- 颜色策略:新令牌仅用 OKLCH(oklch(L% C H)),新建时不用 hex/HSL/RGB;中性色向品牌色相着色,chroma 0.005–0.015,不用纯灰、不用 #000/#fff;先定强调色策略再选色相,包括克制型(着色中性色 + 一个强调色 ≤10% 表面,产品默认)、投入型(一个饱和色承载 30–60% 表面,品牌默认)、完整调色板(3–4 个命名角色)/ 浸染型(表面即颜色,用于品牌活动、产品数据可视化);明度趋近 0 或 100 时降低 chroma。对比度下限为 WCAG AA 正文 4.5:1、大文本与 UI 组件 3:1,可行时 AAA 7:1。
- 排版比例:级差 ≥1.25(默认大三度 1.25,编辑类 1.333),最多 6–8 个字号,每视图 ≤3 种对比变化;正文行高 1.5×,展示文字 1.05–1.15×,正文行宽 65–75ch。禁止/标记字体以 references/forbidden-fonts.md 为准。
- 间距:8pt 网格(4/8/12/16/24/32/48/64/96);按 register 选择密度配置(企业密集/标准/编辑),产品默认密集、品牌默认编辑。
- 触控目标:iOS 44×44pt、Android 48×48dp,WCAG 2.5.8 最低 24×24 CSS px。
- 定义 design-system.md 的标准输出格式,包括标题、设计参考 URL、颜色与字体令牌。
使用方式
作为 design-method/SKILL.md 的路由第 1 步,每个任务读取一次,并在分派到任何 move 或目标技能之前读取。读取后回到 design-method 进行 Register 解析、Gate 0 与 move 分派。设计问题若纯属令牌层面,本文件及参考索引即可回答。
design-system.md 输出与 4 项硬性要求
生成的文件需满足以下存在性检查(缺一即会在下游静默失败,写入时不报错):
- 逐字包含标题 ## Design Reference。
- 至少一个 https?:// URL,为在 design-web/references/design-inspiration.md 第 2 步实际浏览到的真实灵感来源,不是占位符。
- 至少一个 chroma > 0 的 oklch(...) 令牌;仅 chroma-0 中性色不满足,强调色或任一投入型策略令牌必须携带 chroma。
- 文件任何位置不得出现 Inter、Roboto、Arial、Open Sans(harness 检查的子集;完整 6 字体硬禁层级还含 Lato/Poppins,虽不被 harness 检查但仍由本技能执行)。
写入前应显式核对上述清单,不可依赖任务中先前“大致用了 OKLCH”。
适用场景
适用于新建设计系统、审计现有颜色/字体/间距令牌、为 web/webapp/iOS/Android 设计任务建立令牌基础,以及生成受 harness 校验的 design-system.md。继承代码库中已有的旧令牌不在重写范围内,除非被要求。
限制
本文件不存放具体数值,数值须从 references/ 读取;具体功能、收费、价格、平台、效果等资料未在本文件中提供,暂未提供。