SuperAPI AI 工具集

ios-design-system

前端与建站

查看项目

更新于 10-16 03:46

技能介绍

该技能用于在 SwiftUI iOS 26 / Swift 6.2 应用中建立并治理设计系统本身,属于基础设施层,而非教你如何使用颜色、字体等设计原语。共含 8 大类 50 条规则,按影响程度排序。

用途与适用场景:为新 iOS 应用搭建设计系统;构建令牌架构(颜色、排版、间距、尺寸);创建可复用组件样式(ButtonStyle、LabelStyle、自定义 DLS 协议);组织资源目录;从零散样式迁移到受治理的令牌系统;通过自动化防止样式漂移;为白标或多品牌应用构建主题基础设施;在 PR 审查中检查未受治理的颜色、硬编码值与阴影令牌。

主要能力(按优先级):1) 令牌架构(关键):Raw→Semantic→Component 三层令牌、使用无 case 枚举作令牌命名空间、每个设计域一个令牌文件、扩展 ShapeStyle、以资源目录为颜色来源、避免过度抽象。2) 颜色系统工程(关键):按角色分组组织颜色资源、每个自定义颜色定义两种外观、自定义颜色控制在 20 个语义令牌内、视图代码禁止十六进制颜色、优先系统色、品牌色设为 app tint、用构建脚本审计未治理颜色。3) 组件样式库(关键):为复杂 DLS 组件定义自定义样式协议、每个视图加 @Equatable、无障碍内建于样式协议、用样式协议替代包裹视图、提供静态成员语法、样式响应环境值、容器用视图样式用修饰符、每种组件一个样式目录文件、优先配置结构体、创建预览目录。4) 排版比例(高):定义包装系统样式的比例枚举、优先系统文本样式、集中注册自定义字体、每屏限制 3-4 种排版、全应用只用一种字体设计。5) 间距与尺寸(高):无 case 枚举定义间距令牌、按组件类型定义圆角令牌、禁止魔法数字、用 EdgeInsets 常量、定义常用尺寸令牌。6) 一致性与治理(高):统一命名约定、将设计系统隔离为本地 SPM 包、单一事实来源、用 SwiftLint 强制令牌使用、专用目录隔离令牌、增量迁移、禁止功能模块定义本地令牌。7) 资源管理(中高):颜色/图片/图标分开资源目录、优先 SF Symbols、用 PDF/SVG 矢量、压缩与按需资源、统一命名。8) 主题与品牌(中):用 EnvironmentKey 传递主题、非必要不建主题系统、以 .tint() 表达品牌、仅用 ColorScheme 处理明暗、品牌与系统机制分层。

必要用法:须与 swift-ui-architect 技能配合使用,遵循同一套强制约束——功能模块只依赖 Domain + DesignSystem,可变 UI 状态用 @Observable(禁用 ObservableObject / @Published),每个视图加 @Equatable 宏,以样式协议作为组件样式的主要 API,资源目录为颜色值唯一来源,设计系统模块作为本地 SPM 包。架构假定模块化 MVVM-C:功能模块仅导入 Domain + DesignSystem;App target 负责 DependencyContainer、协调器与 Route Shell;Domain 为纯 Swift;Data 负责 SwiftData/网络/同步等 IO;ViewModel 直接调用仓库协议。

限制:资料未提供具体安装命令、版本号、价格与平台要求;所有规则细节与代码示例需查阅其单独参考文件(如 references/_sections.md 与 assets/templates/_template.md),本技能不替代 ios-design、ios-ui-refactor、ios-hig 等兄弟技能的职责。