reviewing-a11y

日本語版 (Japanese)

アクセシビリティレビュー

ユーザーがレビューを希望する対象を特定し、対応するリファレンスガイドに従ってアクセシビリティレビューを実施します。

ステップ 1：レビュー対象の特定

ユーザーのリクエストを分析し、レビュー対象を判断します。

Web ページ（公開 URL）

判断の手がかり：

• ユーザーが http:// または https:// で始まる URL を提示している
• ユーザーが「このページをチェックして」「このサイトをレビューして」「この URL をテストして」と依頼している
• 公開中の Web サイトをレビューしたいと希望している

対応： ページレビューガイドに従います

コードの実装

判断の手がかり：

• ユーザーがファイルパス（.jsx、.tsx、.vue、.html、.js など）を提示している
• ユーザーが「このコンポーネントをレビューして」「自分のコードをチェックして」「この実装を見て」と依頼している
• コードベース内の特定のファイルやディレクトリについて言及している
• 静的コード解析について質問している

対応： コードレビューガイドに従います

デザインのモックアップ／仕様

判断の手がかり：

• ユーザーが Figma URL（figma.com/file/...）を提示している
• デザインの画像ファイル（.png、.jpg、.pdf）を共有している
• ユーザーが「このデザインをレビューして」「このモックアップをチェックして」「このワイヤーフレームを見て」と依頼している
• デザイン仕様や視覚的なアクセシビリティについて質問している

対応： デザインレビューガイドに従います

判断が曖昧な場合

不明確な場合は、ユーザーに質問します。

I can review accessibility for:
1. **Live web pages** (provide URL) - I'll test the rendered page
2. **Code implementation** (provide file paths) - I'll analyze the source code
3. **Design mockups** (provide Figma URL or images) - I'll review visual designs

Which would you like me to review?

ステップ 2：ナレッジベースで判定基準を確認する

対象を特定したら、コードやページを見る前に、a11y-knowledge に照らして確認事項を整理します。

1. 対象に含まれるコンポーネントを、ARIA ロール（button、dialog、combobox など）別に一覧にします。
2. index-by-component.md を使って、各ロールに適用される成功基準を探します。レイアウトまたはページ全体をレビューする場合は、index-by-criterion.md から「Whole page」と「Multiple pages」の基準も選びます。
3. 見つかった基準ごとに、指摘を記述する前に ../a11y-knowledge/references/criteria/<number>.md の「Judgment lines」と「When building」を読みます。「Judgment lines」に適用対象外と記載されている事項は報告しないでください。
4. 指摘の根拠が [Our interpretation] の判定基準（運用上の解釈）である場合は、その旨を指摘に記載します（例：「[Our interpretation] judgment line。プロジェクト側で上書きされている可能性があります」）。[Understanding] の判定基準には、この注記は不要です。

ナレッジベースは相対パス ../a11y-knowledge/ で参照します。プラグインとしてインストールした場合、このパスは解決されます。個別のスキルディレクトリをシンボリックリンクでインストールした場合は、a11y-knowledge もリンクしてください。解決できない場合は、このステップを省略し、レポートに「ナレッジベース未参照」と記載します。

ステップ 3：ガイドを読み、レビューを実施する

対象を特定したら、ユーザーの言語に対応するリファレンスガイドを読み、その手順に沿ってレビューを実施します。

Web ページの場合

Read the page review guide:
- English: references/page-review.md
- Japanese: references/page-review.ja.md

Follow the guide using available browser interaction, web retrieval, or user-provided content.

コードの場合

Read the code review guide:
- English: references/code-review.md
- Japanese: references/code-review.ja.md

Follow the guide by inspecting the target files and related implementation.

デザインの場合

Read the design review guide:
- English: references/design-review.md
- Japanese: references/design-review.ja.md

Follow the guide using available image, document, or Figma retrieval capabilities.

サブエージェントを使用する場合

• ユーザーが並行レビュー、専門家への委任、または複数対象への分担を明示的に依頼した場合に限り、サブエージェントを使用します。
• 各エージェントには対象の種類を 1 つ割り当て、該当するガイドと対象を提示します。
• すべての結果を待ち、重複を取り除いて、統合したレポートを 1 つ返します。
• サブエージェントを利用できない場合は、このエージェントが対象を順番にレビューします。

ステップ 4：結果を返す

レビューが完了したら、次のようにします。

1. 指摘事項をユーザーに提示します
2. 必要に応じて、追加の対象もレビューできることを伝えます
3. 次のステップを提案します（例：「次はコードの実装をレビューしましょうか？」）

重要事項

• レビューを始める前に、必ず適切なガイドを読むこと
• ユーザーの言語に基づいて、英語または日本語を選ぶこと
• 確認できた根拠と確認できていない点を区別し、検証できなかった内容を明記すること
• レビューの種類を混在させないこと。対象の種類ごとに 1 つのガイドを使用します

ワークフローの例

例 1：ユーザーが URL を提示した場合

User: "Review https://example.com for accessibility"

1. Identify: This is a web page (URL provided)
2. Look up: find the criteria in index-by-component and read "Judgment lines" and "When building"
3. Read: references/page-review.md
4. Execute: Inspect the page by following the guide
5. Return: Present findings

例 2：ユーザーがファイルパスを提示した場合

User: "Check src/components/Button.tsx for a11y issues"

1. Identify: This is code (file path provided)
2. Look up: find the criteria in index-by-component and read "Judgment lines" and "When building"
3. Read: references/code-review.md
4. Execute: Inspect the target and related code by following the guide
5. Return: Present findings

例 3：ユーザーが Figma URL を提供する

User: "Review this design: https://figma.com/file/abc123"

1. Identify: This is a design (Figma URL)
2. Look up: find the criteria in index-by-component and read "Judgment lines" and "When building"
3. Read: references/design-review.md
4. Execute: Inspect the design by following the guide
5. Return: Present findings

WCAG および規格の参照

すべてのレビューで、以下を参照してください。

• WCAG 2.2: https://www.w3.org/TR/WCAG22/
• WAI-ARIA APG: https://www.w3.org/WAI/ARIA/apg/
• WCAG クイックリファレンス: https://www.w3.org/WAI/WCAG22/quickref/

参照する主な達成基準：

• 1.1.1 非テキストコンテンツ（A）
• 1.3.1 情報および関係性（A）
• 1.4.3 コントラスト（最低限）（AA）
• 2.1.1 キーボード（A）
• 2.4.6 見出しおよびラベル（AA）
• 4.1.2 名前、役割、値（A）

証拠がない項目を決定的な指摘にしないでください。裏付けのないチェック項目は、手動での確認が必要な項目として記載してください。