sentry-pr-code-review

sentry-pr-code-review について

Sentry の Bug Prediction 機能を通じて、GitHub のプルリクエストに対して Seer by Sentry がコードレビューコメントとしてフラグ付けした問題を検証および修正するためのワークフローです。誰かが PR 上の Sentry または Seer のコメントのレビューや対応を依頼し、それらの発見事項を解決する場合、または未解決の Sentry フィードバックをまだ保持している最近の PR を特定する必要がある場合に、適切なツールとなります。このスキルはより広範な Sentry ワークフローツリーの一部分であり、単独でモデルを呼び出すことはできません。

gh CLI がインストールされ認証されており、リポジトリに Seer by Sentry GitHub App がインストールされていることが前提条件です。プロセスは 4 つのフェーズに分かれます。フェーズ 1 では、gh api を使用して PR コメントエンドポイントからレビューコメントを取得し、ボットのログイン名が seer-by-sentry[bot] に限定され、sentry[bot] や sentry-io[bot] は明示的に除外されます。また、PR 番号が指定されていない場合、最近のオープン状態の PR をスキャンして Seer コメントの数をカウントします。フェーズ 2 では、各マークダウンコメントからバグの説明、重大度と信頼性の行、および折りたたみ可能な詳細分析、提案された修正、AI エージェントへのプロンプトのセクションを解析します。フェーズ 3 では、引用された行のファイルを読み取って各問題を検証し、問題が現在も存在することを確認し、それが実際の問題か誤検知（フェールポジティブ）かを判断し、エッジケースや回帰リスクを考慮しながら修正を実装します。フェーズ 4 では、解決された項目とスキップされた項目の表形式で結果を要約します。

ドキュメントには、解析されたコメントの形式は安定した API 契約ではなく Seer の現在の出力を反映しているため、実際の構造は常に確認する必要があると記載されています。また、Seer レビューがトリガーされるタイミングについてもカバーしており、PR が「レビュー準備完了」状態になったとき、準備完了状態の PR に新しいコミットがプッシュされたとき、および手動の Sentry レビューコメントが行われた場合が含まれます。ドラフト PR はスキップされます。トラブルシューティングのガイダンスでは、コメントの欠落、ボット名不一致、および部分的な gh api 結果について取り上げており、参照表には型安全性、エラー処理、検証、設定などの一般的な問題カテゴリの一覧が記載されています。

よくある質問

このスキルを使用するための前提条件は何ですか？

gh CLI がインストールされ認証されている必要があり、リポジトリには Seer by Sentry GitHub App がインストールされている必要があります。

修正対象のコメントを識別するボットのログイン名はどれですか？

コメントは seer-by-sentry[bot] から送信されます。このスキルは、これが sentry[bot] や sentry-io[bot] ではないことを強調しています。

PR 番号を提供しなかった場合どうなりますか？

最近のオープン状態の PR を一覧表示し、各 PR 上の Seer コメントの数をカウントし、どの PR に未解決の Seer フィードバックがあるかを示します。

実際に変更を適用するかどうかをどのように判断しますか？

各問題について、引用された行のファイルを読み取り、現在コード内で問題がまだ存在することを確認し、それが実際の問題か誤検知（フェールポジティブ）かを評価し、その後、エッジケースや回帰リスクを考慮して修正を実装します。

プルリクエストに対して Seer はいつレビューを実行しますか？

PR が「レビュー準備完了」状態に設定されたとき、準備完了状態の PR にコミットがプッシュされたとき、および手動の Sentry レビューコメントが行われたときに、Seer は自動的にレビューを実行します。ドラフト PR はスキップされます。