Codex 的 SwiftUI UI Patterns skill
swiftui-ui-patterns skill 给 Codex 一套构建和重构 SwiftUI 界面的默认模式:状态由谁持有、导航和 sheet 怎么接、视图怎么拆成小块。它附带大约 30 份简短的参考,每份讲一个组件或主题。它包含在 OpenAI 的 Build iOS Apps 插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | swiftui-ui-patterns |
| 来自 | OpenAI 的 Build iOS Apps 插件 |
| 安装 | codex plugin add build-ios-apps@openai-curated,或在 Codex 里运行 /plugins |
| Codex 何时使用 | 构建或重构 SwiftUI 界面时:导航、状态、布局、控件,或者一个界面的整体组织方式 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
在已有项目里,Codex 会先在你的仓库里找一个相近的 SwiftUI 视图,沿用它的写法。在新项目里,它从一份 App 结构参考开始,搭好 TabView、NavigationStack 和 sheet,并用 route 和 sheet 枚举来管理,之后加界面时往枚举里扩展即可。
它的通用规则:
- 状态: 用刚好够用的最小工具,从
@State、@Binding到@Observable模型,共享服务用@Environment。普通状态够用时就不加 view model;iOS 16 及更早版本降级用ObservableObject。 - 组合: 拆成小而专一的子视图,不写一个巨大的视图。
- 异步任务: 用
.task,并明确处理加载中和出错状态。 - Sheet: 优先用
.sheet(item:)而不是.sheet(isPresented:),sheet 自己负责关闭。 - 系统版本: 在部署目标允许的范围内用最新的 API,并注明最低系统版本。
它还列出了要避免的反模式,比如用好几个布尔值控制互斥的 sheet、在 body 里发网络请求、用 AnyView 来绕过问题。做新视图时,Codex 每完成一步就构建一次,并为主要状态加上预览。参考文件涵盖列表、表单、网格、搜索、分栏视图、菜单栏、macOS 设置、触感反馈、主题、性能等等。
什么时候用
日常的 SwiftUI 工作都可以用它,不管是新界面、Tab 结构,还是清理一个庞大的视图。它让 Codex 写出的代码符合现代 SwiftUI 的写法,也和你 App 里已有的模式保持一致。
试一试
搭一个带 Tab 的 SwiftUI App 框架
使用 swiftui-ui-patterns skill。为一个阅读清单 App 搭好整体框架:三个 Tab(Library、Search、Settings),每个 Tab 有自己的 NavigationStack,再用枚举驱动的 sheet 来添加书籍。为空状态和已加载状态加上预览。
Claude Code 里能用吗?
能。这个 skill 只是普通的指令和 Markdown 参考文件,没有 Codex 专属的工具,所以可以把文件夹从 GitHub 复制到 ~/.claude/skills。