技能介绍

它解决什么问题

写设计系统文档最容易出现两种结果：要么通篇是“要简洁、要高级”这类无法执行的形容词，开发拿到后仍然各自发挥；要么规则堆得很全，却漏掉状态、漏掉键盘路径，上线后发现对比度或焦点样式不达标。

premium 把这份工作变成可执行的交付物：它面向 Apple 风格的现代界面，输出一套实现就绪的设计系统指南，而不是视觉灵感拼贴。文档受众明确是工程师和设计师，语言要求简洁、自信、可落地。

技能如何工作

核心不是画界面，而是担任设计系统指南作者。运行时按六步流程产出规范：

先用一句话重述设计意图，再提出规则；
先定义设计令牌和基础约束，再写组件级指导；
为组件写解剖结构、变体、状态和交互行为；
给出无障碍验收标准和内容写作预期；
补充反模式，以及旧 UI 迁移说明；
用可放进 code review 的 QA 清单收尾。

基础层已经给出可引用的默认值：排版刻度 12/14/16/18/24/30/36，字体为 Inter 与 JetBrains Mono，字重从 100 到 900；色彩使用语义令牌，如 primary=#3B82F6、success=#16A34A、surface=#FFFFFF、text=#111827；间距为 4/8/12/16/24/32。规则要求优先使用语义令牌而不是裸值，保持视觉层级，并把 default、hover、focus-visible、active、disabled、loading、error 等状态写清楚。

无障碍按 WCAG 2.2 AA 处理，交互采用键盘优先，焦点状态必须可见。每条无障碍声明都要能在实现中测试；遇到审美与可访问性冲突时，先保留可访问性。约束语使用规范语言：不可协商项用 must，推荐项用 should；每条 Do 规则至少配一个具体 Don't 示例。

适用边界

它输出的是规范文本和判断依据，不会替你自动安装依赖、修改系统权限、创建持久任务或下载内容。命令和代码默认只作为参考，只有在目标范围清楚且用户明确要求时才可运行。涉及发送、发布、删除、付款、部署等外部写入时，必须先展示目标和影响，再取得明确确认。凭据只用于用户指定的对应官方服务，不回显、不记录、不转发。

因此，适合把它用在新建设计系统的基线评审、旧界面迁移前的规则统一，以及 PR 中的设计一致性检查；不适合把它当作无障碍审计工具、性能优化器或完整设计交付流程。