Communitygithub.com

relux-works/skill-ios-testing-tools

iOS/macOS 向け UI テストのための Swift パッケージおよびエージェントスキル:スクリーンショットキャプチャ、ページオブジェクトヘルパー、マルチピア E2E テスト調整。

skill-ios-testing-tools とは?

このスキルは、iOS および macOS アプリケーションの UI テストを支援するために設計された Swift パッケージおよびエージェントスキルです。スクリーンショットの自動キャプチャ、ページオブジェクトパターンを用いたテストコードの簡略化、複数デバイス間でのエンドツーエンド(E2E)テスト調整機能を提供します。主に XCUITest フレームワークと連携し、CI/CD パイプラインでのテスト自動化を効率化します。このスキルは、アプリの視覚的回帰テストや複雑なユーザーフローを検証する開発者にとって有益であり、コード生成やテスト実行の指示を AI エージェントに与えることで、手動でのテストコード記述を削減できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add relux-works/skill-ios-testing-tools

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

skill-ios-testing-tools は何をしますか?

iOS/macOS 向け UI テストのための Swift パッケージおよびエージェントスキル:スクリーンショットキャプチャ、ページオブジェクトヘルパー、マルチピア E2E テスト調整。

概要

このスキルは、iOS および macOS の UI テストを支援する Swift パッケージです。主な機能は以下の通りです。

  • スクリーンショットキャプチャ: テスト実行中に自動的にスクリーンショットを取得し、視覚的比較やレポート生成に利用します。
  • ページオブジェクトヘルパー: ページオブジェクトパターンを実装するためのヘルパー関数やプロトコルを提供し、テストコードの保守性を向上させます。
  • マルチピア E2E テスト調整: 複数の iOS デバイス間でテストを同期・調整する機能により、実際のユーザーシナリオに近い E2E テストが可能です。

対応プラットフォーム

  • iOS 13.0+
  • macOS 10.15+

インストール方法

Swift Package Manager

Package.swift に以下を追加してください。

dependencies: [
    .package(url: "https://github.com/relux-works/skill-ios-testing-tools.git", from: "1.0.0")
]

使用方法

スクリーンショットのキャプチャ

import XCTest
import SkilliOSTestingTools

class MyUITests: XCTestCase {
    func testScreenshotCapture() {
        let app = XCUIApplication()
        app.launch()

        // スクリーンショットを撮影
        let screenshot = app.screenshot()
        let attachment = XCTAttachment(screenshot: screenshot)
        attachment.lifetime = .keepAlways
        add(attachment)
    }
}

ページオブジェクトの使用

import SkilliOSTestingTools

class LoginPage: PageObject {
    let app: XCUIApplication

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

    var usernameField: XCUIElement {
        app.textFields["username"]
    }

    var passwordField: XCUIElement {
        app.secureTextFields["password"]
    }

    var loginButton: XCUIElement {
        app.buttons["login"]
    }

    func login(username: String, password: String) {
        usernameField.tap()
        usernameField.typeText(username)
        passwordField.tap()
        passwordField.typeText(password)
        loginButton.tap()
    }
}

マルチピアテストの調整

import SkilliOSTestingTools

class MultiPeerTest: XCTestCase {
    func testMultiDeviceCoordination() {
        let coordinator = MultiPeerCoordinator()
        coordinator.syncAllPeers()
        // テスト手順の同期
    }
}

貢献方法

バグ報告や機能リクエストは GitHub Issues までお願いします。プルリクエストも歓迎します。

ライセンス

MIT ライセンス

作者

relux-works

関連スキル