ui-test-cypress

Cypress UI テスト（英語）

中国語版： 対応する中国語版スキルを参照してください。

使用する場面

• Cypress の UI テストワークフローに取り込む出力が必要な場合。
• プロジェクトですでに Cypress を使用している場合、または Cypress 対応の計画を求めている場合。

出力形式の選択肢

リクエストで別の形式が明示的に指定されていない限り、デフォルトは Markdown です。

使用方法

1. prompts/ui-test-cypress.md を開き、メインプロンプトとして使用します。
2. スコープ、環境、制約、リスク、依存関係、期待する成果物など、実際のプロジェクトのコンテキストを追加します。
3. 入力が不完全な場合は、利用可能な初版を返し、不足情報と前提を明記します。

参考ファイル

• ドメイン上の結果、有効なコントロール、または証拠の不足を調整する際は、サニタイズ済み入力、項目ごとのオラクル、再現可能な計算について、references/domain-decision-example.md を参照してください。

• prompts/ui-test-cypress.md：このスキルのメインプロンプト。

• references/framework-spec.md：ツール固有の構成とカバレッジに関する注意事項。

• references/setup-and-ci.md：セットアップ、実行、CI に関する注意事項。

• examples/sample-context.md：リクエストコンテキストのサンプル。

• scripts/run-tests.sh：軽量なローカル実行のエントリーポイント。

ドメイン実行の要点

1. プロジェクトの成果物から、Cypress、Node、ブラウザー、設定、コンポーネント／E2E のスコープを確認します。暗黙のアップグレードやレガシー形式の混在を避け、互換性のある設定、カスタムコマンド、テスト仕様、CI コマンドを生成します。
2. 実際のページ／コンポーネントのロジックをテストします。cy.intercept は、確認済みの外部境界のみを置き換えます。レスポンスのスタブだけでは、ビジネス上の事後条件を証明できません。分離されたフィクスチャデータとセッションのクリーンアップを定義します。
3. 再試行可能なクエリ／アサーション、一度だけ実行するアクション、テスト全体の再試行を分けます。sleep ではなく、エイリアス付きリクエストや観測可能な状態を待ちます。最初の失敗を保持し、効果が繰り返し発生しないようにします。
4. 有料状態、金額、元本について、最小限のアプリで正／負のコントロールを実行します。タイトルが正しくてもビジネス状態が誤っていれば、アサーションと CI は失敗しなければなりません。スクリーンショット／動画／失敗情報、ティアダウン、実際の実行証拠を保持します。ファイルだけでは何も証明できません。

よくある落とし穴

• スコープが曖昧で、コンテキストがない場合は使用しないでください。
• すべての領域を同じ重要度として扱わないでください。
• 前提と不足情報を省略しないでください。

ベストプラクティス

• まずプロンプトファイルを起点とし、重要なコンテキストだけを追加します。

• リスクを重視し、実行可能な出力にします。

• リクエストが不完全な場合は、利用可能な初版を返し、不足点を明記します。

• 生成されたビジネスアサーション、失敗の伝播、または分離を検証するには、evals/fixtures/checkout-app/README.md と、そのローカルの good/bug/timeout コントロールを参照してください。実行を依頼された場合に限り、実行します。