Coding

AGENTS.md

このプロジェクトは、Puppeteerとaxe-coreを用いてWebサイトのアクセシビリティ（WCAG基準）を自動検査し、

promptBeginner5 min to valuemarkdown

0 views

Jan 15, 2026

Sign in to like and favorite skills

View Original Source

Share:

Related Skills

PromptBeginner5 minmarkdown

Markdown Converter

Agent skill for markdown-converter

PromptBeginner5 minmarkdown

Nano Banana Pro

Agent skill for nano-banana-pro

PromptBeginner5 minmarkdown

1password

Agent skill for 1password

AGENTS.md

プロジェクト概要

このプロジェクトは、Puppeteerとaxe-coreを用いてWebサイトのアクセシビリティ（WCAG基準）を自動検査し、
違反内容をJSONおよびCSV形式で出力するNode.jsスクリプトです。
主に銀行サイト等の複数ページ・複数状態（初期・インタラクション後）を対象としています。

主なエージェント（役割）

1. アクセシビリティ検査エージェント

技術: Puppeteer, @axe-core/puppeteer
役割:
- 指定URLにヘッドレスブラウザでアクセス
- ページロード直後と、主要なインタラクティブ要素（ハンバーガーメニュー、モーダル、ドロップダウン）操作後の状態でaxe-coreによる自動検査を実施
- 違反内容を詳細に抽出し、ファイル出力・サマリー表示

2. レポート生成エージェント

技術: Node.js (fs, path)
役割:
- 検査結果をJSON・CSV形式で保存
- 各違反の詳細（ID、影響度、説明、該当要素など）を整理
- サマリーや主要違反内容をコンソールに出力

3. インタラクション自動化エージェント

技術: Puppeteer
役割:
- ページ内の特定要素（メニュー、モーダル、ドロップダウン等）を自動で検出・操作
- 操作後の状態で再度アクセシビリティ検査を実施
- ページ遷移や例外発生時のリカバリ処理

想定ユーザー

Webアクセシビリティ担当者
QAエンジニア
フロントエンド開発者

実行方法

必要パッケージのインストール
```
npm install
```
スクリプトの実行
```
node axe.js
```
結果は
```
./accessibility-results-interactive/
```
ディレクトリに保存されます。

注意事項

検査対象URLは
```
axe.js
```
内の
```
URLS_TO_TEST
```
配列で管理
Puppeteerのバージョンやブラウザ仕様に依存する部分あり
大量のページを検査する場合は適宜ウェイトを調整してください

拡張・カスタマイズ例

検査対象の追加・削除
インタラクションパターンの拡張
レポートフォーマットのカスタマイズ
CI/CD連携による自動実行