scan について
scanは、稼働中のページを監査し、アクセシビリティ違反の場所と根拠を報告するスキルです。ページを変更せず問題を特定したい開発者向けです。
主な機能
- 01URLまたは設定済みターゲットを監査
- 02影響度別の件数と違反を報告
- 03セレクターと利用可能なソース位置を表示
- 04機械的な修正または人による確認を提案
- 05監査後に管理対象のChromeを停止
活用シーン
- 01開発ページのアクセシビリティ問題を確認
- 02Storybookのターゲットを監査
- 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で利用可能なターゲットを一覧表示します。
コメント
Markdown 対応