はじめに
iOS アプリを、IDE としての Xcode をできるだけ使わずに、Claude Code とコマンドラインツールだけで開発することに挑戦中です。
iOS アプリのテストはxcodebuild testコマンドで実行するのですが、Claude Code がテスト実行後の結果確認に困っているようだったので、xcrun xcresulttoolを使用するスキルを作ってみました。
※Claude Code スキルは、2025 年 10 月に公開されました。専門知識を“発見可能な機能”としてパッケージ化したもので、Claude Code のモデルから自律的に呼び出されるものです。
課題:Claude Code がテスト結果の確認に苦戦する
xcodebuild testを実行すると、テストの実行結果は.xcresultバンドル(フォルダ)として保存されます。このバンドルの中には大量のバイナリファイルが生成されるため、直接ファイルを参照して結果を確認するのは現実的ではありません。
通常、Xcode を使っていれば GUI でテスト結果を確認できますが、Claude Code とコマンドラインだけで開発していると以下のような問題がありました:
-
Claude Code がテスト結果を確認するために再度
xcodebuild testを実行してしまう- テストの再実行には時間がかかるため、開発効率が低下する
- すでに存在する
.xcresultバンドルを活用すれば、再実行は不要
-
xcresulttoolコマンドを手動で実行して結果を Claude Code に渡すのは手間と時間がかかる
そこで、これらの作業を Claude Code が自動的に実行してくれるスキルを作成しました。
review-ios-test-resultsスキルの概要
このスキルは、iOS プロジェクトのテスト結果を自動的に分析し、失敗したテストの詳細情報を提供します。
主な機能
-
xcodebuild test実行後の.xcresultバンドルを自動検索 - テスト実行結果の統計情報(成功/失敗/スキップ数)を表示
- 失敗したテストの詳細情報とエラーメッセージを抽出
- ソースコードの該当箇所(
file:line形式)を特定 - 失敗パターンに基づいた次のアクションを提案
いつ起動されるか
Claude Code は、以下のような状況で自動的にこのスキルを起動します:
-
xcodebuild testやswift testを実行した直後 - テストが失敗して、原因を調査する必要がある時
- ユーザーが「テスト結果を確認して」「失敗したテストを見て」などと発言した時
使い方
インストール
以下のコマンドでスキルをインストールできます。
プロジェクトスコープ(特定のプロジェクトでのみ使用):
mkdir -p .claude/skills/review-ios-test-results
curl -o .claude/skills/review-ios-test-results/SKILL.md \
https://raw.githubusercontent.com/ddpi/PublicArticles/main/claude_code/skills/review-ios-test-results/SKILL.md
グローバルスコープ(すべてのプロジェクトで使用):
mkdir -p ~/.claude/skills/review-ios-test-results
curl -o ~/.claude/skills/review-ios-test-results/SKILL.md \
https://raw.githubusercontent.com/ddpi/PublicArticles/main/claude_code/skills/review-ios-test-results/SKILL.md
インストール後、Claude Code を再起動してスキルを認識させてください。
詳細なインストール手順やプレースホルダの設定については、GitHub の README.mdをご覧ください。
基本的な使用例
(1) 別ターミナルでテストを実行 または、 Claude Code が自律的にテストを実行
xcodebuild test -scheme YourScheme
(2) Claude Code に結果を確認してもらう:
テスト実行後、Claude Code が自律的に結果を確認することが多いですが、やってくれない場合は、以下のように確認を促します。
テスト結果を確認して
あるいは、より明示的に
review-ios-test-resultsスキルを使って、テスト結果を確認して
Claude Code が自動的に以下の作業を実行します:
- 最新の
.xcresultバンドルを検索 -
xcrun xcresulttoolを使用してテスト結果を抽出 - 統計情報と失敗したテストの詳細を日本語で報告
- 次に取るべきアクションを提案
実行例
例えば、以下のような出力が得られます:
テスト結果を確認しました。
テスト結果の統計:
- 合計: 25件
- 成功: 23件
- 失敗: 2件
- スキップ: 0件
失敗したテスト:
1. UserManagerTests.testUserValidation
エラー: XCTAssertEqual failed: ("invalid") is not equal to ("valid")
場所: UserManagerTests.swift:42
2. NetworkTests.testAPIConnection
エラー: XCTAssertNotNil failed
場所: NetworkTests.swift:78
... (修正についてのClaude Codeからのコメント、提案が続きます)
スキルの設計思想
このスキルは、Claude Code のスキル仕様に基づいて設計されています。
具体的には:
- 明確なトリガー条件:いつスキルを起動すべきかを明示
-
最小限の権限:
BashとReadのみを許可し、安全性を確保 - 実行可能なコード例:スキル本文に具体的なコマンドを含める
- 期待される出力形式:構造化された結果を日本語で提供
設計の詳細やベストプラクティスの適用については、GitHub の README.mdで詳しく解説しています。
まとめ
review-ios-test-resultsスキルを使うことで、iOS アプリのテスト結果確認が大幅に効率化されました。
- テスト失敗時に手動で
.xcresultバンドルを探す必要がなくなった - 失敗したテストの詳細情報が構造化されて提供される
- 次に取るべきアクションが明確になる
Claude Code とコマンドラインツールだけで iOS 開発を進める際に、ぜひ活用してみてください。
スキルファイルと詳細なドキュメントは、GitHub で公開しています:
https://github.com/ddpi/PublicArticles/tree/main/claude_code/skills/review-ios-test-results