AI写SwiftUI总出错?SwiftUI-Agent-Skill:一键让AI编程助手写出专业级代码
【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址: https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill
用 AI 写 SwiftUI 代码,是不是总遇到这些糟心事:API 早就过时了、按钮对 VoiceOver 隐身、列表一长就卡?SwiftUI-Agent-Skill 是一个专为 Claude Code、Codex、Gemini 等 AI 编程助手打造的 SwiftUI 智能审查技能(Agent Skill),一键安装后,AI 就能按专业 iOS 开发者的标准,帮你写出更现代、更简洁、性能更好的 SwiftUI 代码 🚀
为什么 AI 写的 SwiftUI 总"差一口气"?
大语言模型写 SwiftUI 时,常踩三类坑:
- 弃用 API:还在用
foregroundColor()、NavigationView这类旧写法 - 无障碍缺陷:图标按钮没有文字标签,VoiceOver 用户完全"看不见"
- 隐形性能问题:滥用
AnyView、在body里做昂贵计算,界面越用越卡
SwiftUI-Agent-Skill 由 Hacking with Swift 作者 Paul Hudson 基于数千小时实战经验打造,把"AI 真正会犯的错"逐条写成规则,直接喂给你的 AI 助手。
一键安装:3 种方式任选
方式一:npx 一键安装(推荐)
在终端执行下面命令,即可把 SwiftUI Pro 技能装进你的 AI 工具,安装时还能选择装到单个项目还是所有项目:
npx skills add https://gitcode.com/gh_mirrors/swi/SwiftUI-Agent-Skill --skill swiftui-pro如果提示npx: command not found,说明未安装 Node.js,macOS 用户可先通过 Homebrew 执行brew install node。
方式二:Claude Code 插件市场
在 Claude Code 中直接输入:
/plugin marketplace add twostraws/SwiftUI-Agent-Skill /plugin install swiftui-pro@swiftui-agent-skill方式三:克隆仓库手动配置
git clone https://gitcode.com/gh_mirrors/swi/SwiftUI-Agent-Skill克隆后按你的工具习惯自行引入即可,技能文件采用通用 Agent Skills 格式,Cursor、Gemini 等工具均可使用。
怎么用?3 种触发方式
技能装好后的名字叫SwiftUI Pro,触发方式非常灵活:
| 触发方式 | 示例 |
|---|---|
| Claude Code 斜杠命令 | /swiftui-pro |
| Codex 美元命令 | $swiftui-pro |
| 自然语言 | "使用 SwiftUI Pro 技能检查这个项目里的性能问题" |
还支持局部审查,只查你想查的维度:
/swiftui-pro Check for deprecated API—— 只查弃用 API$swiftui-pro Focus on accessibility—— 只关注无障碍
9 大审查维度:AI 的专业级"体检表"
安装后,AI 会按 swiftui-pro/SKILL.md 定义的流程,逐项对照 9 份参考规则文档完成审查,覆盖从 API 到代码卫生的全链路:
| 维度 | 参考文档 | 关注点 |
|---|---|---|
| 🔄 现代 API | api.md | 弃用 API 替换、iOS 26 新特性 |
| 🧩 视图与动画 | views.md | 视图组合、动画最佳实践 |
| 📊 数据流 | data.md | @Observable、属性包装器 |
| 🧭 导航 | navigation.md | NavigationStack、弹窗与 Sheet |
| 🎨 设计规范 | design.md | 遵循 Apple HIG 的一致性设计 |
| ♿ 无障碍 | accessibility.md | Dynamic Type、VoiceOver、Reduce Motion |
| ⚡ 性能 | performance.md | 避免AnyView、懒加载、task() |
| 🐍 Swift 语言 | swift.md | Swift 6.2 并发等现代写法 |
| 🧹 代码卫生 | hygiene.md | 文件组织、长期可维护性 |
以 api.md 为例,它明确要求 AI 使用foregroundStyle()替代foregroundColor()、用TabAPI 替代tabItem(),并优先使用containerRelativeFrame()替代GeometryReader——这些正是模型最容易写错的细节。
审查报告长什么样?
SwiftUI Pro 不会泛泛而谈,它会输出按文件组织、可执行的报告:
- 指出具体文件和行号
- 说明违反了哪条规则
- 给出前后对比的最小修复示例
- 最后附上按优先级排序的改进清单
比如它会告诉你:"第 24 行的图标按钮对 VoiceOver 不可见,请补上文字标签"——问题定位到行,改法一目了然。
项目结构一览
想深入了解技能实现,可以直接看这些文件:
- swiftui-pro/SKILL.md:技能入口,定义完整审查流程与输出格式
- swiftui-pro/agents/openai.yaml:Codex 等工具的界面配置(图标、品牌色、默认提示词)
- swiftui-pro/references/:9 份核心规则文档目录
- LICENSE:MIT 协议,可商用、可修改
- CODE_OF_CONDUCT.md:社区行为准则
总结:让 AI 从"能写"到"写得好"
SwiftUI-Agent-Skill 的核心价值只有一句话:把资深 iOS 开发者的经验,装进你的 AI 编程助手。无论你是刚上手 SwiftUI 的新手,还是用 AI 批量产码的开发者,花几分钟装好这个技能,AI 输出的代码就能少踩弃用 API、无障碍、性能这三类最常见的坑,离专业级又近了一步 ✨
同一作者还有 SwiftData Pro、Swift Concurrency Pro 等姊妹技能,可以按需搭配,打造完整的 Swift AI 开发工作流。
【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址: https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考