为编码助手补充 SwiftUI 开发规范

这是一项 Agent skill，帮助 AI 编程助手写出更合理、更简洁、更现代的 SwiftUI 代码，提供 API 使用、设计、性能和无障碍方面的指导。它涵盖导航、布局、动画、状态管理、VoiceOver、已弃用 API 等内容，专门针对 LLM 实际会犯的错误。

Swift Concurrency Pro

你可以在 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 安装时，你可以明确选择要在哪些 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》，了解完整操作过程。

这项 skill 名为 SwiftUI Pro，可以通过多种方式触发。例如，在 Claude Code 中，你可以这样使用：

在 Codex 中，你可以这样使用：

这两种方式都允许你提供具体指令，只检查某一部分。例如，在 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 识别，经常使用已弃用 API，还常常写出会导致意外性能问题的代码。

想进一步了解我为什么创建这项 skill，可以阅读我的文章：《SwiftUI Agent Skill：用 Claude、Codex 和其他 AI 工具写出更好的代码》。

我欢迎各种形式的贡献，无论是添加新的检查项、改进现有检查项，还是编辑这份 README，所有人都可以参与！

请保持 Markdown 简洁。使用 skills 会消耗 token，尤其是 SKILL.md，因此请尊重用户的 token 预算。

不要重复 LLM 已经知道的内容，那只会白白消耗 token。请重点关注边界情况、容易出乎意料的行为、尚未正式标记为弃用的用法，以及类似问题。

所有贡献都必须采用 MIT license，让尽可能多的人受益。

请确保遵守行为准则。

SwiftUI Pro 最初由 Paul Hudson 创建，他在 Hacking with Swift 提供免费的 Swift 教程。这项 skill 采用 MIT License，允许商业使用、修改、分发和私人使用。

Hacking with Swift 出品的项目