mcpField
S
scan

scan

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

scan について

scanは、稼働中のページを監査し、アクセシビリティ違反の場所と根拠を報告するスキルです。ページを変更せず問題を特定したい開発者向けです。

主な機能

  1. 01URLまたは設定済みターゲットを監査
  2. 02影響度別の件数と違反を報告
  3. 03セレクターと利用可能なソース位置を表示
  4. 04機械的な修正または人による確認を提案
  5. 05監査後に管理対象のChromeを停止

活用シーン

  1. 01開発ページのアクセシビリティ問題を確認
  2. 02Storybookのターゲットを監査
  3. 03違反箇所を特定して修正を割り当て

インストール

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

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

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

詳細

ライブページを監査し、問題の内容と場所を報告します。特定のみ行い、修正はしません。

$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. 報告

影響度別の件数を示し、違反ごとに1件ずつ記載します:

  • 場所 — セレクターをそのまま記載し、source が存在する場合は file:line (symbol) も記載します。決して捏造しないでください。source を持つ違反がない場合は、「ソースマッピングを利用できません — セレクターのみで特定」と記載します。
  • 根拠 — コントラスト比、属性の欠落、名前が空
  • 修正 — 機械的な変更、または NEEDS HUMAN

編集はしないでください。修正する場合は、機械的な修正を適用してから再実行し、検証してください。大規模な作業は accesslint:audit に引き継いでください。

3. 後処理

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

注意点

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

コメント