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

xcuitest-skill — скилл для Claude Code: тесты iOS в Swift

Генерирует UI-тесты на XCUITest для iOS и iPadOS приложений. Работает с локальными симуляторами Xcode и облачными устройствами TestMu AI — выбирает целевую платформу автоматически.

MIT 248 установок ★ 393 обновлён 2026-10-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-code
Открыть на GitHub

Что делает xcuitest-skill

Скилл помогает писать тесты на Swift с использованием Apple's XCUITest — встроенного фреймворка для UI-автоматизации на iOS. Внутри готовые паттерны: запуск приложения, поиск элементов по accessibility identifier, тапы и свайпы, проверки существования элементов, обработка системных алертов. Есть примеры Page Object паттерна для чистого кода и anti-pattern таблица (спит вместо ожидания, жёсткие координаты вместо accessibility ID).

Скилл определяет контекст выполнения: если упомянуть «TestMu», «LambdaTest», «cloud», он генерирует код для загрузки .ipa и test runner, управления реальными устройствами через API. Если говорить про «simulator», «Xcode», «local» — пишет команды для локального запуска через Test Navigator или xcodebuild. По умолчанию работает с локальным симулятором.

Поддерживает Swift и Objective-C, интегрируется со всеми упомянутыми платформами AI-кодинга. Требует установленный Xcode и понимание структуры iOS проекта.

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

  • Написать UI-тесты для экранов авторизации и навигации на iOS
  • Настроить работу с облачной фермой реальных устройств TestMu
  • Проверить поведение приложения при разных состояниях (инвалидные данные, таймауты)
  • Организовать тесты по Page Object паттерну
  • Запустить тесты через xcodebuild в CI/CD пайпе

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

  • Напиши XCUITest для логина с проверкой валидных и невалидных учётных данных
  • Сгенерируй тесты на облачных iOS устройствах TestMu для приложения MyApp.ipa
  • Напиши тест, который тапает кнопку, ждёт экрана дашборда и проверяет текст приветствия

Как установить xcuitest-skill

1Через Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-code

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

~/.claude/skills/xcuitest-skill/SKILL.md

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

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

Вопросы о xcuitest-skill

Как установить xcuitest-skill в Claude Code?

Выполни команду npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-code, затем открой файл ~/.claude/skills/xcuitest-skill/SKILL.md для проверки установки.

Что делает xcuitest-skill?

Генерирует готовые UI-тесты на XCUITest для iOS-приложений: примеры авторизации, поиска элементов, действий (тапы, свайпы), проверок. Автоматически выбирает контекст — локальный симулятор или облачные устройства TestMu.

Какая разница между локальным тестированием и TestMu cloud?

Локально тесты запускаются в симуляторе Xcode на машине разработчика (команда xcodebuild). На TestMu тесты загружают .ipa и test runner на реальные физические устройства, доступные через API. Выбор зависит от упоминания «cloud» или «TestMu» в запросе.

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

SKILL.md · MIT
---
name: xcuitest-skill
description: >
  Generates XCUITest UI tests for iOS/iPadOS apps in Swift. Apple's native
  testing framework for reliable, fast UI automation. Supports local simulators
  and TestMu AI cloud real devices. Use when user mentions "XCUITest", "XCTest",
  "iOS UI test", "Swift test", "XCUIApplication". Triggers on: "XCUITest",
  "XCTest UI", "iOS UI test", "Swift UI test", "XCUIApplication", "TestMu".
languages:
  - Swift
  - Objective-C
category: mobile-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# XCUITest Automation Skill

You are a senior iOS QA engineer specializing in XCUITest.

## Step 1 — Execution Target

```
├─ Mentions "cloud", "TestMu", "LambdaTest", "device farm"?
│  └─ TestMu AI cloud (upload IPA + test runner)
│
├─ Mentions "simulator", "local", "Xcode"?
│  └─ Local: Xcode Test Navigator or xcodebuild
│
└─ Default → Local simulator
```

## Core Patterns — Swift

### Basic Test

```swift
import XCTest

class LoginTests: XCTestCase {
    let app = XCUIApplication()

    override func setUpWithError() throws {
        continueAfterFailure = false
        app.launch()
    }

    func testLoginWithValidCredentials() {
        let emailField = app.textFields["emailInput"]
        XCTAssertTrue(emailField.waitForExistence(timeout: 5))
        emailField.tap()
        emailField.typeText("[email protected]")

        let passwordField = app.secureTextFields["passwordInput"]
        passwordField.tap()
        passwordField.typeText("password123")

        app.buttons["loginButton"].tap()

        let dashboard = app.staticTexts["Welcome"]
        XCTAssertTrue(dashboard.waitForExistence(timeout: 10))
    }

    func testLoginWithInvalidCredentials() {
        app.textFields["emailInput"].tap()
        app.textFields["emailInput"].typeText("[email protected]")
        app.secureTextFields["passwordInput"].tap()
        app.secureTextFields["passwordInput"].typeText("wrong")
        app.buttons["loginButton"].tap()

        let error = app.staticTexts["Invalid credentials"]
        XCTAssertTrue(error.waitForExistence(timeout: 5))
    }
}
```

### Element Queries

```swift
// By accessibility identifier (best)
app.buttons["loginButton"]
app.textFields["emailInput"]

// By label text
app.staticTexts["Welcome back"]
app.buttons["Submit"]

// By predicate
app.buttons.matching(NSPredicate(format: "label CONTAINS 'Login'")).firstMatch

// By index
app.cells.element(boundBy: 0)

// Existence check
let element = app.buttons["submit"]
XCTAssertTrue(element.waitForExistence(timeout: 10))
```

### Actions

```swift
element.tap()                           // Tap
element.doubleTap()                     // Double tap
element.press(forDuration: 2)           // Long press
element.typeText("hello")              // Type (field must be focused)
element.swipeUp()                       // Swipe
element.swipeDown()
element.swipeLeft()
element.swipeRight()
element.pinch(withScale: 2, velocity: 1)  // Zoom in
element.rotate(CGFloat.pi, withVelocity: 1) // Rotate
```

### Assertions

```swift
XCTAssertTrue(element.exists)
XCTAssertTrue(element.isHittable)
XCTAssertTrue(element.isEnabled)
XCTAssertEqual(element.label, "Expected Label")
XCTAssertEqual(element.value as? String, "Expected Value")
XCTAssertTrue(element.waitForExistence(timeout: 10))
```

### Handling System Alerts

```swift
// Auto-handle permission dialogs
addUIInterruptionMonitor(withDescription: "Permission Alert") { alert in
    if alert.buttons["Allow"].exists {
        alert.buttons["Allow"].tap()
        return true
    }
    return false
}
app.tap() // Trigger the monitor
```

### Page Object Pattern

```swift
protocol Page {
    var app: XCUIApplication { get }
}

class LoginPage: Page {
    let app: XCUIApplication

    init(app: XCUIApplication) { self.app = app }

    var emailField: XCUIElement { app.textFields["emailInput"] }
    var passwordField: XCUIElement { app.secureTextFields["passwordInput"] }
    var loginButton: XCUIElement { app.buttons["loginButton"] }
    var errorLabel: XCUIElement { app.staticTexts["errorMessage"] }

    func login(email: String, password: String) -> DashboardPage {
        emailField.tap()
        emailField.typeText(email)
        passwordField.tap()
        passwordField.typeText(password)
        loginButton.tap()
        return DashboardPage(app: app)
    }
}
```

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| `sleep(5)` | `waitForExistence(timeout:)` | Unreliable |
| Element queries without wait | Always `waitForExistence` first | Race conditions |
| Hard-coded tap coordinates | Accessibility identifiers | Screen sizes vary |
| Testing in one massive method | Small focused test methods | Better isolation |

### TestMu AI Cloud

```bash
# 1. Create .ipa from Xcode: Product → Archive → Distribute → Ad Hoc
# 2. Upload app and test runner
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "[email protected]" -F "type=ios"

curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
  -F "[email protected]" -F "type=ios"

# 3. Execute on real devices
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
  -X POST "https://mobile-api.lambdatest.com/framework/v1/xcui/build" \
  -H "Content-Type: application/json" \
  -d '{
    "app": "lt://APP123",
    "testSuite": "lt://TEST456",
    "device": ["iPhone 16-18", "iPhone 15 Pro-17"],
    "build": "XCUITest Cloud Build",
    "video": true, "deviceLog": true
  }'
```

## Quick Reference

| Task | Command |
|------|---------|
| Run from Xcode | ⌘U or Product → Test |
| Run from CLI | `xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16'` |
| Run specific test | `xcodebuild test -only-testing:MyAppUITests/LoginTests/testLogin` |
| Screenshots | `let screenshot = XCUIScreen.main.screenshot()` |
| Attachments | `let attachment = XCTAttachment(screenshot: screenshot)` |
| Launch args | `app.launchArguments = ["--uitesting"]` |
| Launch env | `app.launchEnvironment = ["ENV": "test"]` |

## Deep Patterns

For advanced patterns, debugging guides, CI/CD integration, and best practices,
see `reference/playbook.md`.

© TestMu AI · MIT · LambdaTest/agent-skills

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

Все скиллы по теме «Тесты и QA» →
Mobile Device MCP srmorete MCP-сервер Mobile Device MCP даёт агенту руки на телефоне: тапы, скролл, ввод текста, скриншоты и чтение дерева UI сразу на нескольких устройствах. CX Codex +1 ★ 54звёзд репо ascript-mcp ascript-cn MCP-сервер ascript-mcp связывает AI-ассистентов с мобильными устройствами на Android и iOS. Помогает проверять интерфейс, тестировать селекторы и запускать скрипты автоматизации. CX Codex +1 ★ 11звёзд репо modernize-tests tartinerlabs Скилл modernize-tests для Claude Code переносит тесты XCTest и XCUIAutomation на Swift Testing и обновляет существующие тесты. Включается при работе с этими фреймворками и кодом @Test, @Suite, #expect или #require. CX Codex +1 340установок ios-simulator-skill conorluddy Скилл ios-simulator-skill для Claude Code с 31 скриптом для сборки, тестирования и управления iOS-приложениями в Simulator через доступность элементов вместо координат пикселей. CX Codex +1 2 500установок argent-settings-permissions software-mansion Скилл argent-settings-permissions выдаёт, отзывает и сбрасывает системные разрешения в симуляторе iOS и на Android без открытия экрана настроек. Настраивает доступы перед автотестами до старта приложения. CX Codex +1 25 300установок argent-ios-device-interact software-mansion Скилл argent-ios-device-interact для Claude Code управляет физическим iPhone через argent. Включается при работе с настоящим устройством со статусом device и запрещён для симуляторов iOS. CX Codex +1 17 100установок

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

Весь набор →
cypress-skill Генерирует production-grade E2E и component-тесты на JavaScript или TypeScript. Работает локально и в облаке TestMu AI, понимает команды Cypress и сразу пишет тесты с правильными селекторами и перехватом сети. CX Codex +1 264установок robot-framework-skill Скилл robot-framework-skill для Claude Code пишет .robot-тесты на Python в keyword-driven синтаксисе: браузерные — на SeleniumLibrary, API — на RequestsLibrary. Превращает описанный словами сценарий в тест. CX Codex +1 253установок detox-skill Генерирует E2E-тесты Detox для приложений на React Native на JavaScript и TypeScript. Помогает писать сценарии для эмуляторов и облака TestMu AI. CX Codex +1 252установок hyperexecute-skill Скилл настраивает запуск тестов через HyperExecute: создаёт YAML, проверяет конфигурацию, запускает задания и помогает разбирать сбои. CX Codex +1 250установок puppeteer-skill Генерирует Puppeteer-скрипты для браузерной автоматизации, скрейпинга и PDF. Срабатывает на упоминание Puppeteer, headless Chrome, page.goto, scrape. CX Codex +1 247установок testng-skill Генерирует Java-тесты для TestNG с группами, наборами данных и параллельным запуском. Настраивает тестовые suite и слушателей. CX Codex +1 243установок codeception-skill Генерирует приёмочные, функциональные и модульные BDD-тесты Codeception на PHP. Автоматизирует тестирование пользовательских сценариев и веб-страниц. CX Codex +1 243установок flutter-testing-skill Скилл flutter-testing-skill генерирует виджет-тесты, интеграционные тесты и golden-тесты для Flutter на Dart. Запускает локально или на реальных устройствах через TestMu AI облако. CX Codex +1 242установок

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

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