SwiftUI 专家技能 (SwiftUI Expert Skill)

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

本仓库将实用的 SwiftUI 最佳实践提炼为可操作、简洁的参考资料，供 AI Agent 和代码审查工作流使用。

适用人群

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

查看我的其他技能：

• 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 插件文档获取安装说明。

项目配置

要自动为仓库中的所有贡献者提供此技能，请配置仓库的 .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/ 文件夹复制或通过符号链接（symlink）到你的 Codex 技能目录：

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

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

选项 E：使用 pi 包管理器

通过 pi 安装：

pi install https://github.com/AvdLee/SwiftUI-Agent-Skill

安装后，该技能将在 pi 会话中自动可用。

选项 F：手动安装

1. 克隆本仓库。
2. 根据你所使用工具的官方技能安装文档，安装或创建符号链接到 swiftui-expert-skill/ 文件夹（参考下方的链接）。
3. 正常使用你的 AI 工具，并要求它在处理 SwiftUI 任务时使用 “swiftui-expert” 技能。

技能保存路径

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

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

如何验证：

你的 Agent 应当参考 swiftui-expert-skill/SKILL.md 中的工作流/清单，并根据你的任务跳转到相关的参考文件。

包含内容

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

• 状态管理 -- 属性包装器选择、@Observable、数据流模式
• 视图组合 -- 提取模式、容器视图、标识（Identity）稳定性
• 性能 -- 热路径（hot-path）优化、布局效率与列表优化建议