mcpField
A
accessibility-scan

accessibility-scan

github.com/accesslintテスト・品質1141.1k 回インストール9 週間前に更新
リポジトリ

accessibility-scan について

ライブページを監査し、検出したアクセシビリティ上の問題と場所を報告するスキルです。accesslint CLIを使い、修正ではなく問題の特定に重点を置きます。

主な機能

  1. 01URLまたは設定済みターゲットのスキャン
  2. 02accesslintルールによる検査
  3. 03影響度別の問題報告
  4. 04セレクターと利用可能なソース位置の提示
  5. 05根拠と修正案の提示

活用シーン

  1. 01ライブページのアクセシビリティ問題の確認
  2. 02設定済みの開発環境やStorybookターゲットの点検
  3. 03別工程で修正する前の問題箇所の特定

インストール

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

$npx skills add https://github.com/accesslint/skills --skill accessibility-scan

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

詳細

ライブページを監査し、違反項目とその場所をそれぞれ報告します。特定するだけで、修正はしません。

共通の根拠確認と誠実性に関する規約：../shared/methodology.md。

$ARGUMENTS は URL、設定ターゲット名（dev、storybook、…）、または空欄です。空欄の場合は、accesslint.config.json のデフォルトターゲットを監査します。空欄で設定ファイルも存在しない場合は、URL を尋ねるか、npx @accesslint/cli init を提案します。

1. 監査

PORT=$(npx -y @accesslint/chrome@latest ensure | node -e 'process.stdin.on("data",d=>process.stdout.write(""+JSON.parse(d).port))')
npx -y @accesslint/cli@latest scan <target> --port "$PORT" --format json

<target> は $ARGUMENTS の URL または設定ターゲット名です。設定のデフォルトターゲットを監査する場合は、省略してください（"" は渡さないでください）。必要に応じて --selector、--wait-for "<selector>"、--include-aaa、--disable <rules> を追加するか、accesslint.config.json のターゲットごとに固定してください。

2. 報告

影響度ごとの件数を示した後、違反項目をそれぞれ記載します。

  • 場所：セレクターをそのまま記載し、source がある場合は file:line (symbol) も記載します。作り上げてはいけません。どの違反項目にも source がない場合は、「ソースマッピングは利用できません。セレクターのみで場所を特定しました」と記載します。
  • 根拠：コントラスト比、属性の欠落、名前が空であること。
  • 修正：機械的に適用できる変更、または NEEDS HUMAN。

編集はしないでください。修正する場合は、機械的に適用できるものを適用し、再実行して検証してください。まとめて作業する場合は accesslint:accessibility-fix に引き継いでください。

3. 後処理

npx -y @accesslint/chrome@latest stop --all  # skip if ensure reported "managed":false

注意事項

  • ポートは ensure が決定します。9222 をハードコードしないでください。
  • CLI の終了コード 2 は、URL またはターゲットが不正であるか、ページが読み込まれなかったことを示します。開発サーバーを確認してください。不明なターゲット名を指定すると、CLI は accesslint.config.json で利用可能なターゲットを一覧表示します。

コメント

Markdown 対応