SwiftUI-Agent-Skill
把多年 SwiftUI 实战经验打包成 Agent Skill，让 Claude Code、Codex、Gemini、Cursor 等 AI 编码助手写出更现代、更简洁的 SwiftUI 代码，覆盖导航、布局、动画、状态管理、VoiceOver 可达性与废弃 API 等主题。亮点在于规则直接针对 LLM 在真实项目里常犯的错误（按钮对 VoiceOver 不可见、滥用 soft-deprecated API、隐式性能问题），并采用通用的 Agent Skills 格式，npx 一条命令即可安装，也可作为 Claude Code 插件接入。MIT 许可，可商用与修改。
README
面向 AI 编程助手的 SwiftUI Agent Skill
一个 agent skill，帮助 AI 编程助手编写更智能、更简洁、更现代的 SwiftUI 代码，包括 API 用法、设计、性能和可访问性方面的指导。涵盖导航、布局、动画、状态管理、VoiceOver、deprecated API 等，针对 LLM 实际会犯的错误。
同样可用：
在 Swift Agent Skills 查找更多用于 Swift 和 Apple 平台开发的 agent skills。
该 skill 基于我现有的 AGENTS.md 文件构建，这意味着你可以在几分钟内将多年的知识和实践经验带入你选择的编程 agent。它使用 Agent Skills 格式，因此可以顺畅地与 Claude Code、Codex、Gemini、Cursor 等配合使用。
安装 SwiftUI Pro
你可以使用 npx 将此 skill 安装到 Claude Code、Codex、Gemini、Cursor 等中：
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro
如果你遇到错误 npx: command not found，意味着你当前没有安装 Node。你需要运行以下命令通过 Homebrew 安装 Node：
brew install node
如果那也失败了，通常意味着你需要先 安装 Homebrew。
使用 npx 时，你可以在安装过程中准确选择想要使用哪些 agents。你还可以选择该 skill 是只为一个项目安装，还是可供你所有项目使用。
Claude Code 用户可以添加 SwiftUI Agent Skill marketplace，然后直接通过 Claude 安装插件，如下所示：
/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill
或者，你可以克隆整个仓库，并按照你想要的方式安装它。
如果你使用 Xcode，请观看 YouTube 视频 如何在 Xcode 中安装和使用 Agent Skills 获取操作演示。
使用 SwiftUI Pro
该 skill 名为 SwiftUI Pro，可以通过多种方式触发。例如，在 Claude Code 中你可以使用：
/swiftui-pro
而在 Codex 中你可以使用：
$swiftui-pro
在两种情况下，如果你只想进行部分审查，都可以提供具体指令。例如，在 Claude 上使用 /swiftui-pro Check for deprecated API，或在 Codex 中使用 $swiftui-pro Focus on accessibility。
你也可以使用自然语言触发该 skill：
使用 SwiftUI Pro skill 在此项目中查找性能问题。
为什么要为 SwiftUI 使用 Agent Skill？
该 skill 建立在数千小时的学习、实验和构建真实世界 SwiftUI 项目的基础上。这里包含的规则直接针对 LLM 常犯的 SwiftUI 错误。它们有时会让按钮对 VoiceOver 不可见，经常使用 deprecated API，并且常常编写会导致意外性能问题的代码。
你可以在我的文章中阅读更多关于我为什么创建这个 skill 的内容：SwiftUI Agent Skill - 使用 Claude、Codex 和其他 AI 工具编写更好的代码。
贡献
我欢迎所有贡献，无论是添加新检查、改进现有检查，还是编辑此 README——欢迎所有人！
- 保持你的 Markdown 简洁。使用 skills 有 token 成本，尤其是 SKILL.md，因此请尊重用户的 token 预算。
- 不要重复 LLM 已经知道的内容，因为那样消耗 token 却毫无益处。专注于边缘情况、意外情况、soft deprecations 等。
- 所有工作必须基于 MIT 许可证，以便让最多的人受益。
请确保遵守 行为准则。
许可证
SwiftUI Pro 最初由 Paul Hudson 创建，他在 Hacking with Swift 上编写免费的 Swift 教程。它基于 MIT License 提供，允许商业使用、修改、分发和私人使用。
一个 Hacking with Swift 项目