rhdh-test-placement

RHDH テストの配置

参考情報のみです。このスキルでは、永続的なテストをどこに配置すべきか、何を手本にすべきかを回答します。テストの作成や実行、ファイルの変更は行いません。基本ルールは、バグを実際に検出できる環境のうち、最も低コストのものを選ぶことです。プラグインの検証のほとんどにクラスターは不要で、Docker さえ必要としないケースも増えています。

前提条件：/grilling

配置の決定は単なる検索ではなく、トレードオフです。コスト、フィードバックにかかる時間、カバレッジの重複、各レイヤーが物理的に観測できることは、いずれも判断に影響します。また、相談者はたいてい、すでに希望する回答を持っています。

配置を提案する前に/grillingを呼び出し、そこで得られた制約を使用してください。/grillingがインストールされていない場合は、作業を止めて、このスキルが必要であることと、人間が次に実行すべき手順として/setup-rhdh-skills installを伝えてください。その間、配置を推測してはいけません。

対象範囲

対象範囲内	対象範囲外
恒久的なリグレッションテストまたはカバレッジテストの配置先	テストの作成または実行
どのリポジトリとレイヤーを選ぶか、および他を選ばない理由	テスト対象の不具合の修正
手本にする既存ファイル	使い捨ての再現テスト
各候補のおおよそのフィードバックコスト	RHDH の Jira テスト計画のレビュー

不具合を再現するための一時的なテストを作成し、その後削除するケースは、このスキルの対象ではありません。その作業は/rhdh-plugin-bug-fixが担当し、変更を引き渡す前にファイルを削除します。その後も残す恒久的なテストについては、こちらを利用してください。

結果に応じた手順

結果	読み込んで従うもの
リポジトリ、レイヤー、ハーネス、テンプレートを提案する	references/test-placement.md

references/test-placement.mdには、まず確認すべき状況についての質問、リポジトリの判断表、L1～L4bのレイヤー一覧、配置ごとの作成時の注意事項とコピー元ファイル、各レイヤーを実行するコマンド、現時点で不可能だと調査済みの項目が記載されています。

境界

• /grillingは必須の前提条件であり、省略できません。
• 配置が決まった後、推奨したテストの作成は/rhdh-plugin-authoringが担当します。
• 使い捨ての再現テストとその証拠は/rhdh-plugin-bug-fixが担当します。
• /rhdh-test-plan-reviewは、Jira にある RHDH リリーステスト計画をレビューします。これはリリース準備状況のレビューであり、配置に関する質問ではありません。

名前を指定してスキルを呼び出し、会話の中で作業の引き継ぎ内容を説明してください。他のスキルのファイルを開いてはいけません。

不変条件

• 推奨する前に、参照するすべてのパスが対象リポジトリの現在のデフォルトブランチに存在することを確認してください。この領域のハーネスは移動するため、ここに記載されているものの一部は、記載時点でまだレビュー中でした。
• テストの根拠は、検出できる障害にしてください。カバレッジ数値を根拠にしてはいけません。rhdhとrhdh-pluginsのどちらでもCodecovは参考情報であり、カバレッジの差分によってプルリクエストがブロックされることはありません。そのような根拠で主張されたテストは、レビューで却下されます。
• 複数のレイヤーで不具合を検出できる場合は、最も低コストのレイヤーを推奨し、下位のレイヤーで重複させないよう明示してください。
• rhdh-plugin-export-overlaysでUIレンダリングテストを推奨してはいけません。このリポジトリには、レンダリング対象となるアプリがありません。
• 答えが「適切な配置先がない」である場合は、そう伝えてください。障害を観測できない高コストなレイヤーを推奨するのは、何も推奨しないよりも悪い選択です。

完了条件

リポジトリ、レイヤーとハーネス、テストを配置するディレクトリまたはファイル、手本にする近接した既存ファイル、却下した各レイヤーとその理由を一行ずつ、およびおおよそのフィードバックコストを報告してください。テストは作成せず、ファイルも変更しないでください。