heydeer ログイン
リファレンス

トラブルシューティング

症状を見つけ、考えられる原因を上から順に確認してください。

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

最新コミットの HeyDeer Review チェックに理由が表示されます。タイトルは Review skipped、または「問題が見つかった場合はチェックを失敗にする」がオンの場合は Review required です。チェックがない場合は、HeyDeer Review チェックが表示されないを参照してください。

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

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

チェックのタイトル原因対処方法
Review found issues that need attention「問題が見つかった場合はチェックを失敗にする」がオンの状態で問題が見つかりました。問題を修正してプッシュするか、指摘事項を解決します。
Review incompleteリポジトリのチェックまたは以前の指摘事項が評価されませんでした。もう一度レビューを依頼します。
Review could not runベースブランチの .agents/checks の設定が無効です。修正してから、レビューを依頼します。
Review could not runPR の議論が大きすぎます（レビュースレッドが 200 件超、1 つのスレッドのコメントが 1,000 件超、または約 180 KB 超）。新しいプルリクエストで作業を続けます。
Review could not runGitHub または HeyDeer が利用できませんでした。もう一度レビューを依頼します。
Review failed、Review timed outレビューが完了しませんでした。HeyDeer 側の障害による場合、クレジットは返還されます。もう一度レビューを依頼します。
Review cancelled誰かがレビューをキャンセルしたか、プルリクエストがクローズされたか、新しいプッシュによって置き換えられました（「プッシュごと」）。もう一度レビューを依頼します。
No reviewable files変更されたファイルがすべて、自動生成ファイルなどのレビュー対象外のファイルです。対応は不要です。

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

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

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

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

考えられる原因対処方法
返信なし：コメントにコマンド以外の内容が含まれている、コマンドが編集で追加された、またはボットが投稿した。個人アカウントから、コマンドだけを記載した新しいコメントを投稿します。
返信なし：GitHub App に Issues の読み取り権限がない。GitHub で承認します。
書き込み権限がないか、「手動レビューを実行できるユーザー」に含まれていません。管理者、またはアクセス権を持つ人に依頼します。
リクエストが多すぎるか、レビューキューがいっぱいです。しばらく待ってから、もう一度コマンドを投稿します。
クローズされたプルリクエストでの pause または resume。これらはオープンなプルリクエストでのみ使えます。
クレジットが不足しているか、使用量の上限に達しています。クレジットを追加するか上限を引き上げてから、もう一度コマンドを投稿します。
GitHub が利用できませんでした。新しいコメントでもう一度コマンドを投稿します。

HeyDeer は質問には回答しません。PRコメントのコマンドを参照してください。

レビューに警告が表示される

警告があると、そのレビューでは自動承認が行われません。

警告対処方法
10 個を超えるチェックが一致し、ファイル名順で最初の 10 個だけが実行されました。パターンを絞り込むか、ファイル名を変更します。リポジトリのチェックを参照してください。
プルリクエストが .agents/ を変更しており、新しいチェックの設定が無効です。マージする前に修正してください。修正しないと、そのブランチでのレビューが停止します。
確信度の低い指摘事項が省略されました。1 回のレビューで保持される指摘事項は最大 30 件です。表示された指摘事項に対応してから、もう一度レビューを依頼します。
一部の指摘事項またはスレッドの評価が不完全でした。もう一度レビューを依頼します。

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

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

MCP サーバーのエラー

フォームに、拒否された各値の理由が表示されます。MCPサーバーを参照してください。エンドポイントを変更した後は、新しいトークンを入力するか、保存済みのトークンを削除してください。サーバーを管理できるのは、GitHub 組織またはアカウントのオーナーであるワークスペース管理者だけです。

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

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

請求に関する問題

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