跳到正文
Codex DesignBETA

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。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。