纸张质感设计规范

解决什么问题

设计规范在落地时常遇到三类问题：tokens 写成裸值导致主题切换失效、组件只画默认态导致 hover/focus/disabled 各做一套、可访问性只写「需支持键盘」却无法验收。这个技能把规范写成可执行约束：每条规则要么绑定 token、阈值或示例，要么给出反例。

技能如何工作

核心能力

• 基于 token 的一致性约束：颜色、字号、间距全部语义化，如 primary=#111111、surface=#FFFFFF，避免直接写死十六进制。
• 状态明确的组件规则：组件必须定义 default、hover、focus-visible、active、disabled、loading、error 七态，并写明键盘、指针、触摸交互。
• 可测试的可访问性验收：对齐 WCAG 2.2 AA，验收标准写成「焦点环可见」「对比度≥4.5:1」这类可代码审查的断言。
• 反模式与迁移路径：每条 Do 规则配 Don't 示例，新样式引入时提供旧组件迁移指引。

关键步骤

1. 用一句话重述设计意图，避免规则漂移。
2. 先定 typography、color、spacing 等 foundation tokens，再写组件级规则。
3. 组件部分覆盖解剖结构、变体、状态、响应式与边界情况（长标签、空状态、溢出）。
4. 输出可访问性验收标准、内容语气示例、禁止实现、QA 清单。

适用边界

• 不自动安装依赖、修改系统权限或创建持久化任务。
• 涉及发送、发布、删除、付款、部署等外部写入时，需先展示影响并获用户确认。
• 凭据只用于用户指定的官方服务，不回显、不记录、不转发。
• 命令和代码默认仅供参考，仅在用户明确要求且目标清楚时才执行。