swiftui-wcag-accessibility-auditor

swiftui-wcag-accessibility-auditor の概要

この skill でできること

swiftui-wcag-accessibility-auditor は、SwiftUI の iOS 機能コードを対象に、WCAG 2.2 の Level A/AA と WCAG2Mobile の解釈に照らしてアクセシビリティ監査を行い、修正しやすいパッチ前提の形で、優先度付きの簡潔なフィードバックを返す skill です。実行時テストではなくソースレビュー向けに設計されているため、障害になりそうな箇所を見つけ、根拠を追跡し、推測ではなくユーザー確認が必要な点を明確にできます。

どんな人に向いているか

swiftui-wcag-accessibility-auditor skill は、認証、フォーム、設定、一覧、カスタムコントロール、モーダルフローのような画面で SwiftUI のアクセシビリティ確認を行いたいときに使います。マージ前の UX 監査、修正計画の作成、アプリコードのアクセシビリティ退行チェックを行うチームに特に向いています。

何が違うのか

一般的なプロンプトと違い、この skill は WCAG の追跡可能性と SwiftUI 固有の修正方法を中心に据えています。何が問題かだけでなく、最小限のコード変更で何を直すべきか、またどの指摘がソースから証明できてどれが手動確認を要するのかまで把握したい場面でとくに有効です。

swiftui-wcag-accessibility-auditor skill の使い方

インストールと読み込み順

swiftui-wcag-accessibility-auditor install を使う場合は、リポジトリのインストールコマンド npx skills add ramzesenok/iOS-Accessibility-Audit-Skill --skill swiftui-wcag-accessibility-auditor を実行します。インストール後は、まず references/ios-audit-workflow.md を読み、その次に references/ios-audit-checklist.md、さらに references/wcag2mobile-ios-reference.md を読んで、監査の判断基準となる標準の前提を押さえてください。

どんな入力が最も効果的か

swiftui-wcag-accessibility-auditor usage のパターンは、対象を絞った機能、画面の経路、そして確認したいコード片を渡すと最もよく機能します。たとえば、「AuthView.swift と関連ビューにある SwiftUI のサインインフローを WCAG 2.2 A/AA の観点で監査し、P0/P1/P2 の修正案を返し、コードだけでは証明できないものは Needs user verification として扱ってください」のように指定します。カスタムコントロール、エラー状態、ナビゲーションなど、この skill にたどらせたい要素も含めてください。

おすすめの進め方

実用的な swiftui-wcag-accessibility-auditor guide は、まず機能フローを定義し、次に入口ビューと下流の状態を確認し、セマンティックなフックとリスクの高いパターンを特定してから、指摘をステータスと修正優先度にマッピングする流れです。コードだけでは VoiceOver の読み上げ、フォーカス順、視覚的コントラストのような振る舞いが証明できない場合は、合格と断定せず、対象を絞ったユーザー確認を依頼するべきです。

まず読むべきファイル

最初に SKILL.md を読み、続けて references/ios-audit-workflow.md、references/ios-audit-checklist.md、references/swiftui-remediation-guide.md、references/swiftui-manual-checklist.md、references/ios-accessibility-api-examples.md を確認してください。この順番にすると、修正を依頼する前に監査ルールを理解できるため、指摘の質とパッチの質の両方が上がります。

swiftui-wcag-accessibility-auditor skill のFAQ

SwiftUI 専用ですか？

はい、swiftui-wcag-accessibility-auditor skill はネイティブな SwiftUI の iOS 機能を前提に作られています。機能に UIKit、混在実装、プラットフォームブリッジの独自実装が含まれる場合でもある程度は役立ちますが、そのぶん確実性は下がり、ユーザー確認の比重が増えると考えてください。

通常のプロンプトと何が違いますか？

通常のプロンプトでも一般的なアクセシビリティ助言は出せます。この skill はそれよりも判断志向で、コードのみを対象とした監査ワークフローに従い、WCAG 2.2 と WCAG2Mobile の枠組みを使い、根拠付きのステータスと最小限の SwiftUI パッチを優先します。そのため、追跡可能性と変更範囲が重要な UX Audit 作業に向いています。

初心者でも使えますか？

はい、画面や機能を指し示せるなら使えます。すべての WCAG 規定を知っている必要はありませんが、skill が適切なフローを特定できる程度の文脈は必要です。入力が具体的であるほど、話を広げすぎるリスクは下がります。

使わないほうがいいのはどんなときですか？

ライブのシミュレーターテスト、視覚 QA、あるいは SwiftUI 中心ではない広範なモバイルアクセシビリティレビューを求めているなら使わないでください。また、WCAG の追跡可能性を重視せず、手早いヒューリスティックな意見だけが欲しい場合にも向いていません。その場合は、より軽量な SwiftUI レビュー系の skill のほうが適しています。

swiftui-wcag-accessibility-auditor skill の改善方法

対象範囲をもっと狭くする

swiftui-wcag-accessibility-auditor usage の入力として最も強いのは、1 つのフロー、1〜2 個のファイル、1 つの成果物を指定する形です。たとえば「アプリ全体を監査する」より、「パスワードリセット画面とそのエラー状態を確認する」のほうが適切です。範囲を絞ることで、本当に問題のあるブロッカーと、価値の低い観察結果を切り分けやすくなります。

難しいケースは最初に伝える

画面がアイコンのみのボタン、カスタムジェスチャー、オーバーレイ、シート、バリデーションバナー、Dynamic Type に敏感なレイアウト、キーボード操作のフォームを使っているなら、最初に伝えてください。これらは swiftui-wcag-accessibility-auditor for UX Audit が最も意味のある指摘を出しやすい領域であり、文脈不足によって品質が最も落ちやすい部分でもあります。

根拠と最小修正を求める

コード根拠、WCAG への対応づけ、最小限の修正スニペットを含めるよう依頼してください。そうすることで、skill は抽象的な助言ではなく、すぐパッチに落とせる出力へ寄りやすくなります。次の段階が必要なら、未解決の Needs user verification 項目か、優先度の高い P0 と P1 の問題に絞って再確認を依頼してください。

監査からパッチへ反復する

最初の結果をもとに、採用した指摘をフィードバックし、残っているコードについて 2 回目の精査を依頼してください。結果の質を上げる最短ルートはこれです。skill は修正提案をより正確にし、誤検知を減らし、不確かな領域を広い推奨ではなく具体的な手動確認に変えられます。