playwright-test について
機能のエンドツーエンド Playwright テストを計画・実装するスキルです。UI の変化をアサートし、繰り返し実行して不安定さを確認したうえで完了を報告します。
主な機能
- 01ブラウザー探索によるテスト計画
- 02UI 変化のアサーション
- 03近隣ファイルの形式に沿った実装
- 04テスト通過までの失敗調査
- 05不安定さを調べる反復実行
活用シーン
- 01機能のエンドツーエンドテスト設計
- 02UI 操作の検証
- 03Playwright テスト失敗の調査
- 04反復実行による安定性確認
MCP 対応
探索時にナビゲーション、クリック、スクリーンショットなどの Playwright MCP ブラウザーツールを使うよう指示します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ posthog/ posthog --skill playwright-testインストール後、Claude Code で/playwright-testを入力して読み込まれたか確認します。
詳細
ベストプラクティス、注意点、テストの実行方法については @playwright/README.md をお読みください。
ルール
- README のベストプラクティスに厳密に従ってください
- UI 操作の後は、常に UI の変更をアサートしてください。解決するネットワークリクエストをアサートしないでください
- すべてのテストが通るまでループを続けてください。 諦めたり、ユーザーに助けを求めたりしないでください。すべての失敗を自分で解決する必要があります。
手順
機能に対するエンドツーエンドの Playwright テストを計画してください。
ステップ 1: 実施するテストを計画する
Playwright MCP ツール(例: mcp__playwright__browser_navigate、mcp__playwright__browser_click、mcp__playwright__browser_screenshot)を使用してブラウザを操作し、テストを計画してください。
調査が終わったら、確認または変更のために計画を私に提示してください。
ステップ 2: テスト計画を実装する
- テストを作成し、隣接するファイルで使われている共通のパターンを必ず使用してください。
BASE_URL='http://localhost:8010' pnpm --filter=@posthog/playwright exec playwright test <file name> --retries 0 --workers 3でテストを実行してください- 失敗をデバッグしてください。スクリーンショットを確認し、必要であれば playwright mcp スキルを起動してブラウザを操作してください。修正を試みた後はステップ 1 に戻ってください。
ステップ 3: フレーキーテストがないことを確認する
ファイル内のすべてのテストが通ったら、コマンドに --repeat-each 10 を追加して実行してください。これにより、フレーキーなテストが明らかになります。
10 回の実行でいずれかのテストが失敗した場合は、それを実際の失敗として扱ってください: ステップ 2 に戻り、デバッグし、修正し、ステップ 3 を再実行してください。すべてのテストのすべての実行が通るまで、ステップ 4 に進まないでください。
ステップ 4: 報告
すべてのテストが通ったら、1 行だけ出力してください: Testing Complete