リファレンス

トラブルシューティング

以下から症状を探してください。各表では、最もよくある原因を先に、まれな原因を後に挙げています。

プルリクエストが自動でレビューされなかった

最新コミットの HeyDeer Review チェックに理由が表示されます。タイトルは「レビューをスキップしました」（問題が見つかった場合はチェックを失敗にするがオンの場合は「レビューが必要です」）で始まり、その後に理由が続きます。チェックがない場合は、HeyDeer Review チェックが表示されないを参照してください。

GitHub チェックを公開がオフの場合、PR がPR ごとの自動レビュー上限に達したとき、または HeyDeer がレビューを実行できないときは、HeyDeer が代わりに PR にコメントします。コメントは理由ごとに1回です。これらのコメントは、PR にレビューコメントを投稿がオンの場合にのみ投稿されます。

考えられる原因	対処方法
レビューのタイミングが手動のみになっています。	PR ごとに 1 回またはプッシュごとを選択します。自動レビューを参照してください。
プルリクエストが自動レビューのフィルターに一致していません。デフォルトではドラフト、フォーク、依存関係の更新がスキップされます。	レビュー可能に変更するか、フィルターを変更するか、`@heydeer review` とコメントします。
同時実行枠が使用中のため、レビューは待機しています（レビュー待機中）。	しばらく待ちます。
「PR ごとに 1 回」ですでにレビューが成功したか、PR が「PR ごとの自動レビュー上限」に達しています。	`@heydeer review` とコメントします。
ワークスペースのクレジットがなくなったか、使用量の上限に達しました。	次回の無料クレジットの付与を待つ、有料プランを選ぶかクレジットを追加する、または使用量と請求 → 概要 → 支出の管理で上限を引き上げる、のいずれかを行ってから、新しいレビューを依頼します。自動チャージと使用量の上限を参照してください。
このプルリクエストの自動レビューが一時停止されています。	`@heydeer resume` とコメントします。
そのコミットはすでにレビュー済みです。ラベルの付け替えや再オープンでは再度レビューされません。	新しいコミットをプッシュするか、`@heydeer review` とコメントします。
HeyDeer の GitHub へのアクセス権にリポジトリが含まれていません。	ワークスペース設定 → GitHub 接続を確認します。GitHub App と権限を参照してください。
このリポジトリは、別のワークスペースの無料クレジットに紐づいています。	プランを選択してから、レビューを依頼します。

チェックが失敗した、またはレビューが完了しなかった

チェックのタイトル	原因	対処方法
レビューで対応が必要な問題が見つかりました	問題が見つかった場合はチェックを失敗にするがオンの状態で、レビューが指摘事項または未解決の以前の問題を報告しました。	修正してプッシュします。見送るには、書き込み権限を持つ人が判断の理由を説明するか会話を解決済みにしてから、`@heydeer review` とコメントします。
レビューはキャンセルされました	誰かがレビューをキャンセルしたか、プルリクエストがクローズされたか、新しいプッシュによって置き換えられました。	もう一度レビューを依頼します。
レビューが完了していません	リポジトリのチェックが実行されなかったか、以前の問題が再確認されませんでした。	もう一度レビューを依頼します。
レビューに失敗しました / レビューがタイムアウトしました	レビューが完了しませんでした。コネクタを呼び出していない限り、HeyDeer はクレジットを返還します。	もう一度レビューを依頼します。
レビューを実行できませんでした	GitHub または HeyDeer が利用できませんでした。	もう一度レビューを依頼します。
レビュー対象のファイルがありません	変更されたファイルがすべて、自動生成ファイルなどのレビュー対象外のファイルです。	対応は不要です。

すべての結論は HeyDeer Review チェックに一覧があります。

HeyDeer がプルリクエストを承認しなかった

自動承認がオンの場合、HeyDeer のレビューページに自動承認されませんでしたと理由が表示されます。すべての要件は自動承認に記載されています。

考えられる原因	対処方法
自動承認がオフになっています（デフォルト）。	レビュールールの結果の公開で自動承認をオンにします。自動承認をオンにするを参照してください。
指摘事項または以前の問題が残っています。	修正してプッシュするか、見送ります。深刻度「低」の指摘事項だけが残っている状態で承認させるには、残っていてもよい問題を深刻度「低」の問題を許可に設定します。
HeyDeer が承認できる PR：プルリクエストのリスクレベルが設定を上回っています。	人が GitHub で承認します。レビューにはリスクレベルとその理由が記載されます。このようなプルリクエストも HeyDeer に承認させるには、HeyDeer が承認できる PRでより高いレベルを選びます。
要確認：コードからは答えられない質問が HeyDeer にあります。	`@heydeer review` を含む新しい PR コメントで回答します。不足しているコンテキストを補うを参照してください。
レビューにレビューの注意事項があります（リポジトリのチェックが実行されなかった場合など）。	注意事項に記載された問題を解決してから、もう一度レビューを依頼します。
以前の問題を十分に確認できませんでした。	もう一度レビューを依頼します。
PR にレビューコメントを投稿がオフになっています。	オンにします。HeyDeer はレビューを投稿することで承認します。

プルリクエストが変更された場合、ドラフトの場合、または HeyDeer が作成した場合

考えられる原因	対処方法
レビュー後に新しいコミットがプッシュされたか、ベースブランチが進みました。	最新コミットのレビューを依頼するか、レビューを待ちます。
プルリクエストがドラフトです。	レビュー可能な状態に変更してから、レビューを依頼します。
修正 PR など、HeyDeer がプルリクエストを作成しました。	人が承認する必要があります。

HeyDeer Review チェックが表示されない

考えられる原因	対処方法
リポジトリが「手動のみ」で、一度もレビューされていません。	レビューを依頼します。以降のリビジョンにはチェックが作成されます。
リポジトリでGitHub チェックを公開がオフになっています。	オンにします。結果の公開を参照してください。
HeyDeer に GitHub の Checks の読み取り・書き込み権限がないか、HeyDeer の GitHub へのアクセス権にリポジトリが含まれていません。	GitHub のオーナーが、ワークスペース設定 → GitHub 接続で権限リクエストを確認またはリポジトリを追加を選択します。
プルリクエストがクローズされています。	再オープンします。

コマンドに返信がない、またはエラーになる

考えられる原因	対処方法
返信も 👀 リアクションもない：コマンドがコード、引用ブロック、HTML コメントの中にある、編集で追加された、またはボットが投稿したことが原因です。	個人アカウントから、新しい PR コメントまたはインラインレビューコメントの任意の位置に、コマンドを通常のテキストとして投稿してください。
書き込み権限がないか、手動レビューの権限に含まれていません。	管理者、またはアクセス権を持つ人に依頼します。
クレジットが不足しているか、使用量の上限に達しています。	プランを選択するかクレジットを追加するか、上限を引き上げてから、もう一度コマンドを投稿します。
リクエストが多すぎるか、レビューキューがいっぱいです。	しばらく待ってから、もう一度コマンドを投稿します。
👀 が付かない：HeyDeer に、PR コメントに必要な Issues の読み取り・書き込み権限、またはインラインレビューコメントに必要な Pull requests の読み取り・書き込み権限がない可能性があります。	GitHub のオーナーが、ワークスペース設定 → GitHub 接続で権限リクエストを確認を選択し、GitHub で承認します。
クローズされたプルリクエストでの `pause` または `resume`。	これらはオープンなプルリクエストでのみ使えます。
GitHub が利用できませんでした。	新しいコメントでもう一度コマンドを投稿します。

すべてのコマンドはPR コメントのコマンドに記載されています。

規約やチェックが無視されているように見える

考えられる原因	対処方法
チェックのパターンが変更されたどのファイルにも一致しない、フロントマターに `files` がない、またはファイルが `.agents/checks/` 直下の .md ファイルではありません。	フロントマターまたはパターンを修正するか、ファイルを移動します。リポジトリのチェックを参照してください。
指摘事項がフィードバックの範囲外でした。	「バランス」または「網羅的」を試します。フィードバックの範囲を参照してください。
AGENTS.md の規約が、変更されたファイルを対象としないディレクトリにあります。	移動します。AGENTS.md を参照してください。
REVIEW.md が、変更されたファイルを対象としないディレクトリにあります。	移動します。REVIEW.md を参照してください。
指示がレビューの依頼後に保存されたか、リポジトリの指示によって上書きされています。	もう一度レビューを依頼するか、矛盾を解消します。レビューへの指示を参照してください。
チェックが、コードを読むだけでは HeyDeer が検証できないことを求めています。	コードを読んで HeyDeer が検証できる条件として書き直します。効果的なチェックの書き方を参照してください。
`.gitattributes` でファイルに linguist-generated が指定されているか、ベースブランチにすでにあるロックファイルです。	属性を削除するか、ロックファイルに `-linguist-generated` を指定します。HeyDeer が読み込む情報を参照してください。

レビューに注意事項がある

HeyDeer は、レビューを制限した要因をレビューの注意事項に挙げます。注意事項があると、そのレビューでは自動承認が行われません。レビューの注意事項を参照してください。

注意事項	対処方法
一部の指摘事項が省略されました	表示された指摘事項を修正するか見送ってから、もう一度レビューを依頼します。
該当するリポジトリのチェックが多すぎます	チェックのファイルパターンを絞り込んでから、もう一度レビューを依頼します。リポジトリのチェックを参照してください。
一部のリポジトリのチェックが無効です	レビューの注意事項に記載されたチェックを修正してから、もう一度レビューを依頼します。リポジトリのチェックを参照してください。
一部のリポジトリのチェックを完了できませんでした	もう一度レビューを依頼します。
一部の指摘事項または以前の問題を十分に評価できませんでした	もう一度レビューを依頼します。

サインインと GitHub へのアクセス

考えられる原因	対処方法
GitHub のサインインの有効期限が切れ、HeyDeer にGitHub でサインインが表示されます。	それを選択すると、再度サインインして同じページに戻ります。
レビューや組織を閲覧できない GitHub アカウントでサインインしています。	GitHub で続行またはGitHub に再度サインインを選択し、GitHub で正しいアカウントを選択します。
接続時に組織またはリポジトリが表示されません。	組織は HeyDeer をインストールすると表示されます。GitHub でインストールまたは別のアカウントにインストールを選び、GitHub で組織を選択してください。HeyDeer をインストール済みの組織が表示されない場合は、必要に応じて GitHub で SSO でサインインし、アカウントが見つかりませんか？を開いてGitHub に再度サインインを選びます。GitHub App と権限を参照してください。

請求に関する問題

考えられる原因	対処方法
カードが拒否されたか、銀行から支払いの認証を求められました。	サブスクリプションの支払いの場合は、使用量と請求 → 概要で支払いを完了を選択します。その他の購入の場合は、別のカードを使います。
クレジットを追加でプランが必要と表示されます。	先にプランを選択するか、「概要」に支払いを完了が表示されている場合はそれを選択します。プランと追加クレジットを参照してください。
自動チャージがオフになっており、その下に理由が表示されています。	原因を解決してから、再びオンにします。自動チャージに失敗した場合を参照してください。
更新の支払いを処理中です。	その間もプランは有効なままです。支払いが失敗した場合や銀行の確認が必要な場合は、HeyDeer からワークスペースにメールが送信されます。支払いを完了を選択してください。
支払いがまだ処理中であるか、クレジットを追加で以前の購入を確認するよう求められます。	結果が表示されるまで購入を確認を選択します。別の購入は開始しないでください。
「クレジットを追加」または自動チャージで、購入上限に達したと表示されます。	しばらくしてから再試行するか、HeyDeer にお問い合わせください。
支払いと新規の有料レビューを停止しています。	HeyDeer がワークスペースの請求に関する問題を解決中です。HeyDeer にお問い合わせください。

コネクタの問題

コネクタを管理できるのは、GitHub オーナーまたはアカウントオーナーと表示された管理者だけです。コネクタを参照してください。

考えられる原因	対処方法
HeyDeer がツールを読み込めません。	エンドポイントがサーバーの公開 Streamable HTTP アドレスであること、ヘッダーに有効な認証情報が含まれていることを確認してください。
有効な有料プランがない場合、レビューとタスクでコネクタは使われません。	コネクタは有料プランで利用できます。プランを選択すると、保存済みのコネクタが新しいレビューとタスクに適用されます。
コネクタを保存する前にレビューまたはタスクが開始されました。	設定は、保存後に開始されたレビューとタスクに適用されます。新しく開始してください。
レビューまたはタスクのページで、コネクタが利用不可と表示されます。	リポジトリが公開されているか、変更がフォークまたは書き込み権限のない人によるものです。公開リポジトリとフォークにもは、公開データにだけ選択してください。
レビューでコネクタのツールが 1 つも使われませんでした。	レビューが呼び出すのは、許可された読み取り専用ツールだけです。「読み取り専用ツール」でツールを許可するか、サーバーの提供元に読み取り専用ツールを明示するよう依頼してください。
コネクタを呼び出した後にレビューが失敗しました。	そのレビューのクレジットは返還されません。新しいレビューを依頼します。