swift-gui-verifiable-loop-skill は何をしますか？
SwiftUI GUIの変更に対して、macOS（AppKit）およびiOS（UIKit）上で、決定論的でエージェントフレンドリーなクローズドループを作成・実行するスキルです。xcodebuild + .xcresult証跡 + xcresulttool抽出、スナップショットテスト、アクセシビリティ監査、小規模なXCUITestスモークフローを使用します。
概要
このスキルは、AIエージェントがSwiftUI GUIの変更を自動的に検証できるように設計されています。ビルド、テスト実行、結果抽出、スナップショット比較、アクセシビリティチェック、XCUITest実行を1つのループに統合します。
前提条件
- macOS または iOS 開発環境
- Xcode 13 以上
- Swift 5.5 以上
- 対象プロジェクトのルートディレクトリにアクセス可能であること
使用方法
- プロジェクトのルートディレクトリで、以下のコマンドを実行してスキルを呼び出します：
skill run zhutao100/swift-gui-verifiable-loop-skill --target <ターゲット> --scheme <スキーム>
-
スキルは自動的に以下の手順を実行します：
xcodebuild testを実行して単体テストとUIテストをビルド・実行.xcresultファイルからxcresulttoolを使用してテスト結果を抽出- スナップショットテストを実行（
SnapshotTestingライブラリを使用） - アクセシビリティ監査を実行（
XCTAssertNoAccessibilityIssuesを使用） - 小規模なXCUITestスモークフローを実行
-
結果はコンソールに出力され、
.xcresultファイルとして保存されます。
環境変数
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
TARGET | テスト対象のビルドターゲット | 必須 |
SCHEME | 使用するXcodeスキーム | 必須 |
DESTINATION | テスト実行先（シミュレータ等） | platform=macOS または platform=iOS Simulator |
出力
- テスト結果：
.xcresultディレクトリ - スナップショットテスト：
__Snapshots__ディレクトリ - アクセシビリティ監査結果：コンソールログ
- XCUITest結果：コンソールログと
.xcresult
サポート
問題が発生した場合は、リポジトリの Issue を作成するか、メンテナーに連絡してください。