Xcode 27 内置可随处导出的 agent skills

收听本文
/
来自指南: Claude Code Comprehensive Guide

Xcode 27 把 Apple 编写的 agent skills 放进了工具链,如今又给了它们两条出路。第一条是 xcrun agent skills export,它把 skills 以 markdown 形式写入磁盘,这是 Apple 在 WWDC 上公布的途径。1 第二条在 2026 年 11 月初到了 Claude Code:Anthropic 官方的 Claude Code marketplace 列出了一个 xcode 插件,作者字段写的是“Apple Inc.”,来源则是一条由您自己 Mac 上的 Xcode 来应答的命令:xcrun agent plugin path --plugin-format claude。3 在 Xcode 27.2 上,这个插件目录里有 16 个 skills,外加 Xcode 的 MCP 服务器配置。导出工具跑完的构建版本有两个,它在每个上面都写出了 10 个 skills。它在 27.2 上的数量缺失,因为命令在那里卡住了。

更新于 2026 年 11 月 11 日。本文 6 月 10 日的版本讲的是那两个 SwiftUI skills 和 WWDC 会议中的导出命令,这些章节仍保留在下文,其中的实验室引文现已改为以 Apple 的文字记录为准。凡涉及插件目录、skill 数量和卡住问题的内容,都来自同一台 Mac 上的三个 Xcode 构建版本,测量于 11 月 10 日和 11 日,列在接近文末的“我测量了什么”一节。

姊妹篇 Apple 为 Claude Code 提供的 Xcode 插件:它会安装什么 专讲这个插件:人接受的是什么,安装之前如何读取目录,以及用 --plugin-dir 加载该目录时会话显示些什么。

要点速览

  • Xcode 27 为 Apple 的 skills 留了两个出口。xcrun agent skills export 为每个 skill 写出一个文件夹。xcrun agent plugin path --plugin-format <name> 则为 claude、codex 或 gemini 生成打包好的插件,并打印出存放位置。8
  • 在 Claude Code 中,该插件用 claude plugin install xcode@claude-plugins-official 安装。Claude Code 会显示 marketplace 想要运行的命令,并等人来接受。48
  • 在 Xcode 27.2 上,插件带有 16 个 skills:SwiftUI、App Intents、无障碍审查、String Catalog 翻译、向 Swift Testing 迁移、C 语言边界安全、安全相关的构建设置、设备交互、窗口大小可调,以及 xctrace。导出工具只在 27.1 候选版本和 27.2 beta 这两个构建版本上跑完,在那里它写出了 15 个中的 10 个,另外 5 个没有写出。它在 27.2 上的数量缺失。插件目录里的 skills/ 文件夹以普通文件夹的形式包含了完整的一套。8
  • Apple 在 WWDC 上公布的两个 skills,在磁盘上是 swiftui-specialist 和 swiftui-whats-new-27。18
  • 如果 xcrun agent skills export 什么都不打印,也不返回,请找找有没有一个隐藏的 Xcode 正停在首次启动界面上等待。我的那个就卡在那里。证据指向的补救办法,是在正常的 Xcode 窗口里走完那个界面;截至本次更新,这个办法尚未经过测试。8

6 月以来的变化

6 月以来有五处变化。

Claude Code 学会了向本地程序索要插件。 2026 年 8 月 12 日发布的 2.1.229 版为插件 marketplace 新增了 command 来源类型:由您机器上的一条命令打印出插件的目录,Claude Code 每次会话都重新解析它,而 mode: "link" 会就地使用该目录,不做复制。对于这类程序,更新日志自己举的例子是“an IDE”。4

Apple 的插件进入了 Anthropic 的 marketplace。 2026 年 9 月 18 日,一位贡献者向 anthropics/claude-plugins-official 发起了一个标题为“Add Xcode plugin (xcode)”的 pull request。第二个 pull request 于 9 月 30 日在该仓库内部发起,好让它的检查能够运行;它承载了这项改动,并于 2026 年 11 月 6 日(UTC)合并。原先那个在几分钟后未经合并即关闭。这项改动是在一个文件中新增 15 行。3

这套 skills 比会议上说的要大。 WWDC 会议点名了两个 SwiftUI skills。1 Xcode 27.2 在我的 Mac 上生成的插件目录里有 16 个,其中的 xctrace 在较早的两个构建版本中并不存在。8

UIKit 现代化 skill 改了名字。 在 Xcode 27.2 beta(构建版本 27B5019j)中,这个文件夹叫 uikit-app-modernization;单看版本号看不出来,但按 bundle 日期看,它是我这三个构建版本里最早的一个。在 27.1 候选版本(27A9275)和 27.2(27B52)中,它叫 app-resizability。四个任务文件保留了原名。其中一个逐字节相同。safe-area 文件原有的 87 行保留了大约一半,并增长到 266 行。orientation 和 uiscreen 两个文件各改动了一行,并分别增加了 62 行和 43 行。第五个任务文件讲的是界面 idiom,描述中现在点名了可折叠的 iPhone Duo、分屏多任务和 Stage Manager。这里没有哪个构建版本同时带有两个名字。8

实验室引文现在以 Apple 的文字记录为准。 6 月时,我引用 SwiftUI 小组实验室依据的是本地转录,并说 Apple 没有发布字幕。如今 Apple 的会议页面带有文字记录,我的几处引文与它有细微出入。在英文原文中,下文的引文用的是 Apple 的原话;本译文中的引文即据此译出。2

离开 Xcode 的两条路径

两条命令都在 xcrun agent 之下。Xcode 给它的帮助说明是“Launch a coding agent with Xcode-provided configuration.”8

# Route 1: loose skill folders
xcrun agent skills export --output-dir ~/xcode-skills

# Route 2: a packaged plugin; prints the directory it built
xcrun agent plugin path --plugin-format claude
skills export plugin path
写出什么 每个 skill 一个文件夹:一个 SKILL.md,多数还带一个存放辅助文件的 references/ 文件夹 一个插件:一份清单文件、一个 skills/ 文件夹,Claude 格式还有一个 .mcp.json
写到哪里 默认为 ./xcode-skills,或用 --output-dir <path> 指定。--replace-existing 会覆盖已有内容 ~/Library/Developer/Xcode/CodingAssistant/ExportedPlugins/<build>/<format>
格式 普通的 skill 文件夹 claude、codex、gemini
27.1 RC 上的 skills 数量 10 15
27.2 beta 上的 skills 数量 10 15
27.2 上的 skills 数量 未测量;命令卡住了 16
是否需要 Xcode 应用 需要。它使用正在运行的 Xcode,或以隐藏方式启动一个,然后等待它 在这台 Mac 上不需要,这里开着 Xcode 的无头模式:已有的目录会立即返回,首次生成则经由后台的 Xcode Service 辅助程序完成。关闭无头模式的情况未测试

无头模式(headless mode)这个名字出自 xcrun mcp-server --help,指的是一项需要主动开启的功能。Apple 的发行说明在 Xcode 27 beta 5 中引入了它,说它是一种“无需打开 Xcode 工作区即可运行”的 MCP 服务器体验的预览。sudo xcrun mcp-server enable 可将其开启,xcrun mcp-server status 则显示您这里是否已经开启。68

无论走哪条路径,文件都是一样的。我把导出的每个文件与同一构建版本插件目录中的对应文件逐一作了比较。每个文件都有对应文件,候选版本上 84 个,beta 上 83 个;除 9 个 SKILL.md 文件外,全部逐字节相同,这 9 个里候选版本占 5 个、beta 占 4 个,它们文件头中各键的顺序不同。8

这一比较对没有插件格式的工具有实际意义。任何 plugin path 目录里的 skills/ 文件夹,都是以普通文件夹形式存在的完整一套:在两条命令都跑完的两个构建版本上是 15 个 skills,而导出工具是 10 个;在 27.2 上是 16 个,那里的导出数量缺失。一行命令就能把它复制到当前文件夹:

cp -R "$(xcrun agent plugin path --plugin-format claude)/skills" ./xcode-skills-full

在 27.2 上,我在一个空文件夹里、没有任何 Xcode 应用运行的情况下执行这条命令,它复制了 16 个 skill 文件夹,共 158 个文件。目标路径必须尚不存在。我第二次运行这行命令时,cp 把一个 skills 文件夹放进了已有的那个文件夹里。这台 Mac 开着无头模式。我没有在关闭它的情况下运行过 plugin path,所以不知道那时这条命令是否需要 Xcode 应用。8

导出工具在这两个构建版本上都没有写出的 5 个 skills,是 3 个无障碍审查 skill 和 2 个翻译 skill。我不知道其中的规则。这 5 个都点名了 Xcode 的 MCP 工具,因此它们预期 agent 已连接 Xcode 的 MCP 服务器,Apple 的设置页面讲的就是这件事。7 但这不可能是规则的全部:导出工具写出的 skills 里,device-interaction 和 audit-xcode-security-settings 这两个同样点名了这类工具,而且后者点名的工具比任何一个未被写出的 skill 都多。第三个被导出的 skill adopt-c-bounds-safety 让 agent 优先使用 Xcode 的 MCP 工具,却没有点名其中任何一个。Apple 的发行说明提到了面向本地化、UIKit 尺寸调整和无障碍的“Apple-built specialists”,6 这份清单涵盖了那 5 个,也涵盖了被导出的 app-resizability。Xcode 的帮助文本则说,导出涵盖“every available skill”。8

插件路径有一个导出路径没有的格式限制。请求任何其他格式都会失败,并给出明确的提示:

$ xcrun agent plugin path --plugin-format cursor
error: Unsupported plugin format 'cursor'. Supported: claude, codex, gemini

只有 Claude 格式包含 MCP 配置。Codex 的清单文件指向 skills/ 文件夹,Gemini 的扩展文件则带有名称、描述和版本。8

Claude Code marketplace 中的插件

marketplace 的条目很短,可以从头到尾读完。下面是 2026 年 11 月 10 日仓库中的 xcode 条目:3

{
  "name": "xcode",
  "displayName": "Xcode",
  "description": "Work with Xcode projects from Claude Code: build, run, and test schemes, render SwiftUI previews, drive simulators and devices, read build logs and diagnostics, and search Apple developer documentation.",
  "author": {
    "name": "Apple Inc."
  },
  "category": "development",
  "source": {
    "source": "command",
    "command": "xcrun agent plugin path --plugin-format claude",
    "mode": "link"
  },
  "homepage": "https://developer.apple.com/xcode/"
}

该文件的 317 个插件中,xcode 是唯一使用 command 来源的,也是唯一作者为 Apple 的。其余 316 个指向的是一个 URL、一个 git 子目录,或 marketplace 仓库内的一个路径。3

command 来源改变了内容由谁持有。Anthropic 的仓库里没有 Apple skills 的任何副本。marketplace 只存了一条命令,skills 则来自您 Mac 上 xcode-select 所指向的那个 Xcode。目录名带有 Xcode 的构建号,所以我机器上的三个构建版本生成了三个目录,而 Claude Code 每次会话都会重新解析这条命令,前提是满足姊妹篇列出的条件。48 按这一设计,更新 Xcode 就会更新插件的 skills,中间无需发布新的插件版本。

安装只需在终端里输入一行命令,或者在会话中输入 /plugin install xcode@claude-plugins-official,后者会先打开插件的详情面板。5

claude plugin install xcode@claude-plugins-official

因为安装要运行一个程序,Claude Code 不会悄悄地执行它。在 Claude Code 2.1.322 上,从非交互式 shell 发起的安装停了下来,并原样打印出它想要执行的内容:8

"xcode" is installed by running a command from marketplace "claude-plugins-official" on this machine:
  xcrun agent plugin path --plugin-format claude
  (mode "link": its output directory is used in place (linked, not copied))
Not an interactive terminal, so the command was only displayed, not accepted. Run this in your own terminal (outside the Claude Code session) to confirm the command shown above.

这条命令必须由人在终端或详情面板中接受。对于脚本化安装,-y 会接受 Claude Code 显示的任何命令;2.1.271 新增的 --accept-command <sha256> 则按哈希值接受某一条特定的命令,如果 marketplace 的插件列表在它背后发生了变化,就会拒绝。48 就本文而言,我的测量就停在这条消息上:我直接读取了插件目录。Apple 自己的 skill 文本把其中一个 skill 称作 xcode-integration:translation-coordinator,而 xcode-integration 这个前缀与插件清单文件中的名称一致。8 11 月 11 日稍后,我用 --plugin-dir 把这个目录加载进了几个会话,这种做法不会安装任何东西,Claude Code 就在这个前缀之下列出了这些 skills。详情见姊妹篇。

Xcode 为 Claude 生成的目录,在 27.2 上是这样的:

claude/
├── .claude-plugin/plugin.json   name "xcode-integration", version 1.0.0
├── .mcp.json                    one stdio server named "xcode": xcrun mcpbridge
└── skills/                      16 folders

如果您已经手动接好了桥接程序,.mcp.json 就值得留意。Apple 面向外部 agent 的文档给出的设置步骤是 claude mcp add --transport stdio xcode -- xcrun mcpbridge,其中没有提到 xcrun agent、导出或这个插件。7 插件声明了一个名称相同、命令也相同的服务器。在我为姊妹篇运行的那些会话里,Claude Code 把插件的服务器当作手动添加的那个服务器的重复项抑制掉了。

Xcode 27.2 交给 agent 的东西

27.2 插件中的 16 个文件夹,以及我根据每个 skill 自身的描述和参考文件列表所作的一行解读:8

Skill 涵盖内容 是否在 skills export 中(27.1 RC、27.2 beta)
swiftui-specialist SwiftUI 最佳实践与性能:数据流、environment、ForEach 标识、修饰符、本地化、软弃用的 API 是
swiftui-whats-new-27 2027 版本中 SwiftUI 的变化,包括 @State 变为宏、重新排序、工具栏、轻扫操作 是
building-document-based-swiftui-applications 使用 SwiftUI Document 协议的文档型应用 是
app-intents-specialist App Intents 的正确性与最佳实践 是
app-intents-whats-new-27 iOS 26 和 iOS 27 版本中 App Intents 的变化 是
app-resizability 适应可调整大小窗口和多窗口的布局;scene 生命周期迁移 27.1 RC 上是;在 beta 中名为 uikit-app-modernization
modernize-tests 用 Swift Testing 的特性对测试套件做现代化改造,或将其从 XCTest 迁移过来 是
adopt-c-bounds-safety 在 C 代码中采用 -fbounds-safety 是
audit-xcode-security-settings 面向安全的构建设置、分析器检查、Enhanced Security 是
device-interaction 借助截图、UI 层级和触摸,在设备或模拟器上检查应用行为 是
accessibility-dynamic-type-specialist 对照 Dynamic Type 辅助功能信息标签审查视图 仅插件
accessibility-sufficient-contrast-specialist 对照 Sufficient Contrast 辅助功能信息标签审查对比度 仅插件
accessibility-voiceover-specialist 针对 VoiceOver 审查标签、特征和自定义控件 仅插件
translation 翻译 String Catalog 中的单条字符串;附带 56 份按语言区域划分的风格指南 仅插件
translation-coordinator 执行整个项目的翻译:添加语言、获取未翻译的字符串、验证 仅插件
xctrace 用 xctrace(Instruments 的命令行界面)做性能剖析,包括挂起问题的排查 27.2 新增;导出情况未测量

按文件数量计,最大的是 translation,有 59 个文件。最大的 SKILL.md 属于 audit-xcode-security-settings,它在参考文件之外还附带一个 scripts/ 文件夹。8

其中两行就是 WWDC 会议上的那两个 skills。swiftui-specialist 开篇就告诉模型,这份指南由 Apple 编写,并且它“supersedes prior training on these topics”,随后按任务把 agent 引向九个参考文件:视图结构、数据流、environment、修饰符、本地化、动画、ForEach,以及两个讲软弃用的文件。8 这种设计就是一份目录:渐进式加载 skills 的 agent 先读描述,等任务需要时再打开某个参考文件。

导出卡住时

在 Xcode 27.2 上,xcrun agent skills export 三次尝试都没有产出任何文件。前两次都连到了一个已在运行的隐藏 Xcode 上,并一直等它。第一次是我手动停掉的,第二次由我设的 40 秒限时结束。第三次之前,我退出了那个 Xcode。这条命令随后自己启动了一个隐藏的 Xcode,什么都没打印,什么都没写出,最后由我设的 45 秒限时结束。同一条命令在 27.1 候选版本和 27.2 beta 上都正常跑完,各列出 10 个 skills。8

Xcode 的 agent 命令没了动静时,我会尝试以下做法。第 1 步和第 2 步是我实际做过的。第 3 步和第 4 步在 27.2 上未经测试,所以请把它们当作证据所指向的假设:

  1. 检查有没有一个您没有打开过的 Xcode:pgrep -lx Xcode。
  2. 退出它。隐藏的 Xcode 在屏幕上没有窗口,所以请用 kill <pid>。在我这里,这结束了每一个隐藏的 Xcode:两个卡住的,以及较早构建版本上那两次正常导出留下来仍在运行的两个。
  3. 正常打开 Xcode,不管它显示的是哪个首次启动界面,都把它走完。
  4. 重新运行命令,并在卡住期间调用过 Xcode MCP 服务器的每个 agent 会话里重启该服务器。

我是怎么查到这里的

系统日志显示了第三次尝试当时在做什么:

/usr/bin/log show --last 5m --info --debug \
  --predicate 'process == "mcpbridge" AND subsystem == "com.apple.IDEIntelligenceChat"'

桥接程序先记录了“launching Xcode hidden”,接着是新进程的 ID,然后是“Waiting for tool service pid 31197 to connect back; no timeout”。正常的运行也会记录同样的等待行,并在几秒后返回,所以单凭这一行并不能诊断出卡住。它的价值在于那个进程 ID。

启动约三分钟后,对该进程做的一次 sample 显示,Xcode 的主线程正处在首次启动体验之中:一个模态的引导窗口,从 applicationDidFinishLaunching 打开,停在自己的事件循环里。由此往下,很可能是这样一条链:隐藏的应用弹出的模态窗口没有人看得到,也就没有人去关闭它,Xcode 始终走不到应答桥接程序的那一步,而桥接程序又没有超时。我没有找到来自 Xcode 一侧的任何日志行,所以这条链是我根据采样和桥接程序日志作出的推断。8

有一项对照支持这一推断。Xcode 保存着一个偏好设置项,从名称看,它列出的是首次启动的平台界面已经展示过的 SDK 构建版本:

defaults read com.apple.dt.Xcode IDEPlatformsFirstLaunchPresentedSDKVersions-iphoneos

在这台 Mac 上,这个列表里有那两个完成了导出的 Xcode 的 iOS SDK 构建版本 24A94232 和 24B5084k,却没有 24B8118,也就是 27.2 中的 iOS SDK 构建版本。这个键的含义,我是从它的名称读出来的。8

这个陷阱不止波及导出

11 月 10 日晚上出现的隐藏 Xcode 中,有两个是卡住的。第一个就是早先几次导出尝试发现已在运行的那个。它启动两秒之后,我的一次 xcrun mcpbridge run-agent --dry-run claude 探测开始等待它,所以那次探测很可能就是启动它的一方;探测迟迟不返回,我也把它停掉了。第一个我没有采样。它显示的是与第二个(也就是我采样的那个)相同的 480 × 632 屏幕外窗口。8

第一个隐藏的 Xcode 还在运行期间,又发生了两件事。xcodebuild -checkFirstLaunchStatus 以 0 退出,可见这项命令行检查发现不了这种状态。另外,某个 agent 会话经由 xcrun mcpbridge 发出的一次工具调用卡住了:该会话的桥接程序记录了“Selected UI Xcode”和那个进程 ID,也就是选中了它,而没有选其他会话的桥接程序整晚都在使用的后台服务。我退出那个隐藏的 Xcode 之后,这个桥接程序仍然卡着。同一会话的下一次调用只记录了请求,之后什么都没有,既没有选择,也没有连接尝试,直到我将它取消。8

目录已经生成好的情况下,xcrun agent plugin path 不会联系任何 Xcode 进程:桥接程序记录“skills already present”后就返回。在这台开着无头模式的 Mac 上,每个目录的首次生成走的是 Xcode Service,即 Xcode bundle 内的一个后台辅助程序,而不是 Xcode 应用。Xcode Service 在第一个隐藏的 Xcode 出现之前就生成了 27.2 的目录,所以插件的数量从未依赖过 Xcode 应用。导出则依赖它,而导出的数量缺失。在有隐藏 Xcode 运行期间,无论是针对已有目录还是首次生成,我都没有运行过 plugin path。8

这两个 skills 是什么

来自 UI Frameworks 团队的 Steven 和 Julia,在用一整场会议讲解 2027 版本的 API 之后,以这则公告为“What’s new in SwiftUI”收尾。1

Watch on Apple Developer ↗

“What’s new in SwiftUI”中关于 agent skills 的片段,从 26:40 开始。

Apple 公布了两个 skills,每个都针对通用模型在 SwiftUI 上会遇到的一种不同的失败模式。SwiftUI Specialist Skill“能帮助您在应用中遵循 SwiftUI 最佳实践”。1 What’s New In SwiftUI Skill“能引导您采用 2027 版本中的新 API”。1 这种分工很重要:在今年这些 API 出现之前训练的模型,根本无从得知全新的工具栏 visibilityPriority 修饰符,或惰性 @State 宏的行为,而且训练数据中夹带的坏习惯,它也会照单全收。一个 skill 承载的是经久不变的技艺;另一个承载的则是模型不可能见过的那些变化。

在 Xcode 内部,您不必按名称去调用它们。“这两个 skills 都可以在 Xcode 27 的 Coding Assistant 中使用”,1 一位实验室座谈嘉宾还说,编码 agent“会在需要的时候自动调用这些 skills”。2 Xcode 的发行说明补充道,skills 也可以作为斜杠命令来调用。6

导出到任意 agent

Apple 在会议 27:12 处是这样说的:“要在其他工具中使用这些 skills,您可以用‘xcrun agent skills export’命令把它们导出。这会生成您可以导入到工作流中的 markdown 文件。”1

xcrun agent skills export

一条命令,markdown 输出,前提是它跑得起来:数量和卡住的情况见上文。如果您是在终端里用 Claude Code,或用 Codex、Cursor 来推进 iOS 工作,同一套由 Apple 编写的 SwiftUI 知识就能直接放进您现有的环境里。导出的文件是纯 markdown,只有 audit-xcode-security-settings 中的一个 Python 脚本例外,因此它们能嵌入您的 agent 已在使用的任何 skill 或上下文机制。在 Xcode 之外运行的模型并不会内置这些 skills,所以要靠导出来弥合这道缺口;您的 agent 若有对应的插件,也可以靠插件。2

打包好的插件点名覆盖三个 agent。其他任何工具都能读取普通的 skill 文件夹,而其中更完整的一套,就是 plugin path 目录里的 skills/ 文件夹,无论您请求的是三种格式中的哪一种。8

这条命令迁移的并不只有 SwiftUI skills。导出的内容里还有那个现代化 skill,它涵盖基于 UIKit scene 的生命周期,并为可调整大小的多窗口应用替换掉 mainScreen、interfaceOrientation 这类遗留的共享状态检查,如今名为 app-resizability。8 这一点之所以重要,是因为 iOS 27 让 scene 生命周期成为强制要求:用新 SDK 构建却尚未采用它的应用将无法启动。

Apple 本可以把这些 skills 限定为 Coding Assistant 专属,并以此作为把您留在 Xcode 里的理由。然而该公司推出了一个导出工具,还有一条面向三个相互竞争的 agent 的插件命令,这等于把知识当作产品,把编辑器看作众多取用者之一。对于早已在运行自家 agent 的开发者而言,这正是“采纳 Apple 的建议”与“从零开始重写一遍”之间的区别。

为何第一方 skills 胜过抓取来的文档

UI Frameworks 团队在一场 WWDC 实验室座谈中,花了一段时间谈的正是这件事,起因是一位开发者在用通用模型进行 vibe coding 时反复撞上 Swift 错误。2

Watch on Apple Developer ↗

SwiftUI for Beginners Group Lab 中关于 skills 的讨论,从 36:37 开始。英文原文的引文逐字照录 Apple 会议页面上的文字记录,口误也原样保留;本译文中的引文据此译出。

一位座谈嘉宾先点出了根本问题:语言模型在 SwiftUI 上“有时候多少会给出有点不太对的结果”,“还有我们一些比较新的 API,模型可能还没真正在上面训练过”。2 按座谈的说法,解法是给 SwiftUI skills 灌入“我们所有的内部知识”,以及“我们在应用数据流方面、在我们推出的新 API 方面所有的最佳实践”。2 这正是相对于抓取公开文档站点的结构性优势:这些 skills 承载着 Apple 自家工程师实际运用的指南,以便于 agent 据以行动的方式组织起来,并随框架一同更新。

座谈还提到了一项效果:“我们确实发现,这些模型在调用这些 skills 的时候,推理明显变好了”,这位嘉宾还“确信,用这些模型的时候,这些 skills 应该能让人多少更安心一些”。2 座谈在实验室稍后给出的性能建议,即把大型视图 body 中的片段抽取为自定义视图而非计算属性、避免在视图 body 内做创建数字格式化器这类繁重工作、只读取视图实际用到的 environment 值,本身就在 skills 之中。一位座谈嘉宾在回答性能问题时就是这么说的:“所有这些指南都在 skills 里。”这位嘉宾接着说,生成这类代码的模型“应该会自动去做,比如把视图重构成更小的视图”。2

磁盘上的文件印证了这一点。swiftui-specialist 列出的第一个参考文件是 references/structure.md,按其描述,它讲的是何时该把各个部分拆成独立的 View 结构体,而不是写成计算属性。8

实验室还作了一处区分:这些 skills 默认加载,按上下文调用。主持人问,开发者是否需要做些什么来启用这些 skills,“还是说它们默认就差不多已经在那儿了”。回答是:“您打开 Xcode、调用编码 agent 的时候,它们应该就在那儿”,以及“这些 skills 应该已经加载好了”。一位座谈嘉宾补充说,agent“应该会在需要的时候去参照一下合适的 skill”。2 这些 skills 对 agent 而言是可用的,某个 skill 相关时,agent 便会调用合适的那一个。

更宏观的模式

Apple 正把精选的 agent skills 当作第一方专业知识的分发渠道,到 11 月,这样的渠道已有三条。

第一条是 Game Porting Toolkit 4。Apple 把它在 Metal 4、MetalFX、着色器编译与 GPU 调试方面的知识,以 expert skills 加上基于里程碑的工作流的形式推出,并作为插件分发,该插件来自 GitHub 上的 Game Porting Toolkit marketplace(在 Claude Code 中通过 /plugin marketplace add apple/game-porting-toolkit 安装),详见 Game Porting Toolkit 4:在 Mac 上进行 agentic 游戏移植。第二条是工具链里的导出工具 xcrun agent skills export。第三条是 Anthropic 官方 marketplace 中的那个条目:Apple 在那里不托管任何内容,插件是什么,全由您安装的 Xcode 说了算。3

机制各不相同。策略在三者中如出一辙:Apple 编写并维护领域知识,把它打包成 agent skills,再让您选用的 agent 去取用。Xcode 自己的发行说明描述了同一思路的接收端:Xcode 中的 agent 由插件扩展,插件中包含 skills、MCP 服务器和 ACP agent 配置。6

问题从“哪个模型最懂 SwiftUI”变成了“我的 agent 有没有加载 Apple 当前的 SwiftUI skill”。运行第一方 skill 的较弱通用模型,可以胜过靠过时训练数据即兴发挥的较强模型,因为这个 skill 承载了今年发布的 API,以及 Apple 工程师实际遵循的实践。导出命令和插件,正是让这一切在 Xcode 之外也能用上的关键。

这些 skills 与 Apple 今年其余的 agentic 故事并肩而立:IDE 走向 agentic,见 Xcode 27 走向 agentic;以及 SwiftUI 2027 版本 API 的全貌,见 iOS 27 的 SwiftUI 新功能。这些 skills 把 Apple 的框架专业知识带进任何承担实际工作的 agent。

关键要点

面向使用 Claude Code 的 iOS 开发者: - 用 claude plugin install xcode@claude-plugins-official 安装 Apple 的插件,读一读 Claude Code 显示的命令,然后亲自接受它。在 Xcode 27.2 上,那条命令打印出的目录里有 16 个 skills 和一个 MCP 服务器条目。我读取了该目录,没有完成安装。38 - 如果您已经手动添加过 xcrun mcpbridge,安装后请检查一下您的 MCP 列表。插件声明了一个同名的服务器;我用 --plugin-dir 加载插件时,Claude Code 把这个服务器当作重复项抑制掉了(姊妹篇)。78

面向使用 Codex、Gemini 或其他 agent 的开发者: - xcrun agent plugin path --plugin-format codex 或 gemini 会生成打包好的插件并打印其路径。两个目录我都生成了,但都没有加载到对应的 agent 中,所以从这个路径到可用的安装之间的那一步,要由您自己来确认。对于其他任何工具,请导入普通文件夹:plugin path 目录里的 skills/ 文件夹包含完整的一套。xcrun agent skills export 在它跑完的两个构建版本上写出了 15 个中的 10 个,在 27.2 上没有完成。8 - 对于任何 2027 版本的 API,请优先采用第一方 skill 而非抓取来的文档;在 2026 年 6 月之前训练的模型没有见过 visibilityPriority、惰性 @State 宏,以及全新的 Document API。1

面向继续留在 Xcode 中的开发者: - 这些 skills 已经加载在 Coding Assistant 中,并会在与您的代码相关时被调用;除了 Xcode 27 之外无需任何设置。2 - 这些 skills 有所疏漏时,请通过 Feedback Assistant 提交反馈。座谈请大家这样做,并说这有助于 Apple 改进这些工具。2

面向 Xcode 更新后 agent 命令卡住的任何人: - 先找找有没有隐藏的 Xcode 进程。我的那个卡在了首次启动界面上。证据指向的补救办法,是在正常的 Xcode 窗口里走完那个界面,而我尚未确认这一办法。8

常见问题

Xcode 27 中的这两个 SwiftUI agent skills 是哪些?

一个是 SwiftUI Specialist Skill,它帮助 agent 遵循 SwiftUI 最佳实践;另一个是 What’s New In SwiftUI Skill,它引导采用 2027 版本中的新 API。两者都可在 Xcode 27 的 Coding Assistant 中使用。1 在磁盘上,它们是 swiftui-specialist 和 swiftui-whats-new-27 这两个文件夹。8

我该如何在 Claude Code 或其他 agent 中使用 Apple 的 SwiftUI skills?

在 Claude Code 中,从官方 marketplace 安装 xcode 插件:claude plugin install xcode@claude-plugins-official。3 对于 Codex 或 Gemini,运行 xcrun agent plugin path --plugin-format codex 或 gemini,它会生成插件并打印其路径。就本文而言,这三个插件,我一个都没有加载到对应的 agent 中。对于其他工具,请导入普通文件夹:要么是 plugin path 目录里的 skills/ 文件夹,它包含完整的一套,8 要么是 xcrun agent skills export 的输出,它会把这些 skills 写成可导入到您工作流中的 markdown 文件。1 在 Xcode 之外运行的模型不会自动获得这些 skills。

Xcode 27.2 包含多少个 skills?

Xcode 27.2(27B52)生成的插件目录包含 16 个 skill 文件夹。xcrun agent skills export 在 27.1 候选版本和 27.2 beta 上各写出了 10 个,没有写出三个无障碍审查 skill 和两个翻译 skill。导出在 27.2 上没有完成,所以它在那里的数量未经测量。8

为什么 xcrun agent skills export 会卡住且没有任何输出?

在我这里,是一个隐藏的 Xcode 停在了首次启动界面上,而这条命令的等待没有超时。在我采样的那次尝试中,那个 Xcode 是命令自己启动的。证据指向的补救办法是:退出隐藏的 Xcode,正常打开 Xcode,并完成首次启动界面。我尚未在 27.2 上确认这一补救办法。8

这些 skills 在 Xcode 内部会自动加载吗?

在 Xcode 27 的 Coding Assistant 内部,这些 skills 默认加载,agent 会根据您正在处理内容的上下文调用合适的那一个。2 您不必按名称去调用它们,不过 Xcode 的发行说明提到,skills 也可以作为斜杠命令来调用。6

为何要使用第一方 skill,而不是让模型依赖自身训练?

通用模型在遇到晚于其训练时点的 API、或夹带过时文档中的习惯时,会产出不正确的 SwiftUI。Apple 的 skills 编码了它的内部最佳实践与当前 API,而一场 WWDC 实验室座谈报告称,模型在调用它们时展现出明显更好的推理能力。2

除了 SwiftUI 之外,Apple 还为别的方面推出 agent skills 吗?

是的。Xcode 27.2 的插件还涵盖 App Intents、无障碍审查、String Catalog 翻译、向 Swift Testing 迁移、C 语言边界安全、安全相关的构建设置、设备交互、窗口大小可调,以及 xctrace。8 另外,Game Porting Toolkit 4 把 Apple 的 Metal 与 MetalFX 移植专业知识作为插件分发,该插件来自 GitHub 上的 Game Porting Toolkit marketplace(在 Claude Code 中通过 /plugin marketplace add apple/game-porting-toolkit 安装)。

我测量了什么

这些测量是我于 2026 年 11 月 10 日在一台机器上做的;11 月 11 日,我又把复制插件 skills/ 文件夹的那行命令运行了两次,并对改名的那个 skill 的文件做了行级 diff。请把它们看作一位开发者的观察,而不是 Apple 的文档。8

  • Mac: macOS 27.0(26A428)。
  • Xcode 构建版本: 27.1 候选版本(27A9275)、27.2 beta(27B5019j)和 27.2(27B52)。
  • Xcode 的无头模式: 开启。xcrun mcp-server status 报告权限已启用、服务器正在运行。我没有在关闭无头模式的 Mac 上运行过这些命令。
  • Claude Code: 2.1.322。
  • Marketplace: anthropics/claude-plugins-official,提交 43fd1f9,即 11 月 10 日的 head。
  • 未验证: 完成首次启动是否能消除卡住的问题;导出在 27.2 上的 skill 数量;有隐藏 Xcode 运行时的 plugin path,无论针对已有目录还是首次生成;经 marketplace 安装之后,插件的 skills 和 MCP 服务器在 Claude Code 会话中如何呈现。姊妹篇讲的是仅限会话的 --plugin-dir 加载,包括插件的 MCP 条目与手动添加的条目并存时表现如何。我针对 Codex 和 Gemini 格式运行了 plugin path 并阅读了输出,没有把其中任何一个加载到对应的 agent 中。

Xcode 27 走向 agentic 涵盖了 Apple agentic 转向的 IDE 一侧,iOS 27 的 SwiftUI 新功能 详述了 What’s New skill 所教授的 2027 版本 API,而 Game Porting Toolkit 4:在 Mac 上进行 agentic 游戏移植 则是游戏一侧与之并列的第一方 skills 故事。完整的系列总览是 Apple Ecosystem 系列。

参考资料


  1. Apple,WWDC 2026 会议 269,What’s new in SwiftUI。此为 Xcode 27 随附的两个 agent skills(SwiftUI Specialist Skill 和 What’s New In SwiftUI Skill)、它们在 Xcode 27 Coding Assistant 中的可用性,以及导出指令的来源:“要在其他工具中使用这些 skills,您可以用‘xcrun agent skills export’命令把它们导出。这会生成您可以导入到工作流中的 markdown 文件。”也是文中所引 2027 版本 SwiftUI API(工具栏 visibilityPriority、惰性 @State 宏、全新的 Document API)的来源。 ↩↩↩↩↩↩↩↩↩↩↩

  2. Apple,WWDC 2026 会议 8002,SwiftUI for Beginners Group Lab,依据的是 2026 年 11 月 11 日获取的会议页面上的文字记录。英文原文所引的段落逐字照录该文字记录,包括其中的口误;本译文中的引文由这些段落翻译而来。本文 6 月的版本引用的是本地转录,其中几处引文与 Apple 的文字记录有细微出入。此为以下座谈说法的来源:语言模型在较新的 API 上会产出不正确的 SwiftUI;这些 skills 被灌入了 Apple 的内部知识与最佳实践;模型在调用这些 skills 时推理得更好;Xcode 中的编码 agent 已加载这些 skills,并在需要时调用它们;性能指南就在 skills 之中;以及座谈请大家就这些 skills 提交反馈。 ↩↩↩↩↩↩↩↩↩↩↩↩↩

  3. Anthropic,anthropics/claude-plugins-official,.claude-plugin/marketplace.json(提交 43fd1f9),读取于 2026 年 11 月 10 日:上文引用的 xcode 条目,以及各项计数(317 个插件;一个 command 来源;一个作者为 Apple 的条目)。该条目经由 pull request #6338 进入,后者于 2026 年 11 月 6 日 00:55 UTC 合并,在那一个文件中新增 15 行。其描述称,它承载的是 pull request #6259“by its original author”的改动,以便仓库的检查能够运行。#6259 的标题为“Add Xcode plugin (xcode)”,发起于 2026 年 9 月 18 日,在 #6338 合并几分钟后未经合并即关闭。之所以称该插件为 Apple 的插件,依据是 marketplace 条目的作者字段,以及随 Xcode 内置的 xcrun agent plugin 命令。 ↩↩↩↩↩↩↩

  4. Anthropic,Claude Code changelog。2.1.229 版(2026 年 8 月 12 日)新增了插件 marketplace 的 command 来源:由一条本地命令“(e.g. an IDE)”打印出插件目录,该目录每次会话都重新解析,mode: "link" 则就地使用它。2.1.271 版(2026 年 9 月 14 日)为 claude plugin install 和 claude plugin update 新增了 --accept-command <sha256>。 ↩↩↩↩

  5. Anthropic,Claude Code 文档,Install and manage plugins,获取于 2026 年 11 月 10 日。此为 /plugin install <name>@<marketplace> 这一形式的来源,也是“在会话中,它会先在 /plugin 面板里打开插件的详情,然后才安装”这一点的来源。 ↩

  6. Apple,Xcode 27 Release Notes。此为以下内容的来源:Xcode 中的 agent 由包含 skills、MCP 服务器和 ACP agent 配置的插件扩展,且 skills 可作为斜杠命令调用;那种“无需打开 Xcode 工作区即可运行”的 MCP 服务器体验,用 sudo xcrun mcp-server enable 开启,用 xcrun mcp-server status 查看;以及 Xcode 附带“针对特定任务的 Apple-built specialists,例如本地化、UIKit 尺寸调整和无障碍”这句话。 ↩↩↩↩↩

  7. Apple,Giving external agents access to Xcode,获取于 2026 年 11 月 10 日。此为 claude mcp add --transport stdio xcode -- xcrun mcpbridge 和 codex mcp add xcode -- xcrun mcpbridge 作为文档所载设置步骤的来源。在该日期,页面没有提到 xcrun agent、skills export 或插件。 ↩↩↩

  8. 作者的测量,2026 年 11 月 10 日和 11 日,所用机器和构建版本列于“我测量了什么”一节。来源:各构建版本上 xcrun agent --help、xcrun agent skills export 和 xcrun agent plugin path 的输出;这些命令写出的目录的内容,包括每个 skill 的 SKILL.md 文件头;Claude Code 2.1.322 上的 claude plugin install 及其 --help;mcpbridge 进程的统一日志;对隐藏 Xcode 进程的一次 sample;xcodebuild -checkFirstLaunchStatus、xcrun mcp-server status 和 xcrun mcp-server --help;以及 Xcode 偏好设置中其首次启动界面已展示过的 SDK 构建版本,并与每个 Xcode 内的 iOS SDK 构建版本作了比较。计数为这些目录中的文件夹数和文件数。表格每行转述一个 skill 的描述;引号内的短语为原文照录。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

相关文章

Anthropic Python SDK 1.0迁移:手动操作还是使用Claude Code

将anthropic 0.x迁移到1.0:httpx2、异步原始响应、Bedrock区域。可依照MIGRATION.md手动迁移,或使用Claude Code的/claude-api upgrade python。

6 分钟阅读