swiftui-wcag-accessibility-auditor

SwiftUI WCAG アクセシビリティ監査

概要

SwiftUI の iOS 機能を、次の 2 つのモードを組み合わせて監査します。

• WCAG に基づく網羅性と根拠（「何が失敗しているか／何が不確かか／その理由」）
• SwiftUI に適した、パッチを適用できる改善策（「最小限のコード変更で何を変更するか」）

コード監査として扱ってください。アプリは実行しないでください。ソースから結果を証明できない場合は、Needs user verification と記載し、具体的なユーザー向けの追加確認項目を記載してください。

このスキルと関連スキルの使い分け

次の両方が必要な場合は、この統合スキルを使用してください。

• WCAG 2.2 へのマッピング／トレーサビリティ
• SwiftUI に特化した修正／スニペット

次の場合は、ほかのスキルを優先してください。

• mobile-accessibility-audit：対象機能に UIKit が含まれる可能性がある場合、または標準を優先した監査のみが必要な場合
• swiftui-accessibility-auditor：WCAG のトレーサビリティを伴わない、迅速な SwiftUI のみのヒューリスティックレビューが必要な場合

読み込み順

1. コードのみの監査プロセス、ステータス、根拠に関する規則、および基本レポート形式について、references/ios-audit-workflow.md を読みます。
2. WCAG の成功基準の適用優先度とコード上のシグナルについて、references/ios-audit-checklist.md を読みます。
3. モバイル固有の適用可能性や基準のドラフト段階について解釈する際は、references/wcag2mobile-ios-reference.md を読みます。
4. references/ios-accessibility-api-examples.md を読みます。まず SwiftUI のセクションのみを確認します。
5. パッチ適用方針、対象外事項、優先度モデル、SwiftUI の修正パターンについて、references/swiftui-remediation-guide.md を読みます。
6. ユーザー向けの追加確認項目や最終的な手動検証リストを作成する場合に限り、references/swiftui-manual-checklist.md を使用します。

スコープに関する規則

• ネイティブ iOS の SwiftUI コードのみを監査します。
• UIViewRepresentable／UIViewControllerRepresentable ブリッジは、SwiftUI の機能に影響する範囲に限って監査します。
• 機能の中核となる動作が UIKit に委譲されている場合は、そのことを明記し、監査範囲を絞るか、mobile-accessibility-audit の使用を推奨してください。
• macOS、watchOS、Web、または SwiftUI 以外の実装に範囲を広げないでください。

監査の実施（統合ワークフロー）

1. 対象機能のフローと、対象に含める画面／状態を定義します。
2. 機能に関連する SwiftUI のエントリービューとサブビューを特定します。
3. WCAG チェックリスト（ios-audit-checklist.md）を実施し、ステータスとともに根拠を記録します。
4. SwiftUI API の例を使って、誤検知を避け、不足しているセマンティクスを特定します。
5. swiftui-remediation-guide.md を使って、パッチを適用できる修正案を作成します。
6. 次の内容を含む Markdown レポートを作成します。
   • 優先度を付けた指摘事項（P0、P1、P2）
   • 各指摘事項に対応する WCAG 成功基準のマッピング
   • 各指摘事項に埋め込んだ、パッチを適用できるスニペット
   • ユーザー向けの追加確認項目（コードから判断できない項目のみ）

出力形式（厳守、簡潔に）

簡潔に記述してください。次の構成を厳守してください。

規則：

• 指摘事項は、トップレベル見出し # Findings - P0、# Findings - P1、# Findings - P2 で優先度別にまとめます。
• 該当する指摘事項がない優先度グループは省略します。
• コードスニペットは、独立したスニペットセクションではなく、該当する指摘事項のセクションに記載します。
• ユーザーが明示的に求めない限り、WCAG 網羅性マトリックスは省略します。
• 曖昧さが監査に重大な影響を及ぼす場合に限り、# Scope / Assumptions を追加します。
• Needs user verification の項目がある場合に限り、# User Follow-Up Checks を追加します。

各指摘事項のテンプレート：

# Findings - P1

## 1. <Problem name>
- **What**: <problem description with code evidence>
- **Where**: <file path + line(s)>
- **Fix suggestion**: <suggested fix in words>
- **WCAG**: <SC # - Title (Level)>

```swift
// patch-ready snippet
```

注記：

• 有用な場合は、*What* の中に Confidence を含めます（例：Likely issue (confidence: medium)）。
• スニペットは最小限にし、引用したコードパスに直接適用できるものにします。
• 適切なコードスニペットがない場合は、*Fix suggestion* でその理由を説明します（まれなケースです）。

実用的な検索ガイダンス（SwiftUI を優先）

機能のコードパスから調査を始め、まず SwiftUI のシンボルを優先してください。

rg --files | rg '\\.(swift)$'
rg -n "struct .*View: View|body: some View|NavigationStack|sheet\\(|fullScreenCover\\(" .
rg -n "accessibility(Label|Hint|Value|Hidden)|accessibility(AddTraits|RemoveTraits)|accessibilityElement\\(|accessibilityFocused\\(" .
rg -n "@AccessibilityFocusState|onTapGesture|DragGesture|lineLimit\\(|minimumScaleFactor|dynamicTypeSize" .

次に、パターンの解釈には references/ios-accessibility-api-examples.md を参照してください。

リクエスト例

• Use $swiftui-wcag-accessibility-auditor to audit this SwiftUI checkout feature against WCAG 2.2 and return prioritized findings with patch-ready fixes in the strict finding format.
• Use $swiftui-wcag-accessibility-auditor to review this SwiftUI login + OTP flow for accessible authentication (3.3.8) and suggest minimal code changes.
• Use $swiftui-wcag-accessibility-auditor to audit this settings screen and produce user follow-up checks only for contrast, target size, and VoiceOver announcement timing.

リソース

• references/ios-audit-workflow.md：コードのみの監査プロセス、ステータス、エビデンスの品質に関するルール、レポートの構成。
• references/ios-audit-checklist.md：iOS WCAG チェックリストと SC 対応の優先事項。
• references/wcag2mobile-ios-reference.md：モバイル向けの解釈を整理したリファレンス（WCAG2Mobile／WCAG2ICT を iOS 監査向けに要約）。
• references/ios-accessibility-api-examples.md：SwiftUI と UIKit の API 例（このスキルでは、まず SwiftUI のセクションを使用してください）。
• references/swiftui-remediation-guide.md：SwiftUI の修正戦略、対象外事項、優先事項、修正パターン。
• references/swiftui-manual-checklist.md：フォローアップ確認用の簡潔なユーザー向け手動検証チェックリスト。