Apple UI Skills 是一套面向 AI 智能体的界面设计规范，旨在帮助构建受 Apple 美学启发的界面。它以「有倾向性的约束」为核心，为智能体提供明确的规则和默认值，而不是开放式建议。
一、用途与适用时机 当需要构建浅色模式界面、创建 Apple 风格的设计系统，或实现使用 Inter 字体与 4px 网格的 UI 时，可参考本规范。
二、颜色与语义化 Token 规范要求主表面使用浅色背景，页面背景（surface-base）必须使用 #FFFFFF。主操作与聚焦状态（accent）必须使用 #155BD0。色板应限制在 10 种不同颜色以内，文字对比度必须至少达到 4.5:1 以满足可访问性。语义化 Token 包括：surface-raised 为 #0858DC，用于卡片、模态框等抬升表面；text-primary 为 #808080，用于标题与正文；text-secondary 为 #6D89B5；text-tertiary 为 #90C5F1；border-default 为 #B5C7D8；accent 为 #155BD0。
三、字体排版 必须将 Inter 作为主要字体族，并建议使用单一字体族以保持一致性。主标题必须使用 51px / 700，正文必须使用 27px / 500。建议减少字重数量（当前检测到 4 种），标题使用 text-balance、正文使用 text-pretty，数值数据使用 tabular-nums，且除非明确要求不得修改字距。文档还列出了具体文本样式，如 heading-1 为 Inter 51px 700 #2D2B30、text-43px 为 Inter 43px 700 #272729、body 为 Inter 27px 500 #454547、caption 为 Inter 11px 300 #707070、label 为 Inter 10px 400 #7E7E7E 等，以及字号清单：9px、10px、11px、12px、14px、15px、16px、26px、27px、43px、51px。
四、间距、边框与布局 间距必须遵循 4px 网格，建议从 2px、4px、13px、34px 的比例中取值，元素间默认间距为 4px，且不得使用任意间距值。边框圆角必须从 21px 比例中取值，默认圆角为 21px，药丸形元素建议使用 21px 以上圆角，边框宽度统一为 1px，不得使用任意圆角值。布局必须面向 1920px 基准视口宽度设计，元素宽度建议保持 46px、50px、36px、47px、32px 等一致取值，不得使用 h-screen，而应使用 h-dvh；固定元素必须尊重 safe-area-inset，方形元素建议使用 size-* 而非 w-* + h-*。文档还记录了检测到的布局模式，如头部高度 43px、主内容区宽度 1920px、高度 694px 与 695px。
五、组件与交互状态 按钮方面列出 Ghost 变体：背景透明、文字 #6D89B5、无边框。聚焦状态必须使用 2px 轮廓与强调色 #155BD0，并设置 2px 轮廓偏移，不得移除聚焦指示器。悬停状态下，主按钮背景提亮 10%，次按钮与列表项使用 #0858DC 背景。禁用状态必须使用 opacity: 0.5 并设置 cursor: not-allowed。交互上，破坏性或不可逆操作必须使用 AlertDialog，加载状态建议使用结构性骨架屏，错误必须显示在操作发生处附近，不得阻止输入框或文本域的粘贴，仅图标按钮必须添加 aria-label。
六、动画与性能 除非明确要求，否则不得添加动画。动画只能作用于合成属性（transform、opacity），不得动画布局属性（width、height、top、left、margin、padding）。入场动画建议使用 ease-out，交互反馈不得超过 200ms，并应尊重 prefers-reduced-motion。性能方面，不得对大面积 blur() 或 backdrop-filter 表面做动画，不得在非活动动画之外使用 will-change，不得将可用渲染逻辑表达的内容放入 useEffect。