Swift Testing Agent Skill —— 面向 AI 编程助手的 Swift 测试专业技能

一个帮助 Claude Code、Codex、Cursor、Gemini 等 AI 编程助手使用 Swift Testing 框架写出更优质测试代码的 Agent 技能。内容覆盖 @Test、#expect、#require、参数化测试、特质（traits）、退出测试（exit tests）、确认测试（confirmations）等，专门针对 LLM 实际容易犯的错误而编写。

同系列还有：

更多面向 Swift 和 Apple 平台开发的 Agent 技能，请访问 Swift Agent Skills。

安装 Swift Testing Pro

Claude Code

在插件市场中添加 Swift Testing Agent Skill，然后安装插件：

/plugin marketplace add twostraws/Swift-Testing-Agent-Skill
/plugin install swift-testing-pro@swift-testing-agent-skill

Codex、Gemini、Cursor 及其他工具

npx skills add https://github.com/twostraws/swift-testing-agent-skill --skill swift-testing-pro

如果报错 npx: command not found，说明你还没装 Node。先通过 Homebrew 安装：

brew install node

如果这一步也失败，通常是因为你需要先安装 Homebrew。

使用 npx 安装时，你可以精确选择要启用该技能的 Agent；也可以选择是只在当前项目安装，还是对所有项目可用。

或者，你也可以克隆整个仓库，按自己喜欢的方式安装。

如果你使用 Xcode，可在 YouTube 观看视频如何在 Xcode 中安装和使用 Agent Skills（英文）了解安装步骤。

使用 Swift Testing Pro

本技能名为 Swift Testing Pro，可通过多种方式触发。例如，在 Claude Code 中输入：

/swift-testing-pro

在 Codex 中输入：

$swift-testing-pro

两种方式都可以附加具体指令，只做部分检查。比如在 Claude 中 /swift-testing-pro 确保我的测试完全参数化，或在 Codex 中 $swift-testing-pro 给我的测试套件加上退出测试。

你也可以用自然语言触发：

用 Swift Testing Pro 技能找找这个项目里测试代码可以改进的地方。

为什么要为 Swift Testing 做一个 Agent 技能？

我写过一本 Swift Testing 方面的书，并随着新特性的加入不断更新。我还写过一系列介绍 Swift 新特性的深度文章（示例见这里、这里、这里），所以吃透 Swift Testing 的方方面面可以说是我的本职工作。

本技能就是这些工作的结晶。其中收录的规则直接瞄准 LLM 写 Swift Testing 时常犯的错误——涵盖它们训练数据里还没有的新特性、它们容易搞错的老特性，以及帮助测试代码更精简、跑得更快的模式。

它不是把所有 Swift Testing 建议一股脑塞进来。Agent 对 Swift Testing 的基础已经掌握得不错，再教一遍它们已经知道的东西，纯粹是在烧 token。

本技能只聚焦真正有价值的内容。

许可证

Swift Testing Pro 由 Paul Hudson 原创——他也是 Hacking with Swift 免费 Swift 教程的作者。本项目采用 MIT 许可证，允许商业使用、修改、分发和私人使用。