用于 AI 编程助手的 SwiftUI Agent Skill

这是一个专为 AI 编程助手设计的 Agent Skill，旨在帮助它们编写更智能、更简洁、更现代的 SwiftUI 代码。该 Skill 涵盖了 API 使用规范、设计模式、性能优化及无障碍访问（Accessibility）指导，重点针对导航、布局、动画、状态管理、VoiceOver 以及已废弃 API 等 LLM 常见的错误场景。

更多相关资源：

• SwiftData Pro
• Swift Concurrency Pro
• Swift Testing Pro

更多适用于 Swift 和 Apple 平台开发的 Agent Skills，请访问 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 仅安装到当前项目，还是使其在所有项目中全局可用。

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：

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

为什么需要为 SwiftUI 使用 Agent Skill？

此 Skill 基于我数千小时的学习、实验以及构建真实 SwiftUI 项目的经验积累。其中包含的规则直接针对 LLM 在编写 SwiftUI 时常犯的错误。LLM 有时会编写出 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 消耗。请专注于边缘案例、隐藏的坑点、软废弃 API 等内容。
• 所有工作必须在 MIT 许可下授权，以便造福更多人。

请确保你遵守行为准则。

许可协议

SwiftUI Pro 最初由 Paul Hudson 创建，他在 Hacking with Swift 提供免费的 Swift 教程。本项目采用 MIT 许可证开源，允许商业使用、修改、分发及私人使用。

 

A Hacking with Swift Project