compatibility-testing について
compatibility-testingは、ブラウザーやデバイスの互換性チェックを計画・実行するスキルです。テストや品質エンジニアリングのチーム向けに、レスポンシブ検証、ブラウザー間の画像比較、並列テストの調整を扱います。
主な機能
- 01ブラウザーとデバイスのマトリクス作成
- 02モバイル・タブレット・デスクトップのブレークポイント検証
- 03プラットフォーム間のスクリーンショット比較
- 04ブラウザーテストの並列調整
- 05互換性レポートと差分の記録
活用シーン
- 01リリース前のブラウザー互換性確認
- 02CSSやレイアウト変更後のレスポンシブ検証
- 03新市場向けデバイスカバレッジの評価
- 04プラットフォーム間の表示差異の特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ proffesor-for-testing/ agentic-qe --skill compatibility-testingインストール後、Claude Code で/compatibility-testingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/compatibility-testing.yamlschemas/output.jsonscripts/validate-config.json詳細
互換性テスト
ブラウザーエンジン
ビューポートのエミュレーション、レスポンシブ検証、クロスブラウザーのスクリーンショットなど、ブラウザーを使用したチェックには qe-browser フリートスキル(.claude/skills/qe-browser/)を使用してください。Vibium は aqe init によってインストールされます。クイックリファレンス:
# Viewport emulation per breakpoint
vibium viewport 375 667 # mobile
vibium viewport 768 1024 # tablet
vibium viewport 1920 1080 # desktop
# Full device emulation (user-agent, DPR, touch)
vibium emulate-device "iPhone 15"
# Visual diff per viewport
for vp in "375 667 mobile" "768 1024 tablet" "1920 1080 desktop"; do
read w h name <<< "$vp"
vibium viewport $w $h
node .claude/skills/qe-browser/scripts/visual-diff.js --name "homepage-$name"
done
クロスブラウザー(Firefox/Safari)には、現時点では引き続き Playwright またはクラウドデバイスファームが必要です。Vibium の BiDi バックエンドは v26.3.x では Chrome のみをサポートしています。
<default_to_action> クロスブラウザー/プラットフォームの互換性を検証するとき:
- ブラウザーマトリックスを定義する(ユーザーの95%以上をカバー)
- レスポンシブのブレークポイントをテストする(モバイル、タブレット、デスクトップ)
- 複数のブラウザー/デバイスで並行して実行する
- デバイスを網羅するためにクラウドサービスを使用する(BrowserStack、Sauce Labs)
- プラットフォーム間でスクリーンショットを比較する
互換性チェックリスト:
- Chrome、Firefox、Safari、Edge(最新バージョンとN-1)
- モバイル Safari(iOS)、モバイル Chrome(Android)
- 画面サイズ:320px、768px、1920px
- 重要なフローは実際の対象デバイスでテストする
重要な成功要因:
- ユーザーは100種類以上のブラウザー/デバイスの組み合わせからアクセスします
- 開発環境ではなく、ユーザーが使う環境でテストする
- クラウドテストを使えば、10時間かかる作業を15分に短縮できます </default_to_action>
クイックリファレンスカード
使用するタイミング
- リリース前
- CSS/レイアウトの変更後
- 新しい市場への展開時
- レスポンシブデザインの検証時
Playwright によるクロスブラウザーテスト
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
{ name: 'mobile-chrome', use: { ...devices['Pixel 5'] } },
{ name: 'mobile-safari', use: { ...devices['iPhone 12'] } }
]
});
// Run: npx playwright test --project=chromium --project=firefox
クラウドテストとの統合
// BrowserStack configuration
const capabilities = {
'browserName': 'Chrome',
'browser_version': '118.0',
'os': 'Windows',
'os_version': '11',
'browserstack.user': process.env.BROWSERSTACK_USER,
'browserstack.key': process.env.BROWSERSTACK_KEY
};
// Parallel execution across devices
const deviceMatrix = [
{ os: 'Windows', browser: 'Chrome' },
{ os: 'OS X', browser: 'Safari' },
{ os: 'Android', device: 'Samsung Galaxy S24' },
{ os: 'iOS', device: 'iPhone 15' }
];
エージェント主導の互換性テスト
// Cross-platform visual comparison
await Task("Compatibility Testing", {
url: 'https://example.com',
browsers: ['chrome', 'firefox', 'safari', 'edge'],
devices: ['desktop', 'tablet', 'mobile'],
platform: 'browserstack',
parallel: true
}, "qe-visual-tester");
// Returns:
// {
// combinations: 12, // 4 browsers × 3 devices
// passed: 11,
// differences: [{ browser: 'safari', device: 'mobile', diff: 0.02 }]
// }
エージェント連携のヒント
メモリ名前空間
aqe/compatibility-testing/
├── browser-matrix/* - Browser/version configurations
├── device-matrix/* - Device configurations
├── visual-diffs/* - Cross-browser visual differences
└── reports/* - Compatibility reports
フリート連携
const compatFleet = await FleetManager.coordinate({
strategy: 'compatibility-testing',
agents: [
'qe-visual-tester', // Visual comparison
'qe-test-executor', // Cross-browser execution
'qe-performance-tester' // Performance by platform
],
topology: 'parallel'
});
関連スキル
- モバイルテスト - モバイルに特化したテスト
- 高度なビジュアルテスト - ビジュアルリグレッション
- アクセシビリティテスト - クロスプラットフォームのアクセシビリティ
忘れずに
ユーザーベースの95%以上をカバーしましょう。 アナリティクスを使って、実際に利用されているブラウザー/デバイスを特定してください。誰も使っていないブラウザーに時間を費やさないでください。
エージェントを使用する場合: エージェントは、クラウドプラットフォームをまたいだ並行クロスブラウザーテストを統括します。qe-visual-tester は、プラットフォーム間の視覚的な不整合を自動的に検出します。