夜雨聆风学习资料网

ARTICLE · 1212874

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

用 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技能

ARCHIVE 01 / PROBLEM MAP

它解决什么问题

SwiftUI Pro 关心的是一个页面怎样写、数据怎样传,以及不同用户能否顺利操作。检查范围也很完整,包括页面跳转、动画、多语言、性能和 Swift 并发等内容。

比如,一个只有加号图标的按钮,它会检查有没有说明用途的文字。一个可以删除、排序的列表,它会查看每个条目是否有稳定的标识,让选中状态和动画能正确对应到条目。

检查已有项目时,它还会把过时的 API 和推荐替代写法一起列出来。修改功能时,则先完成当前任务,把其他值得更新的地方另列为建议。这样可以先完成手头的功能,再安排其他代码整理。

ARCHIVE 02 / CAPABILITY RECORDS

把任务交给它之后,会发生什么

安装好 Skill,打开自己的 SwiftUI 项目后,可以从一条请求开始。

用 SwiftUI Pro 检查这个阅读清单 App 的 SwiftUI 代码。

这次检查的输入是项目代码和已有配置。Skill 会让编程助手按下面这些方面查看,最后整理成具体的修改建议。

同一次检查会查看页面、数据和使用细节,再把建议整理到对应的代码位置。

PHASE 01页面与使用体验
01

页面写法

理清代码和跳转关系

应用新写法前,它会先核对项目支持的系统版本和 Xcode 工具链。然后查看 API、页面结构和数据处理方式,例如建议用foregroundStyle()设置前景样式,用NavigationStack组织页面跳转。

页面代码过长时,它会建议拆成独立的子视图,把按钮操作和业务逻辑放到合适的位置。共享数据、输入框绑定、列表条目标识,以及详情页和弹窗怎样接收数据,也在检查范围内。

动画、拖动排序和滑动操作都有各自的规则。它会把这些交互和页面代码一起检查。页面与动画规则

02

布局与无障碍

让页面更好看,也更好操作

设计规则会检查字体、颜色和间距是否统一,空列表和搜索无结果时是否用了合适的系统组件。布局规则则会考虑窗口缩小、iPad 多任务、文字变长和字号放大后的情况。

无障碍部分很细。它会检查 VoiceOver,也就是系统的屏幕朗读功能,是否能说清按钮用途;还会查看页面有没有尊重用户的字号和“减少动态效果”设置。

仓库里的按钮示例很直观。一个加号按钮,会被建议补上“添加用户”这样的文字标签。界面仍可以只显示图标,但朗读时能说清它会做什么。用颜色区分状态的地方,也会检查是否需要图标或其他标记。无障碍规则

界面可以只显示图标,文字标签让屏幕朗读功能说清按钮用途。

03

多语言

把界面文字和显示习惯一起照顾到

它会检查新文字是否放进了项目已有的翻译资源,资源包是否选对,以及容易产生歧义的词有没有给翻译者留下说明。

日期、数字和文字搜索也有对应的 Swift 规则。比如,日期显示要考虑用户的地区习惯,页面使用的日历和时区要与当前环境一致。这些细节会和普通界面文字一起检查。多语言规则

PHASE 02运行与结果交付
04

性能

查看页面刷新时做了哪些工作

性能检查很具体。页面每次刷新时是否又做了一遍排序和筛选,长列表是否一次创建了太多内容,一个条目变化时是否带着其他条目一起更新,都是它关注的地方。

它也会查看异步任务的安排。遇到已经确认的频繁刷新问题,仓库还有单独的深入性能资料,用来分析页面读取了哪些数据、更新能否缩小到更少的部分。性能规则

05

Swift 与项目整理

把界面之外的代码也检查一遍

Swift 规则会查看异步代码是否采用合适的async/await写法,共享数据的修改有没有得到保护,以及用户操作失败时是否有清楚的提示。

它还会查看核心逻辑有没有测试,需要解释的代码有没有注释,敏感信息是否放在合适的位置。项目已经配置 SwiftLint 时,也会关注相关检查结果。

如果已经配置 Xcode MCP,它会优先使用对应工具。预览工具可以提供 SwiftUI 页面图像,文档搜索工具可以查 Apple 的用法说明,方便把代码和页面放在一起看。项目检查规则

06

审查结果

指出位置,并给出修改示例

它规定的报告格式很实用。问题按文件整理,每一项写清文件和行号、涉及的规则,再附上简短的修改前后代码。

最后还会按影响程度排列建议。拿到报告后,可以找到对应位置,看懂为什么要改,再决定先处理哪一项。核心 Skill 文档

ARCHIVE 03

最常见的使用方式

已有项目做一次检查,是很自然的起点。把当前代码交给它,它会按照规则查看,再用文件位置和代码示例说明建议。

写新页面或修改功能时,也可以使用它。按钮、表单、跳转和数据处理都有现成规则,编程助手能在写代码时参考这些要求。

它也支持局部检查。一个页面需要适应大字号,或者某个列表滚动不顺,就可以围绕这个目标查看相关代码。这时只加载对应的参考资料。

ARCHIVE 04

它为什么能工作

SwiftUI Pro 的主体是一份核心 Skill 文档,配上按主题分开的 Markdown 规则。核心文档安排检查顺序和报告格式,各份参考文档说明具体写法。

检查按钮朗读时,会查看无障碍资料;排查列表更新时,会查看数据和性能资料。每份文档各管一类问题,局部检查就从相关规则开始。

这些规则公开放在仓库里,项目按 MIT 许可证开源。你可以直接阅读,也可以结合自己的项目调整。了解它会检查什么,打开文档就能看到。

ARCHIVE 05

安装与前置条件

通过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,也支持自然语言调用。安装说明

ARCHIVE 06

适合谁

如果你已经在用 AI 编程助手开发 SwiftUI App,它可以参与日常的页面编写和代码检查。已有项目要整理代码、补充多语言,或者团队想采用一致的页面写法,也有对应资料可用。

可以从正在写的一个页面开始。看它给出的按钮标签、布局和数据处理建议,再对照修改示例逐项处理,比较容易了解这套规则能帮到哪里。


关注AI技能图鉴,持续介绍AI技能

AI SKILL ATLAS / ARCHIVE 073 / SWIFTUI PRO

相关学习资料