mcpField
C
cli-audit

cli-audit

github.com/mgiffordテスト・品質5793 回インストール6 週間前に更新
リポジトリ

cli-audit について

cli-auditは、Claude CLIでライブURLを監査し、リポジトリの指針に沿って結果を評価するアクセシビリティ監査スキルです。axeのデータとアクセシビリティツリーの根拠を扱い、検出結果の状態を保持します。

主な機能

  1. 01npxでページ検査コマンドを実行
  2. 02axeの違反と未確定項目を解析
  3. 03アクセシビリティツリーの操作上の問題を確認
  4. 04関連スキルの指針に基づき評価
  5. 05根拠、影響、重大度を添えて報告
  6. 06自動検出指標とレビュー状態を記録

活用シーン

  1. 01ライブページのWCAGとベストプラクティスを確認
  2. 02操作要素の名前やロールの不明瞭さを検出
  3. 03ランドマーク、見出し、状態通知を評価
  4. 04検出項目の根拠と修正案を整理

インストール

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

$npx skills add https://github.com/mgifford/accessibility-skills --skill cli-audit

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

同梱ファイルscripts/cli-inspect.mjs

詳細

CLI 監査スキル

Claude CLI からライブ URL の監査を依頼された場合に、このスキルを使用してください。

ライブサイトを監査するすべてのリクエストで、robots の指示とサイトの利用規約を遵守してください。

必須の実行

ユーザーからページ URL の監査を依頼された場合は、次を実行してください。

npx --yes --package=github:mgifford/accessibility-skills cli-audit-inspect <URL>

この呼び出しは、対象プロジェクト内のローカルな scripts/ ファイルを必要とせず、このリポジトリのパッケージから検査コマンドを取得するため、Claude CLI ユーザーがどこでも使用できます。

ライブサイトには配慮してください

ライブ URL を監査するときは、サイトに配慮し、影響を抑えた方法で実行してください。

  • まず単一ページ、または少数ページのチェックを優先してください。
  • 本番ページに対する短時間での繰り返しスキャンは避けてください。
  • Cloudflare/WAF にリクエストをブロックされた場合、力ずくで再試行しないでください。
  • ステージング URL、許可リストへの登録、手動チェックなど、サイト所有者が承認した代替手段を推奨してください。

必須の解析

出力された JSON を解析し、次を評価してください。

  1. 自動化された WCAG およびベストプラクティスの不備について、axe.violations を確認します。
  2. 手動での確認が必要な潜在的な違反について、axe.incomplete を確認します。
  3. 自動ルールでは検出できない動作上の問題について、accessibilityTree を確認します。次のような問題が含まれます。
    • インタラクティブ要素の名前がない、または不明確
    • 想定外のロール、またはロールの不一致
    • ランドマークや見出し構造の問題
    • 状態の伝達に関する不足（expanded、checked、selected、無効状態）
    • フォーカス管理上のリスクを示す可能性があるダイアログやメニューのセマンティクス

必須の評価方法

結果を報告する前に、このリポジトリのガイダンスに照らして評価してください。

  • skills/ACCESSIBILITY-general/SKILL.md から確認します。
  • 観測された問題に基づき、関連するトピックのスキルを適用します（例： forms、keyboard、navigation、color-contrast、aria-live-regions、 image-alt-text、tables、svg、touch-pointer、tooltips）。

報告要件

報告する各問題について、次を満たしてください。

  1. 検出元（axe または accessibilityTree）を特定します。
  2. 該当する場合、axe ノードから影響を受けるセレクター／パスを記載します。
  3. 影響の概要と、該当するスキルの尺度による重大度を記載します。
  4. 特定できる場合は WCAG 2.2 の達成基準を引用し、その対応付けの根拠（axe ルールに記載された対応付け、または該当するスキルのルール）も引用します。この監査の証拠が裏付けていない WCAG の対応付けを作り出してはいけません。
  5. スキルのルールに結び付けた、具体的な修正案を提示します。
  6. ツールの生の結果（axe.violations と axe.incomplete の区別、またはアクセシビリティツリーの証拠）を保持し、単一の合格／不合格ラベルにまとめないでください。
  7. この監査で検出されたすべての axe.violations および accessibilityTree の所見を、evidence_status: automated-indicator、handling: review として報告します。この監査だけでは、confirmed-standards-failure、confirmed-user-facing-barrier、または handling: report／suppress に必要な人による確認を満たしません。詳しくは Accessibility Finding Tracking: Policy Classification を参照してください。

問題が見つからなかった場合は、残るリスクを明確に報告してください。

  • 自動スキャンでは、操作、タイミング、フォーカス移動、および支援技術の動作に関する問題を見逃す可能性があります。
  • skills/manual-testing/SKILL.md を使用した、キーボードおよびスクリーンリーダーによる手動検証を推奨してください。

コメント

Markdown 対応