SwiftUI Expert Skill（SwiftUI 专家技能）

# SwiftUI Expert Skill：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能本身、它的参考文件或 Python 工具。这些要从 Antoine van der Lee 的仓库安装：https://github.com/AvdLee/SwiftUI-Agent-Skill

许可证：MIT，Copyright (c) 2026 Antoine van der Lee。全文见 https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/LICENSE

SwiftUI Expert Skill 是 Antoine van der Lee 和 Omar Elsayed 的社区项目，并非 Apple 制作或背书。

这些说明的来源：README（https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/README.md），INSTALLATION.md（https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/INSTALLATION.md），技能的 SKILL.md（https://github.com/AvdLee/SwiftUI-Agent-Skill/blob/main/skills/swiftui-expert-skill/SKILL.md），它的 references/trace-recording.md 和 trace-analysis.md，两个脚本 record_trace.py 和 analyze_trace.py 以及它们的解析模块，还有插件文件 plugin.json 和 .claude-plugin/marketplace.json。Claude Code 从哪里加载技能和插件，出自 Claude Code 自己的文档，用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

一个技能，swiftui-expert-skill，用来在 iOS 和 macOS 上编写、审查和重构 SwiftUI 代码。它的 SKILL.md 是一份简短的工作流程文件，里面有一个 Topic Router（主题路由表），把智能体指向 33 个参考文件，智能体只打开任务需要的那些。README 说这个技能不带立场：它关注正确性和性能，不管架构或代码风格。

参考文件涵盖：

- 状态管理、environment 和 `@Entry`、视图组合、修饰符和标识
- 性能、列表和 ForEach、滚动、焦点
- 布局、安全区域、iPhone Duo 和折叠屏、弹出页、导航、工具栏
- 动画，分三个文件：基础、过渡、进阶
- Swift Charts 和图表无障碍、无障碍、图片、文字和本地化、预览
- Liquid Glass、文档类应用、WebKit、带样式的文本编辑
- macOS 场景、视图和窗口样式
- 一份从已弃用到新写法的 API 清单（latest-apis.md），以及一份关于软弃用 API 的说明
- Instruments 跟踪记录的录制和分析（setup/instruments-traces.md）

SKILL.md 还有一份由硬性规则组成的正确性检查清单，比如 `@State` 属性要是 private，`ForEach` 要用稳定的标识。

## 工具包里的文件

- setup/skills-cli.md：README 的 Option A，也就是 skills CLI，以及插件格式之前的旧安装要注意的地方
- setup/claude-code.md：README 的 Option C，两条插件命令，以及把技能提供给团队的项目设置
- setup/codex.md：README 的 Option B，ChatGPT 和 Codex 共用的 OpenAI 插件目录
- setup/cursor.md：README 的 Option D，Cursor 插件
- setup/other-agents.md：INSTALLATION.md 里 pi、Gemini CLI 和 Autohand Code 的安装方式，以及手动安装
- setup/instruments-traces.md：用技能的两个 Python 脚本录制和读取 Instruments 跟踪记录

## 先准备好这些

- 支持 Agent Skills 格式的 AI 编程工具。README 说，凡是支持的工具都能用这个技能。
- Node，只有 skills CLI 路线要用，因为它通过 npx 运行。
- Xcode，只有跟踪记录这部分要用。脚本调用 Xcode 自带的 xctrace，所以这部分要在 Mac 上运行。
- Python 3，两个跟踪脚本要用。README 说它们只用 Python 3 标准库。
- 不需要账号、注册或 API 密钥：README 没有为这个技能列出任何一项。

## 装到哪里

- skills CLI：README 没有说这个命令行工具把文件放在哪里。它的安装命令点名了技能 swiftui-expert-skill。
- Claude Code 插件：Claude Code 关于托管插件市场的页面（https://code.claude.com/docs/en/plugins/host-marketplace）说，它会把插件复制到自己的缓存里，插件里的技能名前带插件名（setup/claude-code.md）。
- 手动安装：从仓库的克隆里取出 skills/swiftui-expert-skill/ 文件夹，放到你的工具读取技能的地方（setup/other-agents.md）。INSTALLATION.md 说，这个文件夹是从仓库根目录移过去的。

## 你的数据

这个技能是给智能体的文本，外加两个用于跟踪记录的 Python 脚本，它们会加载一个小的解析包（scripts/instruments_parser/）。Mindket 读过两个脚本和解析包里的各个模块，没有一个导入网络库。技能的跟踪说明要求智能体优先附加到或启动你正在排查的那一个应用，因为全系统录制会记下其他应用的活动和元数据。遇到全系统录制时，说明要求智能体先讲清范围，取得你的明确同意，再加上 `--allow-system-wide-recording`。你交给智能体的代码或跟踪记录，会像其他工作一样发给你的 AI 服务商。

## 更新和卸载

README 说，`npx skills@latest update` 会迁移 Agent Plugins 格式之前的安装。除此之外，它没有给出更新或卸载的步骤。Claude Code 的插件页面说，/plugin 里的 Installed 标签页列出每个插件，并提供更新或卸载的操作（setup/claude-code.md）。

README.md  5 KB
setup/claude-code.md  3 KB
setup/codex.md  1 KB
setup/cursor.md  1 KB
setup/instruments-traces.md  4 KB
setup/other-agents.md  3 KB
setup/skills-cli.md  2 KB