e2e-test-generator について
機能とフロントエンドタスクを基に、Markdown形式のE2Eテストタスクを作成する計画スキルです。Cypressを使うチーム向けで、セレクターを推測せず、明示的なdata-testid契約を求めます。
主な機能
- 01カバレッジ方針付きE2Eタスクファイルの作成
- 02フロントエンドのdata-testid契約が必須
- 03デスクトップ、タブレット、モバイルの網羅計画
- 04成功、エラー、URL単位のRBACシナリオ
- 05Cypressのパスと検証基準の指定
活用シーン
- 01フロントエンド機能タスク後のE2E網羅計画
- 02URLごとのアクセス制御動作の確認
- 03デバイスサイズ別のCypressスペック整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill e2e-test-generatorインストール後、Claude Code で/e2e-test-generatorを入力して読み込まれたか確認します。
同梱ファイルevals/evals.json
詳細
E2E テストタスクジェネレーター
計画フェーズのスキル:E2E タスクの Markdown を作成します。実行フェーズ:create-e2e-tests。
境界
| フェーズ | スキル |
|---|---|
| 計画(タスクファイル) | e2e-test-generator |
| 実装(Cypress コード) | create-e2e-tests |
ハーネスの検出
{harness}/rules/e2e-tests-rules.mdc と frontend-rules.mdc が存在する場合は読み込みます。
入力
- 対象とする機能
- data-testid の契約が記載されたフロントエンド実装タスク
- 契約がない場合 → 停止し、フロントエンドタスクの更新を依頼します
E2E プロジェクトの場所
デフォルト(グリーンフィールド):{product_root}/tests-e2e/ — 独立した Node パッケージです。以下のパスはこのルートからの相対パスです。
ブラウンフィールド:検出した Cypress ルート(tests-e2e/、旧 testes-cypress/、または frontend/)を使用します。E2E がまだ存在しない場合は、新しい spec を frontend/cypress/ に作成する計画を立てないでください。
出力の要点
タスクファイルには、以下を含める必要があります。
- 概要と詳細なカバレッジ戦略
- E2E ルート —
tests-e2e/(または検出したブラウンフィールドのパス) - data-testid 契約テーブル(フロントエンドタスクからコピーし、独自に作成しないでください)
tests-e2e/cypress/e2e/device/{desktop|tablet|mobile}/[feature]/配下の spec パス(ブラウンフィールドの場合はプレフィックスを調整)tests-e2e/cypress/support/commands/配下のコマンドファイル —shared/、pages/、device/- プロジェクトに E2E がまだない場合のブートストラップに関する注記:実行担当者は spec の作成前に
create-e2e-testsの Phase 0 を実行する必要があります - 成功、エラー、およびURL による RBACのシナリオ
- デバイスカバレッジマトリックス
- 検証基準:固定値の
cy.wait(N)を使用しないこと、spec 内でコマンドから DOM を操作しないこと、@smoke/@regressionタグを付けること
依存関係
同じ機能のフロントエンド実装タスクに依存します。
Docker に関する注記
E2E をコンテナー内で実行する場合、API URL にはコンテナー内の localhost ではなく、ホストゲートウェイ経由の URL を使用してください(インフラルールがある場合はそのルールに従います)。
関連スキル
create-e2e-tests— Cypress コードの作成/リファクタリングtask-generator— testid 契約付きのフロントエンドタスク
コメント
Markdown 対応