Communitygithub.com

Vincenius/wwebdev

wweb.dev のページを実際のブラウザでビルド、サーブし、レンダリングされた画面で変更を確認します。

wwebdev とは?

このスキルは、静的サイトジェネレーター Astro と React アイランドアーキテクチャで構築された wweb.dev サイトへの変更を検証するためのものです。変更を確認するには、実際のブラウザでページをロードし、ハイドレーションされた React アイランドとインタラクションする必要があります。主なワークフローは、`yarn build` でサイトをビルドし、`yarn serve` で本番サーバーを起動した後、Playwright を使用せずにシステムの Chrome ブラウザを自動操作してページを検証します。開発者は、`playwright-core` を任意のディレクトリにインストールし、`chromium.launch({ channel: 'chrome', headless: true })` で Chrome を起動することで、ブラウザのダウンロードなしで検証を行えます。このスキルは、生成ツールの出力(textarea 内のコピー可能なコード、注入されたスタイルの計算値、レスポンシブスクリーンショットなど)の確認に特に有用で、1440px と約 480px のビューポートでテストすることを推奨しています。コンソールエラーがないことの確認も重要なチェックポイントです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Vincenius/wwebdev/tree/HEAD/.claude/skills/verify

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

wweb.dev 上の変更を検証する

完全に静的な Astro サイト(React アイランド使用)。検証とは、ビルドしたページをブラウザで読み込み、ハイドレーションされたアイランドと対話することを意味します。

ビルド + サーブ

yarn install          # サーバーの依存関係が不足している場合(server.mjs には compression/express が必要)
yarn build            # 静的ビルド → dist/(TZ=UTC が組み込まれる)
yarn serve            # 本番サーバー(http://localhost:4321、astro preview ではありません)

node server.mjs は Yarn PnP に類似したセットアップでは直接失敗します。必ず yarn serve を使用してください。バックグラウンドで実行し、curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/<route> でプローブします。

ページを操作する

リポジトリには Playwright は含まれていません。スクラッチディレクトリに playwright-core をインストールし、システムの Chrome を使用してください(chromium.launch({ channel: 'chrome', headless: true }))— ブラウザのダウンロードは不要です。アイランドは client:visible なので、アイランドがレンダリングしたセレクタをアサートする前に待機し、アニメーションには約1秒の猶予を与えてください。

ジェネレーターツールに役立つチェック:

  • 注入された <style> 出力の計算スタイル(animation-name、position、size)
  • コピー可能な HTML/CSS コードの textarea .inputValue()
  • 1440px および約 480px でのスクリーンショット(いくつかのツールサイドバーはモバイルで column-reverse に反転します)

注意点

  • コンソールはエラーフリーであるべきです。Vite アセットインライン化は無効になっています(assetsInlineLimit: 0 in astro.config.mjs)。これはデータ URI フォントが CSP font-src 'self' に違反するためです — もし data-URI CSP エラーが再発した場合、その設定が失われています。
  • yarn test:parity には test/baseline/(本番 HTML スナップショット)が必要ですが、これはチェックインされていません。それがないとハーネスは ENOENT で失敗します。いずれにせよ、ブラウザ検証の代わりにはなりません。

関連スキル