ARTICLE · 1212874
用 AI 写 SwiftUI App,SwiftUI Pro 帮你检查页面里的细节

AI技能图鉴 / AI SKILL ATLAS
ARCHIVE 073 · SWIFTUI PRO
FIELD GUIDE/OPEN SOURCE/AI SKILL
用 AI 写 SwiftUI App,SwiftUI Pro 帮你检查页面里的细节

分类:SwiftUI 开发 / 代码审查
来源:https://github.com/twostraws/SwiftUI-Agent-Skill
CATALOG / 目录
PHASE01
页面与使用体验
·页面写法
·布局与无障碍
·多语言
PHASE02
运行与结果交付
·性能
·Swift 与项目整理
·审查结果
写一个 SwiftUI App,页面里的按钮、列表和弹窗需要一起配合。按钮要能被正确朗读,字号放大后内容还要看得清,切换页面时选中的条目也要跟着走。
SwiftUI Pro 把这些细节整理成一套给 AI 编程助手使用的规则。写新页面、修改功能、检查已有代码,都可以用到它。
它的作者是 Paul Hudson,也就是 Hacking with Swift 的作者。项目采用 Agent Skills 格式,可以用于 Claude Code、Codex、Gemini、Cursor 等兼容助手。项目 README
关注AI技能图鉴,持续介绍AI技能
它解决什么问题
SwiftUI Pro 关心的是一个页面怎样写、数据怎样传,以及不同用户能否顺利操作。检查范围也很完整,包括页面跳转、动画、多语言、性能和 Swift 并发等内容。
比如,一个只有加号图标的按钮,它会检查有没有说明用途的文字。一个可以删除、排序的列表,它会查看每个条目是否有稳定的标识,让选中状态和动画能正确对应到条目。
检查已有项目时,它还会把过时的 API 和推荐替代写法一起列出来。修改功能时,则先完成当前任务,把其他值得更新的地方另列为建议。这样可以先完成手头的功能,再安排其他代码整理。
把任务交给它之后,会发生什么
安装好 Skill,打开自己的 SwiftUI 项目后,可以从一条请求开始。
用 SwiftUI Pro 检查这个阅读清单 App 的 SwiftUI 代码。
这次检查的输入是项目代码和已有配置。Skill 会让编程助手按下面这些方面查看,最后整理成具体的修改建议。

同一次检查会查看页面、数据和使用细节,再把建议整理到对应的代码位置。
页面写法
理清代码和跳转关系
应用新写法前,它会先核对项目支持的系统版本和 Xcode 工具链。然后查看 API、页面结构和数据处理方式,例如建议用foregroundStyle()设置前景样式,用NavigationStack组织页面跳转。
页面代码过长时,它会建议拆成独立的子视图,把按钮操作和业务逻辑放到合适的位置。共享数据、输入框绑定、列表条目标识,以及详情页和弹窗怎样接收数据,也在检查范围内。
动画、拖动排序和滑动操作都有各自的规则。它会把这些交互和页面代码一起检查。页面与动画规则
布局与无障碍
让页面更好看,也更好操作
设计规则会检查字体、颜色和间距是否统一,空列表和搜索无结果时是否用了合适的系统组件。布局规则则会考虑窗口缩小、iPad 多任务、文字变长和字号放大后的情况。
无障碍部分很细。它会检查 VoiceOver,也就是系统的屏幕朗读功能,是否能说清按钮用途;还会查看页面有没有尊重用户的字号和“减少动态效果”设置。
仓库里的按钮示例很直观。一个加号按钮,会被建议补上“添加用户”这样的文字标签。界面仍可以只显示图标,但朗读时能说清它会做什么。用颜色区分状态的地方,也会检查是否需要图标或其他标记。无障碍规则

界面可以只显示图标,文字标签让屏幕朗读功能说清按钮用途。
多语言
把界面文字和显示习惯一起照顾到
它会检查新文字是否放进了项目已有的翻译资源,资源包是否选对,以及容易产生歧义的词有没有给翻译者留下说明。
日期、数字和文字搜索也有对应的 Swift 规则。比如,日期显示要考虑用户的地区习惯,页面使用的日历和时区要与当前环境一致。这些细节会和普通界面文字一起检查。多语言规则
性能
查看页面刷新时做了哪些工作
性能检查很具体。页面每次刷新时是否又做了一遍排序和筛选,长列表是否一次创建了太多内容,一个条目变化时是否带着其他条目一起更新,都是它关注的地方。
它也会查看异步任务的安排。遇到已经确认的频繁刷新问题,仓库还有单独的深入性能资料,用来分析页面读取了哪些数据、更新能否缩小到更少的部分。性能规则
Swift 与项目整理
把界面之外的代码也检查一遍
Swift 规则会查看异步代码是否采用合适的async/await写法,共享数据的修改有没有得到保护,以及用户操作失败时是否有清楚的提示。
它还会查看核心逻辑有没有测试,需要解释的代码有没有注释,敏感信息是否放在合适的位置。项目已经配置 SwiftLint 时,也会关注相关检查结果。
如果已经配置 Xcode MCP,它会优先使用对应工具。预览工具可以提供 SwiftUI 页面图像,文档搜索工具可以查 Apple 的用法说明,方便把代码和页面放在一起看。项目检查规则
审查结果
指出位置,并给出修改示例
它规定的报告格式很实用。问题按文件整理,每一项写清文件和行号、涉及的规则,再附上简短的修改前后代码。
最后还会按影响程度排列建议。拿到报告后,可以找到对应位置,看懂为什么要改,再决定先处理哪一项。核心 Skill 文档
最常见的使用方式
已有项目做一次检查,是很自然的起点。把当前代码交给它,它会按照规则查看,再用文件位置和代码示例说明建议。
写新页面或修改功能时,也可以使用它。按钮、表单、跳转和数据处理都有现成规则,编程助手能在写代码时参考这些要求。
它也支持局部检查。一个页面需要适应大字号,或者某个列表滚动不顺,就可以围绕这个目标查看相关代码。这时只加载对应的参考资料。
它为什么能工作
SwiftUI Pro 的主体是一份核心 Skill 文档,配上按主题分开的 Markdown 规则。核心文档安排检查顺序和报告格式,各份参考文档说明具体写法。
检查按钮朗读时,会查看无障碍资料;排查列表更新时,会查看数据和性能资料。每份文档各管一类问题,局部检查就从相关规则开始。
这些规则公开放在仓库里,项目按 MIT 许可证开源。你可以直接阅读,也可以结合自己的项目调整。了解它会检查什么,打开文档就能看到。
安装与前置条件
通过npx安装前,电脑需要装好 Node.js。官方提供了下面这条通用安装命令。
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro安装时可以选择要使用的编程助手,也可以选择只用于当前项目,或用于所有项目。Claude Code 还支持通过插件市场安装。
安装后,Claude Code 中的显式入口是/swiftui-pro,Codex 中是$swiftui-pro,也支持自然语言调用。安装说明
适合谁
如果你已经在用 AI 编程助手开发 SwiftUI App,它可以参与日常的页面编写和代码检查。已有项目要整理代码、补充多语言,或者团队想采用一致的页面写法,也有对应资料可用。
可以从正在写的一个页面开始。看它给出的按钮标签、布局和数据处理建议,再对照修改示例逐项处理,比较容易了解这套规则能帮到哪里。
关注AI技能图鉴,持续介绍AI技能















































































