Loading...
正在加载...
请稍候

SwiftUI Agent Skill:当领域专家开始为 AI 编译自己的知识

✨步子哥 (steper) • 2026年10月09日 22:02

SwiftUI Agent Skill:当领域专家开始为 AI 编译自己的知识

研究对象:twostraws/SwiftUI-Agent-Skill
抓取日期:2026-10-09 | 当日 stars:+88
语言:Markdown(Agent Skill)| 许可证:MIT
GitHub:https://github.com/twostraws/SwiftUI-Agent-Skill
作者:Paul Hudson(Hacking with Swift 创始人)

一个 Markdown 文件为什么能上 GitHub Trending?

SwiftUI-Agent-Skill 的核心就是一个 Markdown 文件——没有代码、没有可执行文件、没有 npm install。它上 GitHub Trending 的原因不是技术复杂度,而是知识密度。

这个 skill 文件是 Paul Hudson(社区名 twostraws)把十几年 SwiftUI 开发经验"编译"成 AI 可读的规则集。它不是文档,不是教程,而是给 AI 编码助手看的"避坑指南"。

Paul Hudson 是谁?他是 Hacking with Swift 的创始人,可能是全球最有影响力的 Swift 教育者。他的 SwiftUI 教程被苹果官方推荐,他的文章被无数 iOS 开发者当作入门读物。当这样一个人把他的知识"编译"成 agent skill,这件事本身就值得注意。

这个 Skill 具体做什么?

安装后,SwiftUI Agent Skill 会在 Claude Code、Codex、Gemini、Cursor 等 AI 编码工具里激活。当 AI 在写 SwiftUI 代码时,skill 会自动检查以下问题:

  • VoiceOver 可见性:LLM 经常生成对辅助功能不可见的按钮
  • 废弃 API:LLM 不一定知道某个 API 在 iOS 18 已经废弃
  • 性能陷阱:某些 SwiftUI 写法在运行时会导致意外重渲染
  • 布局错误:常见的布局约束冲突
  • 状态管理:@State、@Binding、@Observable 的误用

Paul Hudson 在他的文章里解释了为什么需要这个 skill:

"The rules contained here directly target common SwiftUI mistakes made by LLMs. They sometimes make buttons invisible to VoiceOver, they frequently use deprecated API, and they would often write code that causes surprise performance problems."

关键洞察是:LLM 在 SwiftUI 上的错误模式是系统性的,不是随机的。它们会反复犯同一类错误——不是因为不懂 SwiftUI,而是因为训练数据里的 SwiftUI 代码很多是过时的或错误的。

"领域专家的 AI 编译"

SwiftUI Agent Skill 代表了一个更大的趋势:领域专家开始把隐性知识编码为 AI 可读的规则集。

这个过程和编译器优化有结构性的相似:

编译器优化 Agent Skill
源代码 领域专家的知识
编译器 AI 编码助手
优化规则 Skill 规则
目标代码 AI 生成的代码
运行时检查 Skill 触发条件

编译器优化是"把人类对硬件特性的理解编码为优化规则,让编译器生成更好的机器码"。Agent Skill 是"把人类对特定领域的理解编码为规则,让 AI 生成更好的代码"。

两者的共同点:不是替代工具(编译器/AI),而是给工具注入领域知识。

为什么不是文档?

有人会问:为什么不直接把 SwiftUI 文档喂给 AI?为什么要单独写一个 skill?

答案在于文档和规则的区别:

  • 文档是描述性的:"SwiftUI 的 Button 组件可以这样用..."
  • 规则是规范性的:"当生成 SwiftUI Button 时,必须检查 accessibilityLabel 是否存在"

文档告诉 AI "什么是正确的",规则告诉 AI "什么是常见的错误以及如何避免"。LLM 已经有大量 SwiftUI 文档了,但它们还是会犯错——因为文档不包含"这种写法看起来对但在运行时会有问题"这类隐性知识。

Paul Hudson 的 skill 里有很多这种"看起来对但实际有问题"的规则。比如某些 SwiftUI 修饰符的顺序会影响布局结果——这个知识在官方文档里没有强调,但在实际开发中是关键。LLM 从训练数据里学不到这个,因为训练数据里的代码很多写错了。

Skill 的安装方式

SwiftUI Agent Skill 支持多种安装方式:

# Claude Code 的 plugin marketplace
/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill

# 或直接 clone 仓库
git clone https://github.com/twostraws/SwiftUI-Agent-Skill

安装后,在 Claude Code 里用 /swiftui-pro 触发,在 Codex 里用 $swiftui-pro 触发。也可以用自然语言:"Use the SwiftUI Pro skill to look for performance problems in this project."

这个安装/触发机制和 Claude Code 的 plugin 系统深度集成。Skill 不是独立的命令行工具,而是嵌入在 AI 编码助手的对话流里——AI 在写代码时自动调用 skill 规则,用户不需要手动切换工具。

"Agent Skill" 生态的演化

SwiftUI Agent Skill 不是第一个 agent skill,但它是第一个由顶级领域专家亲自维护的 skill。这个趋势在 2026 年下半年加速:

  • addyosmani/agent-skills:通用前端开发 skill(2026 年 8 月)
  • mattpocock/skills:TypeScript 开发 skill(2026 年 9 月)
  • marketingskills:营销策略 skill(2026 年 10 月)
  • SwiftUI-Agent-Skill:SwiftUI 专项 skill(2026 年 10 月)

演化方向很清楚:从通用 → 领域专项 → 专家维护。早期的 agent skills 是"什么都管一点"的通用规则集,现在开始出现"某个领域最权威的人亲自写"的专项 skill。

这和 linter 规则的演化路径类似:早期 ESLint 只有通用规则,后来出现了 eslint-plugin-react、eslint-plugin-vue 等框架专项规则,再后来出现了 Airbnb、Google 等公司维护的规则集。Agent skill 正在走同一条路,但速度快得多。

"错误模式是系统性的"

Paul Hudson 在介绍文章里提到一个关键观察:LLM 在 SwiftUI 上的错误是系统性的。

这不是 SwiftUI 独有的现象。LLM 在任何特定框架上的错误都有系统性模式:

  • React:LLM 倾向于在 useEffect 里做不该做的事
  • SQL:LLM 倾向于生成 N+1 查询
  • CSS:LLM 倾向于用 !important 解决布局问题
  • SwiftUI:LLM 倾向于生成对 VoiceOver 不可见的按钮

这些错误模式来自训练数据的偏差——网上公开的代码很多是过时的、不完整的、或直接是错的。LLM 学到了"看起来对"的代码,但不知道运行时会有问题。

Agent skill 的价值就是把"看起来对但实际有问题"的隐性知识显性化。这不是文档能做的事,因为文档描述的是"正确的用法",不是"常见的误用"。

对 AI 编码助手生态的意义

SwiftUI Agent Skill 揭示了 AI 编码助手的一个新维度:AI 的能力不只取决于模型,还取决于它加载的 skill。

同一个 Claude Code,加载了 SwiftUI skill 和没加载,在写 SwiftUI 代码时的表现差距巨大。这意味着:

  1. Skill 成为 AI 能力的乘数:模型不变,skill 让 AI 在特定领域更强
  2. 领域专家有了新的影响力渠道:不写代码库,写 skill 就能影响 AI 的输出质量
  3. Skill 质量成为竞争维度:哪个 AI 编码助手能加载更好的 skill,哪个就更有优势

这和浏览器的扩展生态类似:浏览器本身的能力差不多,但扩展质量决定了用户体验。AI 编码助手的 skill 生态正在形成类似的格局。

结语

SwiftUI Agent Skill 看起来只是一个 Markdown 文件,但它代表了一个重要的转变:领域专家开始直接为 AI 编译知识。

过去,领域专家的影响力渠道是写书、写博客、做教程。现在,多了一个渠道:写 agent skill。这个渠道的影响力可能比前几个都大——因为 skill 直接嵌入 AI 的推理过程,影响 AI 生成的每一行代码。

当 Paul Hudson 这样的顶级教育者开始写 agent skill,说明这个渠道已经被认可。接下来,每个领域都会出现自己的"权威 skill"——React 专家写 React skill、数据库专家写 SQL skill、安全专家写安全审计 skill。

Agent skill 不是文档的替代品,它是知识的新编译目标。


GitHub:https://github.com/twostraws/SwiftUI-Agent-Skill
作者文章:https://www.hackingwithswift.com/articles/swiftui-agent-skill

讨论回复

加载中...
正在加载回复...

正在加载回复...

推荐
智谱 GLM-5 已上线

我正在智谱大模型开放平台 BigModel.cn 上打造 AI 应用,智谱新一代旗舰模型 GLM-5 已上线,在推理、代码、智能体综合能力达到开源模型 SOTA 水平。

领取 2000万 Tokens 通过邀请链接注册即可获得大礼包,期待和你一起在 BigModel 上畅享卓越模型能力
登录