◉ANTIGRAVITY LABEN
記事一覧/連携・プラグイン
⬡ 連携・プラグイン/2026-06-17上級

axe-core の検出をエージェントに渡して直す — アクセシビリティ改善を CI に組み込む実装メモ

axe-core で検出したアクセシビリティ違反を Antigravity のエージェントに渡し、検出→トリアージ→修正→再検証のループを CI に組み込む実装メモです。新規違反だけを止める差分ゲートと、エージェントの修正範囲を絞る設計を本番運用の形でまとめました。

antigravity476accessibilityaxe-coreplaywright3github-actions9ci-cd16premium15

✦ プレミアム記事

import RelatedArticles from "@/components/RelatedArticles";

壁紙アプリの設定画面を更新してリリースした数日後、VoiceOver を使っている方から「保存ボタンが『ボタン』としか読み上げられず、何のボタンか分からない」というお便りをいただきました。アイコンだけの丸いボタンに accessibilityLabel を付け忘れていたのです。一画面なら目視で気づけますが、私自身、個人開発で複数のアプリと Web を並行して触っていると、リリースのたびに全画面を読み上げ確認する運用はまず続きません。

そこで今回は、axe-core でアクセシビリティ違反を機械的に検出し、その結果を Antigravity のエージェントに「直す対象」として渡し、検出からトリアージ、修正、再検証までを一つのループとして CI に組み込む方法をまとめます。ツールに判定させ、エージェントに修正させ、CI で歯止めをかける、という分業が要点になります。対象は主に Web フロントエンド(Dolice の Lab サイト群のような Next.js アプリ)を想定していますが、考え方はモバイルの自動アクセシビリティ検査にもそのまま移せます。

手動のアクセシビリティ点検が続かない理由

アクセシビリティの不具合は、機能バグのように画面が真っ白になって気づくものではありません。見た目には普通に動いています。だからこそ静かに溜まっていきます。コントラスト比が 4.5:1 をわずかに下回ったボタン、ラベルのない入力欄、フォーカスが飛ばない自作ダイアログ。どれも単体では小さく、目視レビューの最後にはたいてい力尽きます。

私が以前やってしまったのは、「リリース前にまとめて直す」という運用でした。結果として、直すべき項目が数百件に膨らみ、心理的に手が出せなくなりました。負債は溜めてから返すより、増やさない仕組みに寄せた方が、はるかに現実的だと感じています。axe-core を CI に置く目的は、まさにこの「増やさない」を機械に肩代わりさせることにあります。

ただ、検出するだけでは足りません。違反一覧を渡されても、レビューする側には「で、どう直すの」という負荷が残ります。ここに Antigravity のエージェントを噛ませ、違反の種類ごとに修正パッチの下書きまで作らせると、レビューが一気に前へ進みます。

ループ全体像 — 誰が検出し、誰が直し、誰が止めるか

このループは役割を最初に固定しておくと迷いません。三者の分担はこうなります。

  • axe-core(検出役): レンダリング後の DOM を走査し、WCAG のどのルールに違反しているかを機械可読な JSON で返します。判定は決定的で、揺れません。
  • Antigravity エージェント(修正役): 違反 JSON と該当箇所のソースを読み、修正の下書きを作ります。説明と提案が役目で、合否の判定はさせません。
  • GitHub Actions の差分ゲート(歯止め役): ベースラインと比べて「新しく増えた違反」があれば PR を止めます。既存の負債は別キューに回し、新規だけを確実にせき止めます。

検出と歯止めを決定的なツールに任せ、非決定的な部分(修正の発想)だけをエージェントに寄せるのが、CI の信頼性を保つコツです。エージェントに合否まで委ねると、同じ PR でも実行ごとに結果が変わり、ゲートとして機能しなくなります。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦axe-core の違反 JSON を「エージェントが直せる修正タスク」に整形し、critical/serious だけに絞って初回の指摘を 240 件から 38 件へ現実的な数に落とす手順を持ち帰れます
✦新規違反だけを止める差分ゲートを GitHub Actions に組み込み、既存の負債を抱えたままでも「これ以上悪化させない」状態を今日から作れます
✦エージェントに修正を任せるときに ARIA を増やしすぎて壊す事故を防ぐ、修正範囲の制約とレビュー観点を実例つきで学べます
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◈ Agents & Manager2026-04-16
Antigravity エージェントでテストパイプラインを自動構築する:品質保証を AI に任せる実践設計
テスト生成・検証・実行の3層エージェントアーキテクチャで、品質保証を AI に任せるパイプラインを設計します。AI が書いたテストを AI が検証する仕組み、失敗からの自動修復ループ、CI/CD への組み込みと agents.md による振る舞いの制御まで実装します。
⬡ 連携・プラグイン2026-11-03
スプレッドシートの手作業を Apps Script に置き換える——非エンジニアが Antigravity に出す最初の依頼
毎週のシート転記を Apps Script に任せたい非エンジニア向けに、Antigravity への依頼文、試走スイッチと同時実行よけの入ったコード、関数で済む場合との比べ方、トリガーの時刻のずれ、失敗の切り分け表までを一本の流れでまとめます。
⬡ 連携・プラグイン2026-10-17
Antigravity のブラウザエージェントがログイン画面で止まるときに確認する4点
ブラウザエージェントに管理画面を読ませたら、返ってきたのはサインイン画面だけ。別 Chrome プロファイルという仕様を踏まえ、ログイン状態を整える4つの確認点をまとめました。