SwiftUI Agent Skill —— 面向 AI 编程助手的 SwiftUI 专业技能
一个帮助 AI 编程助手写出更智能、更简洁、更现代的 SwiftUI 代码的 Agent 技能,涵盖 API 使用、设计、性能和无障碍等方面的指导。内容覆盖导航、布局、动画、状态管理、VoiceOver、废弃 API 等,专门针对 LLM 实际容易犯的错误而编写。
同系列还有:
更多面向 Swift 和 Apple 平台开发的 Agent 技能,请访问 Swift Agent Skills。
本技能基于我现有的 AGENTS.md 文件构建——只需几分钟,就能把多年的知识和实战经验装进你常用的编程助手里。它采用 Agent Skills 格式,可在 Claude Code、Codex、Gemini、Cursor 等工具中顺畅使用。
安装 SwiftUI Pro
你可以通过 npx 将本技能安装到 Claude Code、Codex、Gemini、Cursor 等工具中:
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro
如果报错 npx: command not found,说明你还没装 Node。先通过 Homebrew 安装:
brew install node
如果这一步也失败,通常是因为你需要先 安装 Homebrew。
使用 npx 安装时,你可以精确选择要启用该技能的 Agent;也可以选择是只在当前项目安装,还是对所有项目可用。
Claude Code 用户可以在插件市场中添加 SwiftUI Agent Skill,然后直接在 Claude 中安装插件:
/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill
或者,你也可以克隆整个仓库,按自己喜欢的方式安装。
如果你使用 Xcode,可在 YouTube 观看视频 如何在 Xcode 中安装和使用 Agent Skills(英文)了解安装步骤。
使用 SwiftUI Pro
本技能名为 SwiftUI Pro,可通过多种方式触发。例如,在 Claude Code 中输入:
/swiftui-pro
在 Codex 中输入:
$swiftui-pro
两种方式都可以附加具体指令,只做部分检查。比如在 Claude 中 /swiftui-pro 检查是否有废弃的 API,或在 Codex 中 $swiftui-pro 重点检查无障碍支持。
你也可以用自然语言触发:
用 SwiftUI Pro 技能检查这个项目里的性能问题。
为什么要为 SwiftUI 做一个 Agent 技能?
本技能基于数千小时的学习、实验和真实 SwiftUI 项目开发经验沉淀而成。其中收录的规则,直接瞄准 LLM 写 SwiftUI 时常犯的错误:它们有时会写出 VoiceOver 读不到的按钮,频繁使用已废弃的 API,还经常写出暗藏性能坑的代码。
关于我为什么创建这个技能,可以阅读我的文章:SwiftUI Agent Skill —— 用 Claude、Codex 和其他 AI 工具写出更好的代码(英文)。
许可证
SwiftUI Pro 由 Paul Hudson 原创——他也是 Hacking with Swift 免费 Swift 教程 的作者。本项目采用 MIT 许可证,允许商业使用、修改、分发和私人使用。

有疑问、有建议、想分享自己的实践?欢迎加入我们的微信群交流


