SwiftUI 专家技能 (SwiftUI Expert Skill)

为任何支持 Agent Skills 开放格式 的 AI 编码工具提供专家级指导，涵盖 SwiftUI 状态管理、视图组合、性能优化以及 iOS 26+ Liquid Glass 的适配。

本项目将实用的 SwiftUI 最佳实践提炼为简洁、可执行的参考指南，适用于 AI Agent 和代码审查工作流。

适用人群

• 正在采用现代 SwiftUI API 并希望获得快速、准确默认配置的团队
• 需要审查或重构 SwiftUI 视图和数据流的开发者
• 任何在 SwiftUI 中构建高性能列表、滚动、Sheet 和导航功能的开发者

查看我的其他技能：

• Swift Concurrency Expert
• Core Data Expert
• Swift Testing Expert

如何使用此技能

选项 A：使用 skills.sh

通过单条命令安装此技能：

npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill

更多信息，请访问 skills.sh 平台页面。

随后即可在 AI Agent 中调用，例如：

Use the swiftui expert skill and review the current SwiftUI code for state-management and performance improvements

选项 B：Claude Code 插件

个人使用

要在 Claude Code 中安装此技能以供个人使用：

1. 添加市场：

/plugin marketplace add AvdLee/SwiftUI-Agent-Skill

2. 安装技能：

/plugin install swiftui-expert@swiftui-expert-skill

选项 C：Cursor 插件（即将推出）

此仓库已为 Cursor 插件提交进行了打包，但目前市场列表尚未上线。

一旦获批，你就可以直接从 Cursor Marketplace 安装它。

项目配置

若要自动为仓库中的所有贡献者提供此技能，请配置仓库的 .claude/settings.json：

{
  "enabledPlugins": {
    "swiftui-expert@swiftui-expert-skill": true
  },
  "extraKnownMarketplaces": {
    "swiftui-expert-skill": {
      "source": {
        "source": "github",
        "repo": "AvdLee/SwiftUI-Agent-Skill"
      }
    }
  }
}

当团队成员打开项目时，Claude Code 将提示他们安装此技能。

选项 D：Codex / 兼容 OpenAI 的工具

本仓库包含一个 agents/openai.yaml 清单文件。将 swiftui-expert-skill/ 文件夹复制或通过软链接放入你的 Codex 技能目录：

cp -R swiftui-expert-skill/ "$CODEX_HOME/skills/swiftui-expert-skill"

有关技能保存位置的详细信息，请参见 Codex 技能文档。

选项 E：手动安装

1. 克隆 此仓库。
2. 按照你所用工具的官方技能安装文档，安装或创建软链接 到 swiftui-expert-skill/ 文件夹（见下方链接）。
3. 像往常一样使用你的 AI 工具，并要求它针对 SwiftUI 任务使用 “swiftui-expert” 技能。

技能保存位置

请遵循你所用工具的官方文档，以下是一些常用工具的链接：

• Codex: 技能保存位置
• Claude: 使用 Skills
• Cursor: 插件文档 或 启用 Skills

如何验证：

你的 Agent 应该参考 swiftui-expert-skill/SKILL.md 中的工作流/核对表，并跳转到对应的参考文件以执行任务。

包含内容

本技能覆盖了 SwiftUI 开发的各个方面——从状态管理和视图组合，到 Swift Charts、macOS 多窗口场景、动画以及 iOS 26+ Liquid Glass——且不会增加 Agent 任务的上下文负担。参考文件按需加载，确保你的 Agent 仅针对当前主题获取深入指导。

• 状态管理 -- 属性包装器（Property Wrappers）的选择、@Observable、数据流模式
• 视图组合 -- 提取模式、容器视图、标识（Identity）稳定性
• 性能优化 -- 热点路径优化、懒加载、@Observable 颗粒度
• 列表与 ForEach -- 稳定标识、Table、内联过滤的陷阱
• 导航与 Sheets -- NavigationStack 等