适用于 AI 编程助手的 SwiftUI Agent Skill

这是一个帮助 AI 编程助手编写更智能、更简洁、更现代 SwiftUI 代码的 Agent Skill，涵盖了 API 使用、设计、性能和可访问性等方面的指导。内容涵盖导航、布局、动画、状态管理、VoiceOver、已弃用 API 等，专门针对 LLM 实际开发中容易犯的错误。

此外还有：

• SwiftData Pro
• Swift Concurrency Pro
• Swift Testing Pro

更多适用于 Swift 和 Apple 平台开发的 Agent Skill，请访问 Swift 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 时，你可以在安装过程中精确选择想要使用的 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：

Use the SwiftUI Pro skill to look for performance problems in this project.

为什么要为 SwiftUI 使用 Agent Skill？

该 Skill 建立在数千小时的学习、实验和构建真实 SwiftUI 项目的经验之上。其中包含的规则直接针对 LLM 在编写 SwiftUI 时常犯的错误。它们有时会导致按钮对 VoiceOver 不可见，经常使用已弃用的 API，且往往会编写出导致意外性能问题的代码。

你可以通过我的文章阅读更多关于我创建该 Skill 的初衷：SwiftUI Agent Skill - Write better code with Claude, Codex, and other AI tools。

贡献

欢迎所有贡献，无论是添加新的检查项、改进现有检查项，还是编辑此 README —— 欢迎每一个人！

• 保持 Markdown 简洁。使用 Skill（尤其是 SKILL.md）会消耗 token，因此请尊重用户的 token 配额。
• 不要重复 LLM 已经掌握的知识，因为这会浪费 token 且没有收益。请专注于边缘案例、隐蔽陷阱、软弃用等内容。
• 所有工作必须采用 MIT 许可证，以便让更多人受益。

请确保你遵守 行为准则 (Code of Conduct)。

许可证

SwiftUI Pro 由 Paul Hudson 原创，他也是 Hacking with Swift 免费 Swift 教程 的作者。本项目采用 MIT 许可证 发布，允许商业使用、修改、分发及私人使用。

 

A Hacking with Swift Project