这个 SwiftUI Agent Skill,不替你写界面,专门帮你挑 SwiftUI 毛病

项目拆解

这个 SwiftUI Agent Skill,不替你写界面,专门帮你挑 SwiftUI 毛病

这是一篇面向技术读者的项目拆解稿:优先讲清它为什么值得看、底层机制是什么、最短能学到什么,而不是只给你一堆热闹功能点。

项目卡片

  • 项目名:SwiftUI Agent Skill(skill 名:swiftui-pro
  • GitHub:<https://github.com/twostraws/SwiftUI-Agent-Skill>
  • 涨星速度:7 天 2100+ Star(写稿时 GitHub 显示 2116 Star)
  • 一句话判断:它最有价值的地方,不是“让 AI 更会写 SwiftUI”,而是把 SwiftUI 常见旧写法和隐藏坑,整理成一套可以直接调用的 review 清单

如果你最近在用 Claude Code、Codex 或 Gemini 写 SwiftUI,应该很容易遇到一种代码:能跑,也像那么回事,但细看总差一点。

可能是 API 已经过时了,可能是状态流不顺,也可能是可访问性和性能根本没顾上。

这个仓库做的,就是专门抓这类问题。

为什么值得看?

因为它补的不是“生成能力”,而是现在 AI 写 SwiftUI 最容易缺的一层:专项审稿

它不负责把页面从零变出来,重点是你已经有一版代码之后,再用一套更像资深 SwiftUI reviewer 的规则去过一遍:

  • 有没有 deprecated API
  • data flow 是否还停在旧写法
  • 导航是不是现代 SwiftUI 的路子
  • VoiceOver、Dynamic Type、Reduce Motion 有没有漏
  • 某些“看着没事”的写法,会不会埋性能坑

这类问题最麻烦的地方就在于:第一眼通常看不出来,但后面特别容易返工。

它到底干什么?

一句话说,它就是一个 SwiftUI 专项 review skill

仓库里的检查范围很实在,核心就几块:

  • 现代 API / 弃用替代
  • 视图和 modifier 写法
  • 数据流与状态管理
  • NavigationStack 这类现代导航
  • 设计一致性和可访问性
  • 性能与代码 hygiene
SwiftUI Agent Skill 检查范围示意图

图:它的价值不是再喊一遍“请写现代 SwiftUI”,而是把检查点拆成能复用的具体规则。

和普通 Prompt 包相比,它更像一张能落地的审稿单。输出也不是空泛建议,而是尽量把问题落到文件、规则和修改方向上。

最短上手闭环

最省事的用法其实就 3 步。

1)先装 skill

bashcode
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro

2)在 agent 里调用

Claude Code:

textcode
/swiftui-pro

Codex:

textcode
$swiftui-pro

3)先生成,再复查

更稳的顺序不是“开着它直接写”,而是:

  1. 先让 AI 产出一版 SwiftUI 代码
  2. 再跑 swiftui-pro 做专项检查
  3. 先修高优先级问题
  4. 关键页面自己再过一遍
SwiftUI Agent Skill 使用闭环示意图

图:把它当复查器,比当万能生成器更对路。

如果你已经在用 AI 写 SwiftUI 页面,或者想拦住那些“能跑但写法不够现代”的代码进主分支,这个 skill 会很顺手。反过来,如果你现在卡的主要是产品设计、业务建模,或者想把它当成不用复审的最终裁判,那就别对它期待过高——它解决的是 SwiftUI 代码质量,不是整个开发流程。

我觉得最关键的坑点

1)把它当生成器用

它更像 reviewer,不是从零造界面的主力工具。

2)只跑一轮

很多问题是连锁的:第一轮修完 API,第二轮才会露出状态流和性能问题。重要页面最好复查两轮。

3)把建议照单全收

如果你的项目有兼容包袱、设计系统或明确约定,最终还是要让项目规则优先。

最后一个判断

这个仓库不属于那种“看完立刻热血沸腾”的项目,但很像会长期留在工具箱里的东西。

因为它做的事很朴素:在 AI 把 SwiftUI 写得差不多之后,尽量帮你早点抓出那些以后会返工的问题。

如果你本来就在用 AI 写 iOS 代码,这个 skill 挺值得装上跑一轮。

如果这篇对你有用,建议点个关注。我会持续把 GitHub 上值得用的 AI 工具拆成「最短上手闭环 + 坑点清单 + 可复用配置」,让你少走弯路。


关注微信公众号

想第一时间看到后续的工具拆解与实战更新,欢迎扫码关注公众号。