mcpField
G
guide-swift-testing

guide-swift-testing

github.com/prisma-labs-dev测试与质量349450 次安装5 周前更新
代码仓库

关于 guide-swift-testing

面向采用现代测试实践的 Swift 开发者,提供 Swift Testing 编写与审查工作流指南。内容涵盖测试结构、异步行为、新框架特性及迁移,并默认保留现有 XCTest。

主要功能

  1. 01Swift Testing 规范检查
  2. 02测试结构与断言指导
  3. 03异步测试和 Actor 隔离检查
  4. 04新框架特性指导
  5. 05XCTest 迁移指导

适用场景

  1. 01审查 Swift Testing 测试套件
  2. 02检查异步测试
  3. 03改进断言与依赖注入
  4. 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.md
core-rules.md
migrating-from-xctest.md
new-features.md
writing-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。

审查流程

  1. 使用 references/core-rules.md 确保测试遵循核心约定。
  2. 使用 references/writing-better-tests.md 验证结构、断言、依赖注入和最佳实践。
  3. 使用 references/async-tests.md 检查异步测试、确认、时间限制、Actor 隔离和网络模拟。
  4. 使用 references/new-features.md 确保正确使用原始标识符、退出测试和附件等新功能。
  5. 如果要从 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