日本語 | English
導入にはNode.js 22以上と版を固定したソースが必要です。3 OS共通の導入・更新・復元・削除手順を先に確認してください。
Webサイト、アプリ、文書、スライド、動画、イベント案内などについて、情報を見つけ、受け取り、理解し、目的の行動を完了し、後から確認できるかを調べるCodex／Claude向けパッケージです。
自然言語レビュー、WCAG／JISのstandalone評価、複数工程を記録するrun-backed監査の3経路があります。WebではPlaywrightとaxe-coreを用いた読取り専用scanも利用できます。
AIと自動検査が作るものは、原則として問題候補やE0／E1のscreening evidenceです。規格条項の正式な判定には、該当手順を用いた外部の人による確認と、対象固有の証拠が必要です。現行版だけで正式な適合宣言はできません。
迷った場合は、まず対象と知りたいことをそのまま伝えてください。
このWebサイトを情報アクセシビリティの観点で確認し、観測できた問題、改善案、人による確認が必要な点を分けてください。
| 利用経路 | 向いている目的 | 主な成果物 | 注意点 |
|---|---|---|---|
| 自然言語レビュー | まず問題候補と改善案を知る。文書、動画、イベントも含む | 会話形式のレビュー、改善案、人による追加確認 | 規格台帳や工程履歴を残す用途ではない |
| standalone評価 | WCAG／JISの全条項を含む一時点の評価台帳を作る | assessment JSONとprofile-awareなMarkdown／HTML検査レポート | 初期化直後は全条項がnot_testedであり、検査完了ではない |
| run-backed監査 | screening、人手確認、改善、再検査を追跡する | audit run、登録artifact、統合assessment、レポート | schemaとartifactの関係を理解する必要がある |
処理全体と役割分担は、アーキテクチャと用語集で確認できます。3経路を実際に動かす場合は実行可能なexamplesを使います。
出典付きのWebスクリーニング11パターンと、証拠・対象の識別情報を扱うライブラリも利用できます。
| 対象 | 自然言語レビュー | 構造化screening／規格台帳 | 現在の制限 |
|---|---|---|---|
| Webサイト／Webアプリ | 対応 | WCAG・JISの各プロファイル、読取り専用scan-web |
実機スクリーンリーダー確認は外部の人またはホスト機能が必要 |
| PDF／Word／スライド | 対応 | 5観点の非Web記録・人手確認・比較 | 専用の規格適合profileは未実装 |
| 動画／音声 | 対応 | 5観点の非Web記録・人手確認・比較 | 単独media規格profileは未実装 |
| イベント／会議／コミュニティ | 対応 | 5観点の非Web記録・人手確認・比較 | 規格適合判定の対象外 |
| ATAG／authoring process | 参照ガイダンス | 構造化assessmentなし | authoring-agentはinactive。Part Aのhost UIを分け、Part B内の作者支援機能と自動生成物を区別する |
評価に使う規格・方針に合わせて、次のプロファイルを選びます。
- JIS単独の評価には
jis-x-8341-3-2016-aaを使います。JIS X 8341-3:2016（WAIC解説） A／AAの38件が対象です。 - WCAG 2.2単独の評価には
web-modernを使います。WCAG 2.2 A／AAの55件が対象です。 - legacyプロファイルの
jp-public-webは、JISの38件と追加WCAGの18件を組み合わせた56件です。この組合せを組織が明示的に採用する場合に使います。日本の公開Web全般に適用される要件を表すものではありません。
選び方と既存記録の扱いはプロファイル選択・移行ガイドを参照してください。JISに残る4.1.1「構文解析」はWCAG 2.2では削除されています。収録件数と実際の評価件数は別々に記録します。
- Node.js 22以上
- リポジトリのローカルコピー
- browser scanを使う場合のみ、指定版のPlaywright、axe-core、ホストで利用を認められたChromiumまたはシステムChrome
CLIの台帳作成・登録・統合・レポート機能は、ブラウザなしで動作します。実ページの検査には、対応adapterまたはホストのbrowser toolが必要です。パッケージの存在だけで検査可能と判断せず、実Web検査の事前確認を行います。
| 実行環境 | CLIの記録処理 | DOM・AX・キーボード・画面幅 | 対象への通信 | スクリーンリーダー実機 |
|---|---|---|---|---|
| Codex + Nodeホスト | 対応 | adapter導入後にpreflightで実測 | runtime・権限・origin設定が必要 | 外部の人による確認 |
| Claude + Nodeホスト | 対応 | adapter導入後にpreflightで実測 | runtime・権限・origin設定が必要 | 外部の人による確認 |
| その他のNodeホスト | 対応 | adapter導入後にpreflightで実測 | runtime・権限・origin設定が必要 | 外部の人による確認 |
ホスト固有のbrowser toolは自動検出しません。別の統合を使う場合は、その実測結果を記録してください。能力不足の確認項目は未確認として次のテストを示し、profileはnot_testedを維持します。
run-backedの実通信には、具体的な通信方針と非公開ログが必要です。対象と規格資料の許可先を分け、実行時にも呼出側の許可を照合します。別originのiframeなど、現在のadapterで強制を確認できない経路は停止します。
監督付きの入力操作には、操作範囲・承認者・期限と実行時の承認が必要です。承認者情報と操作履歴は内部に保存し、公開レポートには出しません。現在はスクリプトと追加通信を停止したページでのTab／Shift+Tabに対応し、実行時の承認がないCLI処理はread-onlyになります。
人手レビューの署名検証CLIは、自己申告・自己署名・受領者の信頼方針で認められた署名を区別します。新しいassessment 2.0.0の結果行に元のレビュー記録を結び付け、検証・レポート生成のたびに保証水準を再計算します。旧形式のhuman_verifiedは「旧形式の自己申告」と表示します。署名はレビュー内容の正しさや最終bundle全体の完全性を証明しません。
audit-bundle CLIは、保存したrun・登録artifact・証拠・assessment・レポートの実ファイルと、前段の署名への連結をオフラインで照合します。外部で署名した記録と受領者の信頼方針を使い、未署名・自己署名・組織署名等を区別します。保存した全対象ソース、過去ファイルの保存状態、信頼できる時刻、報告内容の正しさは別途確認が必要です。
Windowsではmanifest対応installerを利用できます。
powershell -ExecutionPolicy Bypass -File ".\scripts\install-codex.ps1" -WhatIf
powershell -ExecutionPolicy Bypass -File ".\scripts\install-codex.ps1"既定導入は監査専用で、修正用agent・CLI・schemaを含みません。認可済み修正が必要な場合だけ-IncludeAuthorizedFixerを指定します。agentは読み取り専用のhandoffを作成し、対象の変更・検証・rollbackは、外部許可を確認した信頼された運用者が行います。両構成はregistry 17.0.0を共有し、異なるregistry版の修正機能は導入を拒否します。
Windows／macOS／Linux共通のNode installerはnode scripts/install-codex.mjs --dry-runとnode scripts/install-codex.mjsです。更新・復元・削除と版固定は導入手順を参照してください。
shared/agents/agent-manifest.jsonのinstall_by_default: trueを正本として、skillと次の既定4agentをまとめて配置します。
information-accessibility-reviewerinformation-accessibility-e1-inspectorinformation-accessibility-human-queue-plannerinformation-accessibility-remediation-planner
node .\scripts\install-claude.mjs --dry-run
node .\scripts\install-claude.mjsmulti-agent構成はCodex版と同じrole artifact contractを維持します。specialist agentをdispatchできない場合だけ--reviewer-onlyを使用します。
Claudeも既定は監査専用です。修正機能の明示導入には--include-authorized-fixerを指定します。
Node installerはWindows／macOS／Linuxに対応します。更新・復元・削除は導入手順を参照してください。
npm install --global .\codex\skills\information-accessibility-practice
accessibility-audit --locale ja --help
accessibility-audit --version
accessibility-audit profiles list --locale ja
accessibility-audit requirements search "focus" --profile web-modern --level AA --locale ja
accessibility-audit screen-reader-checklist --pattern modal-dialog --locale ja --format markdown
accessibility-audit screen-reader-checklist --list-patterns --locale ja
accessibility-audit doctor --locale ja
accessibility-audit preflight-web --browser-channel chrome --locale ja --format jsonこのnpm導入も監査専用です。修正機能はCodex／Claude installerの明示オプションから導入してください。
--locale jaと--locale enは、CLI help、profile、条項一覧・検索・表示、legacy requirement表示、スクリーンリーダーチェックリスト、レポートの人向け文字列だけを切り替えます。内部ID、schema key、enum、証拠型、claim tierは変更しません。
スクリーンリーダーの--pattern allは同梱8パターンと指定した--extension <file.json>の範囲です。実機の読み上げは人が確認し、未掲載のUIは別途評価してください。拡張ファイルの形式は状態付きUIの手順に記載しています。
探索系commandはread-onlyです。non-web-reviewは指定した新規記録ファイルだけを書き、監査対象を変更しません。非Web対象はnon-web-review initで文書・スライド、動画・音声、イベント、参加導線のいずれかを選び、5観点の未実施記録を作れます。validate、report、compareで人手確認・改善案・再確認を扱います。出力はaudit-runs/などの非公開フォルダに保存してください。これはWCAG／JISの評価台帳ではなく、根拠ファイルの実バイト照合も行いません。
次の例は、WCAG 2.2 A／AAの55件をnot_testedで初期化し、検証して、日本語のprofile-awareレポートを生成します。
node .\codex\skills\information-accessibility-practice\scripts\accessibility-audit.mjs assessment --profile web-modern --target-name "Example Site" --target-version "2026-08-24" --target-ref "https://example.com/" --evaluator "Accessibility Reviewer" --evaluated-at "2026-08-24" --output .\audit-runs\quickstart\audit.json
node .\codex\skills\information-accessibility-practice\scripts\accessibility-audit.mjs validate-assessment .\audit-runs\quickstart\audit.json
node .\codex\skills\information-accessibility-practice\scripts\accessibility-audit.mjs report --input .\audit-runs\quickstart\audit.json --locale ja --output .\audit-runs\quickstart\audit-report.md初期台帳を作っただけでは完了としないため、対象固有の証拠と判定が入るまでは、全55項目が未確認／未実施として表示されます。この段階の文書は参照ガイダンスであり、対象固有の証拠と判定を持つ検査レポートとは区別します。
レポート各行には、条項番号、名称、レベル、profile group、一次資料、判定の出所、証拠レベル、根拠を表示します。run-backedレポートでは、外部人手レビュー、AI／自動スクリーニング、未実施を区別します。screening projectionはreport-only judgementであり、profile outcomeへ自動昇格しません。
--locale jaと--locale enは人向け表示だけを変更し、内部ID、schema key、enumは変更しません。主張可能な範囲には、要求されたtier、validator上限、registryの固定wording、制限理由を表示します。
--format markdownが既定の編集・差分管理用形式で、--format htmlはブラウザー配布向けのaccessible HTMLです。--detail summary／--detail full、同形式の完全版を分ける--appendix、--visibility internal／--visibility publicを共通して利用できます。
要約と完全版は、対象範囲、人手確認・自動検査・未実施の件数、優先順の改善項目、残る確認作業を先に示します。改善項目には、記録された箇所・利用者への影響・改善案・再確認方法をまとめます。要約でも未確認理由と次の確認を省略せず、完全版には全達成基準の結果表を残します。--detailは表示量の指定であり、検査対象や実施する検査の深さを変更するものではありません。
PDFは、taggingとreading orderを検証できる正式経路がないためサポート対象外です。HTMLの構造、生成物E2E、NVDA smoke test、残る外部確認はレポート形式とアクセシビリティに整理しています。
編集用プレースホルダーだけが必要な場合はtemplate modeを使います。
node .\codex\skills\information-accessibility-practice\scripts\generate-assessment.mjs --template --profile web-modern --output .\audit-runs\quickstart\assessment.template.jsonrender-audit-report.mjsは既存利用者向けのlegacy-compatible direct rendererとして残ります。新しいprofile／provenance／locale／claim表示の正規経路はaccessibility-audit reportです。
| 成果物 | 役割 | 通常の公開範囲 |
|---|---|---|
| assessment JSON | profile全条項、証拠、判定、claim情報を保持 | 内部用。検証後にレポートへ投影 |
| automated scan JSON | axe結果、DOM／AX tree等の内部証拠 | 原則として内部用 |
| compact scan context | AIへ渡すために圧縮した問題候補 | 内部レビュー用 |
| audit run | 対象、権限、artifact hash、状態遷移を保持 | 非公開 |
| human-review queue | 人が確認する条項、手順、必要証拠 | 作業用 |
| Markdown report | profile、判定、provenance、claim、改善、未確認事項を表示 | publication review後に共有可能 |
| HTML report | lang、landmark、目次、skip link、table semanticsを持つ配布用レポート | public visibilityとpublication review後に共有可能 |
各成果物の作成者、入力、出力、公開可否は成果物マップに整理しています。形式別の対応範囲はレポート形式ガイドを参照してください。
対象箇所に結び付いた確認候補は review-queue で作成できます。人手確認queueの作成・登録・旧形式の扱いを参照してください。
記入済みのpayloadから4種類の標準artifactを作る場合は artifact init、編集後の登録前確認には artifact validate を使います。ID・版・日時・入力hashはCLIが設定します。エージェントなしでの作成手順を参照してください。
登録済みのキューは human-review export でCSV・Markdown・Excelへ出力し、確認者の記入後に human-review import でレビュー候補へ変換できます。入力方法、一部提出、複数の確認者、再提出の扱いを確認してください。取り込みでは本人性を認証せず、runも自動更新しません。
scan-webは固定されたPlaywright／axe-coreを使って公開URLを読取り専用で検査します。自動検査結果をWCAG／JISの正式なpass／failへ直接昇格させることはありません。
このサイトの最初の画面を、アクセシビリティCLIで検査して。
https://example.com/
依存関係、network／redirect制御、private address拒否、出力形式、compact AI context、Chromium E2Eの範囲は実Web検査ガイドを参照してください。
検査を始める前に、レポートを何に使うかと、必要な検査の深さを決めます。会話で指定済みなら引き継ぎ、曖昧な場合だけ簡易・詳細の希望を確認します。
| レベル | 使いどころ | 受け取る内容 |
|---|---|---|
簡易チェック（quick） |
大きな問題を把握し、次の検査や改善を判断したい | 指定範囲の基本検査、主要な問題と優先度、根拠、未確認事項と次の確認 |
詳細検査・改善用（detailed） |
担当者が具体的な修正に着手できる情報がほしい | 合意した画面状態・操作・環境の検査、指摘ごとの箇所・再現手順・影響・修正案・再検査方法、全項目の結果 |
新しいrunでは、initに--inspection-mode quick|detailed --inspection-purpose "レポートの利用目的"を指定します。対象範囲と環境は既存の--configで記録できます。レポートには選択内容と完了条件を表示し、実施記録で満たせない条件は未完了として次の作業を示します。レポートの表示量を変える--detail summary|fullとは別の指定です。過去のrunは従来の内容のまま読めます。
- 人手レビューの記録・主張範囲・監査の状態確認
- 機能の提案・不具合・進捗
- はじめに：最初の1回と利用経路
- 実行可能な3経路のexamples
- レポート形式、HTMLアクセシビリティ、検証境界
- アーキテクチャ、役割、成果物、日英用語集
- 実Web検査とbrowser／network境界
- CodexとClaude向けagent orchestration
- 規格assessmentと証拠レベル
- セキュリティ方針
- コントリビューション手順
- 変更履歴
- 対応版と移行方針
- 配布候補の作成とリリース手順
- 全コマンドのCLIリファレンス
- 第三者資料の帰属と利用条件
AIエージェントが作成または更新するプロファイル要件行は、mapping_status: "unverified"とoutcome: "not_tested"に保ちます。AIの観測はSCREEN-*または未検証の引き継ぎとして記録します。
- AIと自動検査はE0／E1のscreening observationを作成できます。
- 自動・静的検査は
screening_check、人が一次資料へ対応付ける規格条項はprofile_requirementとして分離します。 - 外部の人手レビューだけが、該当手順と対象固有の手動またはハイブリッド証拠に基づき、
pass、fail、not_applicable、cant_tellのprofile outcomeを記録できます。 reference_only、screened、evaluated_subset等のclaim tierは、記録された証拠とprofile ceilingを超えられません。- raw DOM、AX tree、private URL、local path、個人情報、authorization情報は、公開方針が明示されない限り内部用です。
- レポートの判定語は、第三者認証、法的判断、正式な適合表明ではありません。
変更前にCONTRIBUTING.mdを確認してください。共通skillはshared/skillが編集元で、Codex／Claude向けskillは同期生成物です。通常の完全検証は次です。
node .\scripts\verify-all.mjsセキュリティ上の問題は公開Issueへ秘密情報を貼らず、SECURITY.mdの案内に従ってください。
初回のプレリリース v0.1.0を公開しています。導入時は添付のSHA256SUMSとsource-manifest.jsonを確認し、再現用に完全なcommit SHAも記録してください。package版だけでは履歴中の開発版を区別できません。
オリジナルのコードと文書はMIT Licenseです。第三者規格メタデータには各提供元の条件が残ります。詳細はTHIRD_PARTY_NOTICES.mdを確認してください。
出典・採用版・利用条件・加工内容は機械可読の出典台帳に記録しています。Markdown／HTMLレポートにも帰属表示を付け、カタログ更新候補には利用条件の再確認待ちを示す付属ファイルを生成します。利用条件が未確認の資料をMITで補完せず、商用利用や再配布の権利確認が完了したとも扱いません。