Playwright Pro
AIコーディングエージェント向けのプロダクショングレードPlaywrightテストツールキット。
利用可能なコマンド
Claude Codeプラグインとしてインストールすると、以下のコマンドが /pw: として利用可能になります:
| コマンド | 説明 |
|---|---|
/pw:init | Playwrightをセットアップ — フレームワークを検出し、設定、CI、最初のテストを生成 |
/pw:generate <spec> | ユーザーストーリー、URL、またはコンポーネントからテストを生成 |
/pw:review | アンチパターンとカバレッジのギャップについてテストをレビュー |
/pw:fix <test> | 失敗または不安定なテストを診断して修正 |
/pw:migrate | CypressまたはSeleniumからPlaywrightに移行 |
/pw:coverage | テストされている箇所と不足している箇所を分析 |
/pw:testrail | TestRailと同期 — テストケースの読み取り、結果のプッシュ |
/pw:browserstack | BrowserStack上で実行し、クロスブラウザレポートを取得 |
/pw:report | 希望の形式でテストレポートを生成 |
クイックスタートワークフロー
ほとんどのプロジェクトで推奨される手順:
1. /pw:init → 設定、CIパイプライン、最初のスモークテストをスキャフォールド
2. /pw:generate → スペックまたはURLからテストを生成
3. /pw:review → 品質を検証し、アンチパターンを報告 ← 常に生成後に実行
4. /pw:fix <test> → 失敗または不安定なテストを診断して修復 ← CIが赤くなったら実行
検証チェックポイント:
/pw:generateの後 — コミット前に必ず/pw:reviewを実行。ロケーターのアンチパターンやアサーション不足を自動的に検出します。/pw:fixの後 — ローカルで全スイート(npx playwright test)を再実行し、修正がリグレッションを引き起こさないことを確認します。/pw:migrateの後 —/pw:coverageを実行して、古いスイートとのパリティを確認してからCypress/Seleniumテストを廃止します。
例: 生成 → レビュー → 修正
# 1. ユーザーストーリーからテストを生成
/pw:generate "ユーザーとしてメールとパスワードでログインしたい"
# 生成: tests/auth/login.spec.ts
# → Playwright Proが認証テンプレートを使用してファイルを作成。
# 2. 生成されたテストをレビュー
/pw:review tests/auth/login.spec.ts
# → フラグ: 1つのテストが page.locator('input[type=password]') を使用 — getByLabel('Password') を提案
# → 修正が自動的に適用される。
# 3. ローカルで確認
npx playwright test tests/auth/login.spec.ts --headed
# 4. CIでテストが不安定な場合、診断
/pw:fix tests/auth/login.spec.ts
# → web-firstアサーションが欠けていることを特定; waitForTimeout(2000) を expect(locator).toBeVisible() に置き換え
黄金ルール
- CSS/XPathよりも
getByRole()— マークアップ変更に強い page.waitForTimeout()は使わない — web-firstアサーションを使用するexpect(locator)は自動リトライ;expect(await locator.textContent())はしない- テストごとに分離 — テスト間で状態を共有しない
- 設定に
baseURL— ハードコードされたURLはゼロ - リトライ数: CIでは
2、ローカルでは0 - トレース:
'on-first-retry'— 豊富なデバッグ情報を速度低下なしで - グローバルよりフィクスチャ — 共有状態には
test.extend() - テストごとに1つの振る舞い — 複数の関連アサーションは問題ない
- 外部サービスのみモック — 自社アプリはモックしない
ロケーター優先順位
1. getByRole() — ボタン、リンク、見出し、フォーム要素
2. getByLabel() — ラベル付きフォームフィールド
3. getByText() — インタラクティブでないテキスト
4. getByPlaceholder() — プレースホルダー付き入力
5. getByTestId() — セマンティックなオプションがない場合
6. page.locator() — 最後の手段としてのCSS/XPath
含まれるもの
- 9つのスキル:詳細なステップバイステップの手順付き
- 3つの専門エージェント:テストアーキテクト、テストデバッガー、移行プランナー
- 55のテストテンプレート:認証、CRUD、チェックアウト、検索、フォーム、ダッシュボード、設定、オンボーディング、通知、API、アクセシビリティ
- 2つのMCPサーバー(TypeScript):TestRailおよびBrowserStack連携
- スマートフック:テスト品質の自動検証、Playwrightプロジェクトの自動検出
- 6つのリファレンスドキュメント:黄金ルール、ロケーター、アサーション、フィクスチャ、落とし穴、不安定なテスト
- 移行ガイド:CypressおよびSeleniumのマッピングテーブル
連携設定
TestRail(オプション)
export TESTRAIL_URL="https://your-instance.testrail.io"
export TESTRAIL_USER="[email protected]"
export TESTRAIL_API_KEY="your-api-key"
BrowserStack(オプション)
export BROWSERSTACK_USERNAME="your-username"
export BROWSERSTACK_ACCESS_KEY="your-access-key"
クイックリファレンス
reference/ ディレクトリを参照:
golden-rules.md— 譲れない10のルールlocators.md— チートシート付き完全なロケーター優先順位assertions.md— web-firstアサーションリファレンスfixtures.md— カスタムフィクスチャとstorageStateパターンcommon-pitfalls.md— よくある間違いトップ10と修正方法flaky-tests.md— 診断コマンドとクイックフィックス
templates/README.md で完全なテンプレート一覧を確認してください。
使用タイミング
playwright-proに関するガイダンスや自動化が必要な場合にこのスキルを使用します。