自動レビュー
HeyDeer がプルリクエストを自動でレビューするかどうかと、その頻度を選びます。新しいワークスペースは手動のみで始まります。セットアップした人が初めて HeyDeer を開くとプッシュごとに切り替わり、変更できるようにその設定が表示されます。それまでは、HeyDeer は誰かがレビューを依頼したときだけレビューします。
レビューのタイミング
| タイミング | 動作 |
|---|---|
| 手動のみ | HeyDeer は、誰かがレビューを依頼したときだけレビューします。依頼は HeyDeer から、PR コメントで、またはチェックの「このリビジョンをレビュー」から行えます。 |
| PR ごとに 1 回 | HeyDeer は、フィルターに一致する PR を、レビューが1回成功するまでレビューします。 |
| プッシュごと | HeyDeer は、プルリクエストが初めてフィルターに一致したときにレビューし、その後はコミットが追加されるプッシュのたびにレビューします。 |
自動レビューを有効にする
- ワークスペース設定 → レビュールールを開きます。
- レビューのタイミングで、PR ごとに 1 回またはプッシュごとを選びます。
- ワークスペースのレビュールールを保存を選択します。
特定のリポジトリで別のタイミングを使うには、そのリポジトリのレビュールールで変更します。設定の仕組みを参照してください。
対象となるプルリクエスト
タイミングの設定は、自動レビューのフィルターに一致するプルリクエストにのみ適用されます。デフォルトでは、HeyDeer はドラフト、フォークからのプルリクエスト、Dependabot や Renovate などのボットによる依存関係の更新をスキップします。自動レビューのフィルターを参照してください。
特定のプルリクエストで自動レビューを停止するには、@heydeer pause とコメントします。PR コメントのコマンドを参照してください。
PR ごとに 1 回
- 自動か依頼によるものかにかかわらず、成功したレビューが 1 回あれば「PR ごとに 1 回」の回数を使い切ります。指摘事項が報告された場合も同じです。
- 失敗したレビューとキャンセルされたレビューは数えられません。1 回成功するまでは、新しいプッシュがあると未完了の自動レビューが置き換えられます。
- 成功後は、プッシュしてもプルリクエストを再オープンしてもレビューは開始されません。もう一度レビューするには、
@heydeer reviewとコメントします。
プッシュごと
新しいプッシュは未完了の自動レビューを最新コミットのレビューに置き換えます。
デフォルトでは、2 回目以降のレビューは前回のレビュー以降の変更だけを対象にします。フォローアップレビューを参照してください。
PR ごとの自動レビュー上限
プッシュごとの場合、成功した自動レビューが初回を含めてこの回数に達すると、HeyDeer はそのプルリクエストの自動レビューを停止します。デフォルトは 5 回で、1、2、3、5、10、20、無制限から選べます。
依頼したレビューは「PR ごとに 1 回」では数えられますが、この上限には数えられません。上限に達した後もレビューを依頼できます。
PR がクローズされたら自動レビューを停止
デフォルトでオンです。プルリクエストがクローズまたはマージされると、HeyDeer は待機中および実行中の自動レビューを停止します。自分で依頼したレビューは引き続き実行されます。