自動レビューのフィルター
自動レビューのフィルターは、HeyDeer が自動でレビューするプルリクエストを決めます。自分で依頼したレビューは制限されません。PR コメントのコマンドを参照してください。
フィルターの仕組み
自動レビューのフィルターは、ワークスペース設定 → レビュールールのレビューのタイミング、またはリポジトリのレビュールールタブにあります。レビューのタイミングが手動のみでない限り編集できます。
各行は、項目、演算子（次のいずれか、次のいずれでもない、ラベルなし）、値で構成されます。プルリクエストは、すべての行に一致した場合にのみ対象になります。ラベルとユーザー名では大文字と小文字は区別されません。
| 項目 | 値 |
|---|---|
| PR ラベル | ラベル名 |
| 作成者 | GitHub のユーザー名（alex、dependabot[bot] など） |
| 作成者のチーム | 組織内のチーム（子チームを含む） |
| 作成者と組織の関係 | 組織のメンバー、外部コラボレーター（リポジトリへのアクセス権はあるが組織のメンバーではない）、その他の外部作成者 |
| 作成者のアカウント | ユーザー、ボット（GitHub App とボットアカウント） |
| PR の状態 | ドラフトである、ドラフトではない |
| PR のソース | 同じリポジトリ、フォーク |
作成者のチームと作成者と組織の関係は組織のワークスペースでのみ利用でき、GitHub App に組織の Members 権限が必要です。HeyDeer がメンバーシップを確認できない場合、自動レビューは開始されません。
デフォルトのフィルター
新しいワークスペースは、PR の状態 → ドラフトではない、PR のソース → 次のいずれか → 同じリポジトリ、作成者 → 次のいずれでもない → dependabot[bot]、renovate[bot]、pre-commit-ci[bot]、snyk-io[bot]、snyk-bot の 3 行で始まるため、HeyDeer はドラフト、フォーク、依存関係の更新をスキップします。行がない場合は、すべてのプルリクエストが対象になります。
依存関係の更新は主にバージョンとロックファイルを変更するもので、レビューよりもテストのほうが適切に確認できます。それでもレビューしたい場合は、その PR に @heydeer review とコメントします。コーディングエージェントなど、ほかのボットによるプルリクエストは通常どおりレビューされます。
リポジトリのフィルター
| 条件の参照元 | 動作 |
|---|---|
| ワークスペースのフィルターに従う | ワークスペースの行が適用され、ここで追加する行は対象となるプルリクエストをさらに絞り込むことしかできません。 |
| このリポジトリで個別に設定 | リポジトリの行がワークスペースの行を置き換えます。最初はワークスペースの行のコピーから始まります。フィルターを緩めたい場合に使います。 |
ワークスペースのフィルターに戻すを選ぶと、リポジトリの行が削除されます。
設定例
各設定例は、デフォルトの行を残したままにすることを前提としています。
| 目的 | 行 |
|---|---|
| すべてのボットをスキップ | 作成者のアカウント → 次のいずれでもない → ボット |
| さらにボットをスキップ | 「作成者」の行に名前を追加（例：github-actions[bot]） |
| 依存関係の更新もレビューする | 「作成者」の行を削除 |
| ドラフトもレビューする | 「PR の状態」の行を削除 |
| 特定のラベルを必須にする | PR ラベル → 次のいずれか → ai-review |
| 特定のラベルをスキップ | PR ラベル → 次のいずれでもない → skip-review |
| 外部コントリビューターのみレビュー | 作成者と組織の関係 → 次のいずれか → 外部コラボレーター、その他の外部作成者。「PR のソース」の行を削除 |
| 特定のチームのみレビュー | 作成者のチーム → 次のいずれか → backend |