twostraws/SwiftData-Agent-Skill

它解决了什么问题

AI 编码助手（如 Claude Code、Codex、Cursor 和 Gemini）在编写 SwiftData 代码时经常出错，尤其是在处理它们未受过训练的新功能或经常弄错的旧 API 时。此技能将专家级的 SwiftData 知识打包成一组规则，直接针对这些常见错误，使助手能够生成更正确、更高效的代码，而不会浪费 token 在它们已经掌握的基础知识上。

工作原理

SwiftData Pro 是一种“代理技能”——一组规则和指导，你可以将其安装到 AI 编码助手中。安装后，你可以通过类似 Claude Code 中的 /swiftdata-pro 或 Codex 中的 $swiftdata-pro 这样的命令触发它，也可以用自然语言提问。你还可以给出具体指令，例如“检查我的代码是否使用了最新的 API”或“检查我的 SwiftData 模型中哪些地方应该添加索引”。该技能涵盖 @Model、@Query、谓词、索引、迁移、关系和 iCloud 同步等主题，重点关注 LLM 容易出错的边缘情况和陷阱。

适用人群

使用 AI 编码助手编写 Swift 或 Apple 平台代码的开发者，尤其是那些在 iOS 26+ 和 Swift 6.2+ 上使用 SwiftData 的开发者。对于希望安装预构建的、专家策划的技能而不是自己编写规则的人来说，它也很有用。

亮点

• 由 Paul Hudson 创建，他是 SwiftData 书籍的作者，因此规则来自深入、最新的专业知识。
• 针对 LLM 实际犯的具体错误，而非泛泛的建议——避免在基础知识上浪费 token。
• 支持多种助手：Claude Code、Codex、Gemini、Cursor 等。
• 可通过插件市场（Claude Code）或 npx（大多数其他工具）安装，你可以选择按项目或全局安装。
• 在 MIT 许可下开源，欢迎贡献以添加或改进检查。