1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | SwiftUI-Agent-Skill |
| 作者/维护者 | Antoine van der Lee（AvdLee，SwiftLee 博客作者） |
| 来源链接 | https://github.com/AvdLee/SwiftUI-Agent-Skill |
| 许可证 | MIT |
| GitHub Stars | 3,293（数据来自 GitHub API） |
| Forks | 150（数据来自 GitHub API） |
| 最新版本 | 4.0.0（2026-06-16 发布） |
| 安装方式 | npx skills add 一条命令 / Claude Code 插件市场 / Codex 目录复制 / pi 包管理器 |
第三方技能市场 skills.sh 显示该技能安装量 2.69 万次、GitHub Stars 3.3k，与仓库自身数据一致（数据来自 skills.sh 页面）。
2. 功能介绍与亮点
SwiftUI-Agent-Skill 是一个专注 SwiftUI 开发的智能体技能，将状态管理、视图组合、性能优化、无障碍适配等实践整理成 20 余篇按需加载的参考文档，避免一次性塞满 Agent 上下文。核心亮点：
- 状态管理与视图组合：
@Observable数据流选择、属性包装器取舍、视图拆分与身份稳定性 - 性能诊断工具链：内置基于 Apple 官方
xctrace的 Python 分析脚本，可录制并解析 Instruments Trace，定位卡顿与主线程阻塞 - iOS 26+ Liquid Glass 适配：玻璃材质效果的正确用法与降级方案
- API 时效性：
latest-apis.md持续跟踪从 iOS 15 到 iOS 26+ 的废弃 API 迁移路径 - 10 位贡献者、262 次提交，社区提交的 Pull Request 会被及时合并（如一处 API 引用错误从报告到修复仅隔一天）
3. 适用场景
固定分类：工程效率与代码质量
适用于用 Claude Code、Codex 等编码 Agent 开发或维护 iOS / macOS 应用的团队与个人：编写新 SwiftUI 视图时获取现代 API 默认写法，审查或重构既有代码时揪出废弃用法与性能热点,排查界面卡顿时录制并解读 Instruments Trace。
4. 跨 Agent 兼容性
- Claude Code：原生支持——提供 Claude Code 插件市场清单（
.claude-plugin/marketplace.json），一条/plugin marketplace add命令即可安装 - Codex：原生支持——仓库自带
agents/openai.yaml清单，README 给出复制到$CODEX_HOME/skills的具体步骤 - OpenClaw：未验证——已抓取材料未提及
- Hermes Agent：未验证——已抓取材料未提及
5. 推荐理由
SwiftUI 生态的 Agent 技能不少，但多数止步于文字规范；这一份把“规范”与“可执行诊断工具”结合在一起——不仅告诉 Agent 该怎么写，还能调用 Xcode 自带的 Instruments 命令行工具，把卡顿问题从“猜”变成“测”。文档结构清晰、按需加载，作者是 SwiftUI 社区知名的技术作者，出错时公开认错并快速修复，是一份可以放心长期依赖的专家技能。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,293 星，skills.sh 平台安装量 2.69 万次，issue 区有 10 余条来自不同用户的真实技术讨论与功能建议 |
| 可用性 | 9 | 提供一条命令安装、Claude Code 插件市场、Codex 目录复制、pi 包管理器等多种安装路径；20 余篇参考文档配示例；近一个月内有新版本发布；完全免费 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 本地运行 Python 脚本封装 Apple 官方 xctrace，仅用于录制/解析 Instruments Trace，用途在文档中说明清晰 |
| ② 运行时联网外发 | 未发现向外部服务器发送数据的逻辑，性能分析全程在本机完成 |
| ③ API Key / 凭据 | 不需要任何密钥或账号 |
| ④ 可疑指令 | SKILL.md 与脚本内容未发现提示词注入或异常指令 |
| ⑤ 作者/组织信誉 | 作者为 SwiftUI 社区知名技术作者，另有 4 个同系列 Swift 技能仓库；此前一次内容引用他人素材的失误已在 issue 中公开承认并彻底修复 |
| ⑥ License | MIT，权利义务清晰 |
| ⑦ 维护活跃度 | 最近一次发布为 2026-06-16，持续接受社区 Pull Request |
第三方平台 skills.sh 标注该技能已通过 Socket、Snyk、Gen Agent Trust Hub 三项独立安全扫描。
7. 跟同类 Skills 相比的优势
同一作者围绕 Swift/Xcode 工具链发布了一系列专精技能，各自聚焦不同环节，可按需搭配：
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| SwiftUI-Agent-Skill（本技能） | SwiftUI 状态管理、性能、Liquid Glass、Instruments 诊断 | 覆盖面最广，唯一内置可执行性能诊断工具链 |
| Swift-Concurrency-Agent-Skill | Swift 并发安全与 Swift 6 迁移 | 聚焦并发模型本身，不涉及 UI 层 |
| Xcode-Build-Optimization-Agent-Skill | 增量/全量构建耗时优化 | 面向构建速度而非运行时代码质量 |
| Swift-Testing-Agent-Skill | Swift Testing 框架测试编写与 XCTest 迁移 | 聚焦测试代码本身 |
| Core-Data-Agent-Skill | Core Data 数据建模与持久化 | 聚焦数据层，不覆盖视图与性能 |
对比之下，本技能是唯一把“写对 SwiftUI”和“诊断为什么卡”两件事放进同一个技能包的产品，适合作为 SwiftUI 项目的默认起点，其余几个技能可在遇到对应专项问题时再补充安装。
8. 用户评价
GitHub issue 区可见多位具名用户的技术互动。用户 Upper9527 在讨论技能生态治理方向的 issue 中评价：“Your repo provides high-quality focused SwiftUI guidance as an agent skill”（来源：GitHub issue #58）。用户 kumamaki 曾报告参考文档中一处引用了不存在的 API（Glass.prominent），维护者在同一天回应并合并了社区提交的修复补丁（来源：GitHub issue #64 及 PR #65），显示出真实用户在生产环境中使用并快速获得响应的过程。
9. 其他补充
仓库内含一个仅供维护者内部使用的辅助技能（update-swiftui-apis，依赖专用 MCP 抓取 Apple 官方文档以更新参考资料），并非面向终端用户的独立产品，不影响本技能的安装与使用方式。
10. 安装使用方式
- skills.sh（推荐）：
npx skills add https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill - Claude Code 插件：
/plugin marketplace add AvdLee/SwiftUI-Agent-Skill /plugin install swiftui-expert@swiftui-expert-skill - Codex：
cp -R swiftui-expert-skill/ "$CODEX_HOME/skills/swiftui-expert-skill" - pi 包管理器：
pi install https://github.com/AvdLee/SwiftUI-Agent-Skill - 手动安装：克隆仓库后将
swiftui-expert-skill/目录按所用工具的技能安装规范放置
安装后无需重启，Agent 在处理 SwiftUI 相关任务时会自动引用；如需录制 Instruments Trace，需在 macOS 本机（非模拟器）且安装了 Xcode。
11. 注意事项
- 仅覆盖 SwiftUI / iOS / macOS 开发场景，不是通用前端或跨平台 UI 技能
- Instruments Trace 录制依赖真机或 Mac 宿主机；iOS 模拟器上 SwiftUI 相关数据通道为空，需切换到 Time Profiler 模板
- 历史上出现过参考文档引用了尚不存在的 API 的情况，社区反馈后修复较快，但使用前仍建议留意所依赖 API 的实际可用版本