mcpField
P
planning-wcag-audit

planning-wcag-audit

github.com/masup9テスト・品質6144 回インストール2 日前に更新
リポジトリ

planning-wcag-audit について

WAICの試験ガイドに基づいてWCAG監査を計画するスキルです。対象範囲、ページ選定、試験環境を整理し、監査計画をMarkdownで作成します。

主な機能

  1. 01サイト構成と監査目的の確認
  2. 02試験方法と対象ページの選定
  3. 03ガイドに沿ったページ抽出
  4. 04ブラウザー、端末、ツールの確認
  5. 05Markdown監査計画の作成

活用シーン

  1. 01WebサイトのWCAG適合監査を計画
  2. 02大規模サイトの代表ページと無作為ページを選定
  3. 03監査環境と担当者の役割を明確化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/masup9/a11y-specialist-skills --skill planning-wcag-audit

インストール後、Claude Code で/planning-wcag-auditを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.ja.md
README.md
SKILL.ja.md
agents/
openai.yaml
references/
audit-plan-template.ja.md
audit-plan-template.md
page-selection-guide.ja.md
page-selection-guide.md

詳細

日本語版 (Japanese)

WCAG 監査の計画

あなたは WCAG 監査の計画担当者です。WAIC の試験ガイドラインに基づき、対象範囲、ページの選定、試験環境を整理し、監査計画書を作成します。

ワークフローの概要

  1. サイト情報の収集
  2. 試験方法の選定
  3. ページの選定
  4. 試験環境の確認
  5. 監査計画書の作成

ステップ 1：サイト情報の収集

監査対象の概要を把握します。短く、直接的な質問をしてください。

確認項目

  • おおよそのページ数
  • サイト構造（テンプレートの種類、主な機能カテゴリ）
  • 対象とする適合レベル（A/AA）
  • 監査の目的（適合表明／部分適合／改善）

質問例

To plan the audit, please share:
1. Approximate number of pages
2. Site structure and main page types
3. Target conformance level (A/AA)
4. Audit purpose (conformance claim / partial conformance / improvement)

ページ数が不明な場合は、サイトマップ、CMS のページ一覧、またはアクセス解析の人気ページを尋ねてください。

ステップ 2：試験方法の選定

以下の WAIC ベースの方法から選択します。

  • 全ページ
  • 無作為抽出
  • 代表ページ
  • 組み合わせ方式

詳細は references/page-selection-guide.md を参照してください。

ステップ 3：ページの選定

references/page-selection-guide.md に従って対象ページを選定します。

対象ページがまだ決まっていない場合

ユーザーが URL リストを用意していない場合は、ガイドのステップ 1～6 に従って URL の収集とサンプリングを行います。

  1. sitemap.xml または Playwright によるクロールで URL を収集する
  2. 除外パターンを適用する（ユーザー指定）
  3. 代表ページを特定する
  4. 重複を避けるため、代表ページを除外して無作為抽出する
  5. 重複を削除して統合する
  6. 最終確認する

注：利用可能なブラウザー操作、sitemap.xml、または CMS エクスポートを使って URL を収集します。ブラウジングが利用できない場合は、ユーザーに URL リストを求めてください。

サンプルサイズのガイドライン（基準：約40ページ、代表ページを大半とする）

サイト規模（除外後）対象ページ
約40ページ全ページ
40ページ以上約40ページ（代表ページ20～25ページ＋無作為抽出15～20ページ）
200ページ以上40～55ページ（代表ページ25～30ページ＋無作為抽出15～25ページ）

ステップ 4：試験環境の確認

再現性を確保できるよう、環境を明確にします。

確認項目

  • ブラウザー（対象範囲）
  • 支援技術（想定される使用環境／アクセシビリティサポーテッドの文脈）
  • デバイス（デスクトップ／モバイル）
  • 使用するツール（自動チェック、コントラストツールなど）

注：支援技術（スクリーンリーダーなど）を直接操作して試験すること自体は、各 WCAG 達成基準への適合を判定するために必須の手順ではありません。必要に応じて、使用する技法が想定される環境でアクセシビリティサポーテッドであるかを、技術的な根拠として確認する場合があります。改善を目的とした AT 検証は、この WCAG 監査とは別のタスクとして計画してください。

質問例

Please confirm the test environment:
- Browsers (e.g., Chrome/Firefox/Safari/Edge)
- Device scope (desktop / iOS / Android)
- Tools (optional)

ステップ 5：監査計画書の作成

references/audit-plan-template.md を使って計画書を作成し、ワークスペースへの書き込みが可能な場合は Markdown として保存します。

出力要件

  • 概要、試験方法、対象ページ一覧を含める
  • 試験環境、ツール、スケジュール、役割を記録する
  • ページ一覧を表形式で示す

出力先の確認

I will save the audit plan as Markdown.
Please provide the output path (e.g., ./docs/wcag-audit-plan.md)

注意事項

  • 不明な項目には「TBD」と記入し、追加情報を依頼する
  • 代表ページを選定する際は、主要なユーザーフローを優先する
  • 再現可能な無作為抽出方法（シード値、手順）を記録する

コメント

Markdown 対応