ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

谷歌刚把 Antigravity 升级到 1.14.2,Agent Skills 生态又添 SwiftUI 猛将

谷歌刚把 Antigravity 升级到 1.14.2,Agent Skills 生态又添 SwiftUI 猛将

谷歌刚把 Antigravity 升级到 1.14.2,Agent Skills 生态又添 SwiftUI 猛将

【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址: https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill

Agent Skills 正在成为 2026 年 AI 编程领域最被低估的"基础设施"。它由 Anthropic 以开放标准形式发布,却被谷歌在 1 月宣布接入自家 IDE Antigravity、被 OpenAI 的 Codex 显式支持、被苹果在 WWDC 2026 的 Xcode 27 中纳入——一个由 Anthropic 定义的标准,如今让谷歌、苹果、OpenAI 三家坐到了同一张桌子上。而就在这轮生态扩张中,SwiftUI-Agent-Skill 以"9 大规则精准纠偏 LLM 生成的 SwiftUI 代码"的姿态成为该生态里针对苹果平台最锋利的技能包之一。本文结合仓库源码与社区实测反馈,拆解 Antigravity 1.14.2 支持 Skills 意味着什么,以及这套技能包如何横跨 Claude Code、Codex、Gemini、Cursor 多工具工作流。

Antigravity 1.14.2 与 Skills 支持意味着什么

2026 年 1 月,谷歌 Antigravity 正式支持 Agent Skills 的消息在中文社区被冠以"2026 年 Skills 元年正式开启"的评价。社区文章给出的信息非常具体:Antigravity 同时支持两种技能存放位置——工作区级的<workspace-root>/.agent/skills/<skill-folder>/,用于项目特定的团队流程与测试规范;全局级的~/.gemini/antigravity/skills/<skill-folder>/,用于跨项目复用的个人工具。这与 Claude Code、Codex 的"技能目录"哲学完全同构,意味着开发者为 Claude Code 写的技能包,克隆到 Antigravity 的目录下即可直接复用。

更关键的是其上下文管理机制。Antigravity 采用与 Agent Skills 标准一致的"渐进式披露"(Progressive Disclosure)模式:对话开始时只加载全部技能的名称与描述,约 100 tokens;命中相关技能后再读取完整SKILL.md(建议控制在 5000 tokens 以内);执行过程中按需加载引用的参考文件或捆绑脚本。这套机制直击 AI 编程工具最核心的瓶颈——上下文窗口是稀缺资源,而技能包让"领域知识"不再依赖模型权重里的隐式记忆,变成可版本控制、可审计、可复现的文件资产。

社区对这次升级的评价可以概括为三层:

  • 知识外置化:把团队规范、领域经验从"聊天提示词"中解放出来,用 Git 管理知识的每一次演进;
  • 上下文高效化:元数据先行、指令按需加载,在有限窗口内最大化有效信息密度;
  • 能力生态化:开放标准带来互操作性,一次编写、多处部署,用户投资的知识资产不被单一平台锁定。

需要强调的是 Skills 与 MCP(Model Context Protocol)并非替代关系。MCP 告诉智能体"你可以执行这个操作",Skills 则告诉智能体"在这种场景下,按照什么流程、使用哪些工具去完成"。前者扩展能力边界,后者提供流程化的领域知识,二者互补。Antigravity 的接入,本质上是把这条"可编程智能"的通道从 Anthropic 自家生态铺向了 Google 生态。

SwiftUI-Agent-Skill:一份跨工具通用的 SwiftUI 审查手册

在这个开放标准被三家巨头同时接纳的窗口期,SwiftUI-Agent-Skill 恰好是验证"一次编写、多处部署"理念的最佳样本。它的定位非常清晰:帮助 AI 编程助手写出更现代、更简洁、更符合 Apple 人机界面指南的 SwiftUI 代码,覆盖 API 使用、设计、性能、无障碍四大主线,专门瞄准大模型真实会犯的错误——弃用 API 照用不误、图标按钮对 VoiceOver 不可见、body里藏着隐蔽性能陷阱。

入口文件与 9 步审查流程

整个技能的核心入口是 swiftui-pro/SKILL.md,它用 YAML frontmatter 声明了技能元数据,然后定义了一套固定顺序的 9 步审查流程:

  1. 用 api.md 检查弃用 API;
  2. 用 views.md 检查视图、修饰符与动画写法;
  3. 用 data.md 校验数据流配置;
  4. 用 navigation.md 检查导航更新与性能;
  5. 用 design.md 校验是否符合 Apple 人机界面指南;
  6. 用 accessibility.md 验证 Dynamic Type、VoiceOver、Reduce Motion 合规;
  7. 用 performance.md 确保代码高效运行;
  8. 用 swift.md 快速校验 Swift 代码;
  9. 用 hygiene.md 做最终代码卫生检查。

且 SKILL.md 明确要求:"如果做部分审查,只加载相关的参考文件"(If doing a partial review, load only the relevant reference files)——这恰好呼应了 Antigravity 渐进式披露的设计哲学:全量审查走完 9 步,专项审查(如只查弃用 API、只聚焦无障碍)则按需加载对应分册,省 token 且不污染注意力。

规则不是泛泛建议,而是可执行清单

与普通"最佳实践"文章不同,这套技能包的规则粒度极细、可执行性极强。以 api.md 为例,它直接给出了一条条"必须/禁止"级指令:foregroundColor()必须换成foregroundStyle()、cornerRadius()必须换成clipShape(.rect(cornerRadius:))、tabItem()必须换成TabAPI、.navigationBarLeading与.navigationBarTrailing已弃用须改用.topBarLeading与.topBarTrailing,甚至细化到Text拼接禁用+运算符、必须改用文本插值。这类规则恰恰是 LLM 生成代码时最常踩、也最难以自查的软性弃用(soft deprecation)。

accessibility.md 则直击大模型的经典盲区:只有图标的按钮对 VoiceOver 完全不可见,规则要求按钮必须带文本标签——Button("Label", systemImage: "plus", action: myAction),若确有纯图标展示需求则用.labelStyle(.iconOnly)保留视觉同时让文本可被读屏;同时禁止用onTapGesture()模拟按钮,除非补充.accessibilityAddTraits(.isButton)。

performance.md 给出了更反直觉的工程洞察:切换修饰符值时优先用三元表达式而非 if/else 分支,以规避_ConditionalContent带来的结构性身份丢失与平台视图反复重建;存储 escaping@ViewBuilder闭包是反模式,应改为存储构建好的视图值——仓库中还给出了完整的 CardView 反例与正例对照。

navigation.md 则强调:所有旧版NavigationView都应换成NavigationStack/NavigationSplitView,且严禁在同一导航层级混用navigationDestination(for:)与NavigationLink(destination:)——这是会导致严重问题的经典组合错误。

输出格式固定,结果可对比可复用

稳定性还体现在输出上。SKILL.md 硬性规定了审查报告结构:按文件组织,每个问题依次给出文件与行号、被违反的规则名(如"UseforegroundStyle()instead offoregroundColor()")、修改前/修改后代码对照,最后附按优先级排序的总结。仓库内置的示例报告展示了完整形态:

// Before Text("Hello").foregroundColor(.red) // After Text("Hello").foregroundStyle(.red)
// Before Button(action: addUser) { Image(systemName: "plus") } // After Button("Add User", systemImage: "plus", action: addUser)

同一份代码跑两次、换任何工具跑,得到的是同一格式、可直接 diff 对比的报告。这与社区总结的结论一致:稳定性来自"结构",而不是"话术"——规则文件化(不依赖聊天记忆)、加载按需化(上下文干净)、输出模板化(结果可对比),这三点正是 Agent Skills 格式相对传统提示词的降维优势。

跨工具接入方式

仓库对多工具的适配做得非常完整。README 提供了一条npx skills add一行安装命令(可精确选择安装到哪些 Agent、生效范围是单项目还是全项目),Claude Code 用户则可通过插件市场/plugin install swiftui-pro@swiftui-agent-skill安装。触发方式因工具而异但同样直白:Claude Code 用/swiftui-pro,Codex 用$swiftui-pro,支持附带焦点指令如/swiftui-pro Check for deprecated API或$swiftui-pro Focus on accessibility,也可以直接用自然语言"Use the SwiftUI Pro skill to look for performance problems"触发。

针对 OpenAI 兼容工具,仓库还提供了标准的 Agent 接口描述 swiftui-pro/agents/openai.yaml,声明了技能展示名、简介、品牌色与默认提示语,并开启allow_implicit_invocation——允许智能体在任务匹配时隐式调用,这正是 Antigravity 中"根据 description 自动激活技能"机制所依赖的接口规范。

谷歌、Anthropic、苹果三方夹击下的技能包格局

把 SwiftUI-Agent-Skill 放回更大的棋局里,能看到一条清晰的演进线:

Anthropic 定义了标准。Agent Skills 由 Claude Code 团队开发并以开放标准发布,SKILL.md+ frontmatter 的格式如今是整个生态的公共语法。SwiftUI-Agent-Skill 的作者 Paul Hudson 正是基于这一格式,把自己数万小时的 SwiftUI 实战经验压缩成 9 个可引用分册,并明确要求贡献者"不要重复 LLM 已经会的东西,重点放在边界情况、易错点和软性弃用上"——这是对 token 预算的自觉,也是技能包区别于普通文档的关键设计约束。

谷歌把标准铺进了自家 IDE。Antigravity 1.14.2 对 Agent Skills 的完整支持(工作区级与全局级目录、渐进式披露、自动触发)意味着 Gemini 系的编程工具获得了与 Claude Code 完全一致的能力扩展通道。谷歌 10 月初在服务端 Swift SDK 上的动作(社区称之为"Swift Server,又多了一个 Google")与 Antigravity 的 Skills 支持相互呼应——Google 正在 Swift 生态里双线下注。

苹果则在封闭生态内给出自己的答案。WWDC 2026 之后,Xcode 27 开始收录 Agent 技能,Swift 周报将其列为与 Swift 6.4、iOS 27 并列的重点。SwiftUI-Agent-Skill 的基线设定(iOS 26 为默认部署目标、Swift 6.2+、现代 Swift Concurrency)与苹果最新系统完全对齐,hygiene.md 甚至专门指导智能体优先使用 Xcode MCP 的RenderPreview渲染 SwiftUI 预览截图、用DocumentationSearch检索苹果最新文档——技能包与苹果自家 AI 基建深度咬合。

加上 OpenAI Codex 的显式技能选择、Cursor 的 IDE 集成,一个耐人寻味的格局成型了:标准源自 Anthropic,但采纳它的是包括谷歌、苹果、OpenAI 在内的全部头部玩家。对开发者而言,这意味着为 SwiftUI-Agent-Skill 投入的每一次规则沉淀,都能在 Claude Code、Antigravity、Codex、Cursor 之间无损迁移——知识资产不再被单一平台绑架,这或许是 Agent Skills 比任何一个具体工具都更值得押注的原因。

结语

Antigravity 1.14.2 支持 Agent Skills,表面上是谷歌对一份开放标准的又一次采纳,实质上宣告了"以技能包为单位的领域知识"正式成为跨厂商、跨工具的公共资产。而 SwiftUI-Agent-Skill 恰好站在这个交叉点上:它用一份 SKILL.md 加 9 个分册,把 LLM 写 SwiftUI 时最易犯的错变成可执行的检查清单,并让同一套规则在 Claude、Gemini、Codex 三大家族的工具里产出格式统一、可对比的审查报告。当 AI 编程从"提示词手艺"走向"技能包工程",像 SwiftUI-Agent-Skill 这样把数万小时经验结构化沉淀的开源项目,正在成为这个新范式里最稀缺的资产——真正可编程的智能,或许就藏在这些文件里。

【免费下载链接】SwiftUI-Agent-SkillSwiftUI agent skill for Claude Code, Codex, and other AI tools.项目地址: https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进