关于 guide-swift-testing
面向采用现代测试实践的 Swift 开发者,提供 Swift Testing 编写与审查工作流指南。内容涵盖测试结构、异步行为、新框架特性及迁移,并默认保留现有 XCTest。
主要功能
- 01Swift Testing 规范检查
- 02测试结构与断言指导
- 03异步测试和 Actor 隔离检查
- 04新框架特性指导
- 05XCTest 迁移指导
适用场景
- 01审查 Swift Testing 测试套件
- 02检查异步测试
- 03改进断言与依赖注入
- 04规划 XCTest 转换
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ prisma-labs-dev/ apple-skills --skill guide-swift-testing安装后在 Claude Code 中输入/guide-swift-testing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/async-tests.mdcore-rules.mdmigrating-from-xctest.mdnew-features.mdwriting-better-tests.md详细介绍
Guide Skill — 这是专家工作流/模式指南,并非 API 参考文档。 最初来自 Paul Hudson 的 twostraws/Swift-Testing-Agent-Skill。MIT License。
Swift Testing 模式
编写和审查 Swift Testing 代码,确保其正确、使用现代 API 并遵循项目约定。只报告真实问题,不要挑剔或凭空捏造问题。
核心说明
- 目标为 Swift 6.2 或更高版本,并使用现代 Swift 并发功能。
- Swift Testing 不支持 UI 测试,此类测试必须使用 XCTest。
- 除非收到请求,否则不要将现有 XCTest 重写为 Swift Testing。
审查流程
- 使用
references/core-rules.md确保测试遵循核心约定。 - 使用
references/writing-better-tests.md验证结构、断言、依赖注入和最佳实践。 - 使用
references/async-tests.md检查异步测试、确认、时间限制、Actor 隔离和网络模拟。 - 使用
references/new-features.md确保正确使用原始标识符、退出测试和附件等新功能。 - 如果要从 XCTest 迁移,请遵循
references/migrating-from-xctest.md。
如果只进行部分工作,只加载相关参考文件。
参考资料
| 主题 | 参考资料 |
|---|---|
使用结构体而非类、@Suite、并行执行、withKnownIssue、标签 | references/core-rules.md |
测试规范、结构、依赖注入、#expect 与 #require、Issue.record()、验证方法 | references/writing-better-tests.md |
串行测试、confirmation()、时间限制、Actor 隔离、网络模拟 | references/async-tests.md |
| 原始标识符、退出测试、附件、测试范围特征、基于范围的确认 | references/new-features.md |
| XCTest 到 Swift Testing 的转换、断言映射、浮点容差 | references/migrating-from-xctest.md |
评论
支持 Markdown