К основному содержанию
скилл CX Codex

swift-testing · johnrogers — скилл для Claude Code: тесты на Swift Testing

Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает swift-testing

Скилл подсказывает, как устроить тесты на Swift Testing: использовать #expect для проверок, а #require — когда без значения нельзя продолжать тест. Он также показывает тесты ошибок, асинхронные функции и проверку вызова обратного вызова через confirmation.

При переносе с XCTest скилл сопоставляет старые утверждения с макросами Swift Testing. Для парных наборов аргументов нужен zip: без него несколько коллекций образуют декартово произведение. Тесты запускаются параллельно, поэтому сценарии с общими файлами, базами данных или синглтонами могут конфликтовать; для таких случаев описан .serialized.

Какие задачи решает

  • перенести утверждения XCTest на макросы Swift Testing
  • проверить результат асинхронной операции
  • сопоставить входные значения с ожидаемыми через zip
  • проверить, что обратный вызов был вызван
  • изолировать тесты, которые используют общее состояние

Примеры запросов агенту

  • Перенеси тесты XCTest на Swift Testing и замени старые утверждения подходящими макросами.
  • Напиши асинхронный тест для fetchData() с проверкой результата.
  • Параметризуй тест для парных входных значений и не допускай декартово произведение.

Как установить swift-testing

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill swift-testing -a claude-code

3Вручную: положить файлы

~/.claude/skills/swift-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/swift-testing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о swift-testing

Как установить swift-testing в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add johnrogers/claude-swift-engineering, затем установите плагин командой /plugin install swift-engineering@claude-swift-engineering.

Что делает swift-testing?

Скилл помогает писать тесты на Swift Testing и переносить проверки с XCTest. Он охватывает асинхронные тесты, проверку ошибок и параметризацию.

Зачем использовать zip в параметризованных тестах?

Если передать несколько коллекций без zip, Swift Testing создаст все комбинации их значений. zip связывает элементы попарно.

Исходный текст

SKILL.md · MIT
---
name: swift-testing
description: Use when writing tests with Swift Testing (@Test, #expect, #require), migrating from XCTest, implementing async tests, or parameterizing tests.
---

# Swift Testing Framework

Modern testing with Swift Testing framework. No XCTest.

## Overview

Swift Testing replaces XCTest with a modern macro-based approach that's more concise, has better async support, and runs tests in parallel by default. The core principle: if you learned XCTest, unlearn it—Swift Testing works differently.

## References

- [Apple Documentation](https://developer.apple.com/documentation/testing)
- [Migration Guide](https://steipete.me/posts/2025/migrating-700-tests-to-swift-testing)

## Core Concepts

### Assertions

| Macro | Use Case |
|-------|----------|
| `#expect(expression)` | Soft check — continues on failure. Use for most assertions. |
| `#require(expression)` | Hard check — stops test on failure. Use for preconditions only. |

### Optional Unwrapping

```swift
let user = try #require(await fetchUser(id: "123"))
#expect(user.id == "123")
```

## Test Structure

```swift
import Testing
@testable import YourModule

@Suite
struct FeatureTests {
    let sut: FeatureType
    
    init() throws {
        sut = FeatureType()
    }
    
    @Test("Description of behavior")
    func testBehavior() {
        #expect(sut.someProperty == expected)
    }
}
```

## Assertion Conversions

| XCTest | Swift Testing |
|--------|---------------|
| `XCTAssert(expr)` | `#expect(expr)` |
| `XCTAssertEqual(a, b)` | `#expect(a == b)` |
| `XCTAssertNil(a)` | `#expect(a == nil)` |
| `XCTAssertNotNil(a)` | `#expect(a != nil)` |
| `try XCTUnwrap(a)` | `try #require(a)` |
| `XCTAssertThrowsError` | `#expect(throws: ErrorType.self) { }` |
| `XCTAssertNoThrow` | `#expect(throws: Never.self) { }` |

## Error Testing

```swift
#expect(throws: (any Error).self) { try riskyOperation() }
#expect(throws: NetworkError.self) { try fetch() }
#expect(throws: NetworkError.timeout) { try fetch() }
#expect(throws: Never.self) { try safeOperation() }
```

## Parameterized Tests

```swift
@Test("Validates inputs", arguments: zip(
    ["a", "b", "c"],
    [1, 2, 3]
))
func testInputs(input: String, expected: Int) {
    #expect(process(input) == expected)
}
```

**Warning:** Multiple collections WITHOUT zip creates Cartesian product.

## Async Testing

```swift
@Test func testAsync() async throws {
    let result = try await fetchData()
    #expect(!result.isEmpty)
}
```

### Confirmations

```swift
@Test func testCallback() async {
    await confirmation("callback received") { confirm in
        let sut = SomeType { confirm() }
        sut.triggerCallback()
    }
}
```

## Tags

```swift
extension Tag {
    @Tag static var fast: Self
    @Tag static var networking: Self
}

@Test(.tags(.fast, .networking))
func testNetworkCall() { }
```

## Common Pitfalls

1. **Overusing `#require`** — Use `#expect` for most checks
2. **Forgetting state isolation** — Each test gets a NEW instance
3. **Accidental Cartesian product** — Always use `zip` for paired inputs
4. **Not using `.serialized`** — Apply for thread-unsafe legacy tests

## Common Mistakes

1. **Overusing `#require`** — `#require` is for preconditions only. Using it for normal assertions means the test stops at first failure instead of reporting all failures. Use `#expect` for assertions, `#require` only when subsequent assertions depend on the value.

2. **Cartesian product bugs** — `@Test(arguments: [a, b], [c, d])` creates 4 combinations, not 2. Always use `zip` to pair arguments correctly: `arguments: zip([a, b], [c, d])`.

3. **Forgetting state isolation** — Swift Testing creates a new test instance per test method. BUT shared state between tests (static variables, singletons) still leak. Use dependency injection or clean up singletons between tests.

4. **Parallel test conflicts** — Swift Testing runs tests in parallel by default. Tests touching shared files, databases, or singletons will interfere. Use `.serialized` or isolation strategies.

5. **Not using `async` naturally** — Wrapping async operations in `Task { }` defeats the purpose. Use `async/await` directly in test function signature: `@Test func testAsync() async throws { }`.

6. **Confirmation misuse** — `confirmation` is for verifying callbacks were called. Using it for assertions is wrong. Use `#expect` for assertions, `confirmation` for callback counts.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — swift-testing от других авторов.

swift-testing dpearson2699 Пишет тесты на Swift Testing и переводит на них существующие проверки XCTest, подсказывая, что оставить в XCTest и XCUITest. CX Codex +1 4 700установок swift-testing Prisma-Labs-Dev Скилл подкладывает агенту локальную документацию по Swift Testing: @Test, @Suite, #expect, #require, параметризованные тесты и переезд с XCTest. CX Codex +1 746установок swift-testing-expert AvdLee Скилл swift-testing-expert помогает писать и разбирать тесты на Swift Testing: макросы #expect и #require, теги, параметризация, миграция с XCTest. CX Codex +1 5 700установок swift-testing-pro Paul Hudson Скилл swift-testing-pro для Claude Code, Codex, Cursor и других агентов: пишет, проверяет и правит тесты на Swift Testing по актуальным API Swift 6.2. Покрывает async-тесты, миграцию с XCTest и новые фичи фреймворка. CX Codex +1 10 900установок guide-swift-testing Prisma-Labs-Dev Скилл guide-swift-testing задаёт паттерны работы с фреймворком Swift Testing. Помогает писать и проверять тесты без ошибок в конкурентном коде. CX Codex +1 534установок cmux-testing manaflow-ai Скилл cmux-testing для выбора нужных проверок, добавления тестов и валидации Swift-целей в проекте cmux. Помогает решить, какие локальные и CI-доказательства нужны для изменения. CX Codex +1 5 100установок write-swift emilkowalski Скилл write-swift для Claude Code помогает писать и разбирать современный Swift. Включается при создании, ревью или миграции Swift-кода, а также при поиске ошибок конкурентности и проблем с памятью. CX Codex +1 169 400установок swift-concurrency AvdLee Скилл swift-concurrency для Claude Code разбирает ошибки Swift Concurrency и предлагает безопасные исправления. Он включается при миграции на Swift 6 и работе с задачами, акторами и Sendable. CX Codex +1 17 700установок

Из того же набора33

Весь набор →
sqlite-data Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit. CX Codex +1 ★ 233звёзд репо composable-architecture Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций. CX Codex +1 ★ 233звёзд репо modern-swift Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. CX Codex +1 ★ 233звёзд репо swiftui-patterns Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit. CX Codex +1 ★ 233звёзд репо tca-architect Субагент tca-architect проектирует архитектуру фич на The Composable Architecture: структуру State, таксономию Action, зависимости и навигацию. Работает в режиме read-only. CX Codex ★ 233звёзд репо swift-architect Субагент swift-architect планирует архитектуру новых фич на Swift, структуру файлов и слой хранения без изменения кода проекта. CX Codex ★ 233звёзд репо swift-search Субагент swift-search ищет определения и реализации в Swift-проекте, затем проверяет найденные места. Вызывайте его, когда ещё не знаете, в каком файле искать. CX Codex ★ 233звёзд репо swift-engineering Плагин swift-engineering для Claude Code включает субагентов и скиллы для планирования, разработки на Swift и TCA, тестирования и ревью iOS- и macOS-приложений. ★ 233звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой