SwiftUI 设计技能
让 SwiftUI 界面看起来是精心设计而非 AI 生成的:六条铁律、设计方向咨询、品牌资产协议与五维评审一体化。
该 skill 为纯文本设计指导,无代码执行、无权限要求、无遥测,数据流基本透明。扣分项:品牌资产协议第3步要求 agent 自动联网下载品牌资产文件(PNG/SVG/字体),未说明下载来源校验、恶意文件风险与用户确认机制;未验证的发布者身份使来源归因仅依赖自述作者字段。
SKILL.md 内部自洽:前置要求、六条铁律、工作流、评审清单逻辑连贯,且声明了对 references/ 与 templates/ 的依赖。但本次静态评审未能验证这些参考文件的实际内容与代码可编译性;未提供测试、失败反馈路径或异常输入处理说明,因此不超过静态上限。
适用与不适用边界明确(When to Use / When NOT to Use,含指向 swiftui-expert-skill 的分流),触发语义清晰(如'UI 看起来很泛')。扣分项:正文为英文,仅 README 有中文版;品牌协议依赖访问境外品牌官网,但核心设计功能本身可离线运行,影响有限。
具备 MIT License、版本号(1.0.0)、发布说明与中英双语 README,文件结构与行数披露清晰,渐进式披露(SKILL.md → references/ → templates/)设计良好。扣分项:无明确的维护责任声明与更新路径,无 FAQ 与已知限制章节,发布者身份未经验证。
能力矩阵、典型耗时、五维评审和可交付物描述具体,边际价值明确(避免 AI slop 的可操作规则集在纯提示方案中少见)。但静态评审无法验证其输出(可编译 SwiftUI 代码、评审雷达图)是否可直接使用;'3-30分钟交付'等营销性时间承诺缺乏证据支撑。
仅引用了 Apple 官方文档两个链接,且引用的 references/ 文件内容未在本次证据中提供,无法交叉核对其与 SKILL.md 声明的一致性;无测试、无第三方执行证据、无真实产出示例,关键主张基本停留在作者自述层面。
- 品牌资产协议会引导 agent 自动联网下载品牌资产文件,建议用户在此步骤显式确认并自行校验文件来源。
- 引用的 references/ 与 templates/ 文件未在本次评审范围内,其质量与 SKILL.md 声明的一致性未经核实。
- 代码片段(如 Color(hex:) 扩展)需 Swift 扩展文件支持,实际可编译性未经验证。
- 发布者未经验证,长期维护与更新无明确承诺。
- 正文为英文,中文用户使用时依赖 agent 的跨语言理解能力。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 SwiftUI 前端的视觉设计技能,目标是产出"不像 AI 生成"的 iOS/macOS 界面。它内置六条反 AI 套路铁律、五个设计流派的方向咨询流程、五步品牌资产协议和一份五维设计评审清单。要求模糊时它会推荐 2-3 个差异化设计方向,产出设计令牌、字体层级和布局代码。仓库声明支持 Claude Code、Cursor、Codex、OpenCode 等各类 AI 编码代理。
读取用户的产品背景与品牌资料;按五步协议收集并验证品牌色、字体与资产,生成 brand-spec.md;从五个设计流派(信息型、编辑型、表达型、功能型、温暖极简)中推荐 3 个方向并给出视觉锚点;定义设计令牌(颜色、字体、8pt 间距网格、圆角);产出可编译的 SwiftUI 布局代码(引用 references/layout-patterns.md 中的 9 种模式);在交付前按五维评审(理念一致性、视觉层级、细节执行、功能性、原创性,每项 ≥7/10)打分并列出修复清单。
- 独立 iOS 开发者从零设计新界面,希望避开紫蓝渐变、emoji 图标等 AI 套路外观
- 接到"界面看起来太通用"反馈的开发者,需要逐项排查并修正 AI 套路模式
- 为特定品牌做 App 的开发者,需要把品牌色板与字体规范落地成 brand-spec.md 和设计令牌
- 需求模糊、不知选什么视觉风格的团队,需要 3 个带理由的设计方向做决策
- 需要快速产出可编译 SwiftUI 原型(含动画、9 种常见布局)的产品原型场景
- 交付前对 UI 质量做结构化评审,获得雷达图评分与 Keep/Fix/Quick Wins 清单
这个 Skill 有哪些优点和局限?
- 规则非常具体可执行:明确列出禁用的 AI 套路视觉模式及对应替代方案
- 五维评审提供量化门槛(每维 ≥7/10),便于交付前把关
- 代理无关,声明支持 Claude Code、Cursor、Codex、OpenCode 等
- MIT 许可,纯 Markdown 结构(SKILL.md + references + templates),易于审计和自定义
- 与 swiftui-expert-skill 明确分工,覆盖"设计什么"与"怎么写对"两端
- 无自动化测试套件,设计质量依赖模型的实际遵循程度
- 品牌资产协议中的"搜索并下载官方品牌文件"步骤需联网且依赖代理的网络能力,本技能本体未强制
- 仅覆盖视觉设计层:不修编译错误、不做性能优化、不单独处理无障碍合规
- 五维评审与雷达图评分为主观启发式打分,非客观度量
- 要求 Xcode 16+ 与 iOS 18+/macOS 15+ SDK,旧项目可能部分模式不可用
如何安装这个 Skill?
README 提供的安装命令:npx skills add wholiver/swiftui-design-skill -g -y。也可手动克隆 https://github.com/Wholiver/swiftui-design-skill 后将包含 SKILL.md 的文件夹放入你的代理的 skills 目录(具体目录名未在源中说明,依各平台文档)。前置条件:Xcode 16+ 与 iOS 18+/macOS 15+ SDK。
如何使用这个 Skill?
在设计新 SwiftUI 视图、评审 UI 质量、选视觉风格或觉得界面"太像 AI 生成"时触发。示例提示:"帮我给这个 iOS 记账 App 设计一个温暖极简风格的界面,使用我的品牌色 #E85D3A"。技能会先询问上下文与品牌资产,再给出设计方向、设计令牌与可编译代码,最后跑五维评审。注意:它不处理 SwiftUI 编译错误或性能优化,那些属于 swiftui-expert-skill 的范围。
这个 Skill 与同类方案有什么区别?
仓库明确将其与同一作者的 swiftui-expert-skill 区分:本技能回答"界面长什么样"(视觉设计、方向、品牌感、评审),swiftui-expert-skill 回答"代码对不对"(代码评审、Instruments 分析、API 现代化)。两者互补:先用 Design 定方向,再用 Expert 保证代码质量。