guide-swift-testing について
モダンなテスト手法を取り入れるSwift開発者向けの、Swift Testing作成・レビューガイドです。テスト構成、非同期処理、新機能、移行を扱い、依頼がない限り既存のXCTestは置き換えません。
主な機能
- 01Swift Testing規約の確認
- 02テスト構成とアサーションの指針
- 03非同期テストとActor隔離の確認
- 04新機能の利用ガイド
- 05XCTest移行の指針
活用シーン
- 01Swift Testingスイートのレビュー
- 02非同期テストの確認
- 03アサーションと依存性注入の改善
- 04XCTest変換の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、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 のパターン
正確性、最新の API の使用、プロジェクト規約の遵守を目的として、Swift Testing のコードを記述およびレビューします。実際に問題がある場合のみ報告し、細かな点を過剰に指摘したり、問題をでっち上げたりしないでください。
基本的な指示
- 最新の Swift の並行処理を使用し、Swift 6.2 以降を対象にしてください。
- Swift Testing は UI テストをサポートしていません。UI テストでは XCTest を使用してください。
- 依頼されない限り、既存の XCTest を Swift Testing に書き換えないでください。
レビュープロセス
references/core-rules.mdを使用して、テストが基本的な規約に従っていることを確認します。references/writing-better-tests.mdを使用して、構造、アサーション、依存性注入、ベストプラクティスを検証します。references/async-tests.mdを使用して、非同期テスト、確認処理、制限時間、アクター分離、ネットワークのモックを確認します。references/new-features.mdを使用して、raw identifier、exit test、attachment などの新機能が正しく使用されていることを確認します。- XCTest から移行する場合は、
references/migrating-from-xctest.mdに従います。
部分的な作業を行う場合は、関連するリファレンスファイルのみを読み込んでください。
リファレンス
| トピック | リファレンス |
|---|---|
クラスより構造体、@Suite、並列実行、withKnownIssue、タグ | references/core-rules.md |
テストの衛生、構造、DI、#expect と #require の使い分け、Issue.record()、検証方法 | references/writing-better-tests.md |
直列化されたテスト、confirmation()、制限時間、アクター分離、ネットワークのモック | references/async-tests.md |
| Raw identifier、exit test、attachment、テストスコープの trait、範囲ベースの確認 | references/new-features.md |
| XCTest から Swift Testing への変換、アサーションの対応付け、浮動小数点の許容誤差 | references/migrating-from-xctest.md |
コメント
Markdown 対応