sentry-pr-code-review

關於 sentry-pr-code-review

用於審查和修復 Seer by Sentry 透過其 Bug Prediction（bug 預測）功能在 GitHub 拉取請求（pull requests）中以程式碼審查評論形式標記的問題的工作流。當有人要求審查或處理拉取請求（PR）上的 Sentry 或 Seer 評論、解決這些發現，或查詢仍帶有未解決 Sentry 反饋的近期 PR 時，這是合適的工具。該技能屬於更廣泛的 Sentry 工作流體系的一部分，不能單獨呼叫模型執行。

它依賴於已安裝並經過身份驗證的 gh CLI，以及已在倉庫中安裝的 Seer by Sentry GitHub 應用。該流程分為四個階段。第一階段透過 gh api 在 PR 評論端點獲取審查評論，篩選出機器人登入名為 seer-by-sentry[bot] 的評論，明確排除 sentry[bot] 或 sentry-io[bot]；當未提供 PR 編號時，掃描近期的開放 PR 以統計 Seer 評論數量。第二階段解析每個 markdown 評論，提取 bug 描述、嚴重性與置信度行，以及可摺疊的“詳細分析”、“建議修復”和“AI 代理提示”部分。第三階段透過讀取引用行處的檔案來驗證每個問題，確認問題在當前程式碼中仍然存在，判斷其是真實問題還是誤報，並在權衡邊緣情況和迴歸風險的同時實施修復。第四階段以表格形式總結結果，列出已解決與已跳過的專案。

文件指出，解析後的評論格式反映了 Seer 當前的輸出，而非穩定的 API 契約，因此應始終驗證實際結構。它還涵蓋了觸發 Seer 審查的場景，包括 PR 狀態變為“準備審查”、處於就緒狀態的 PR 有新提交，以及手動傳送的 sentry 審查評論；草稿 PR 會被跳過。故障排除指南解決了評論缺失、機器人名稱不匹配以及部分 gh api 結果等問題，參考表格列出了常見問題類別，如型別安全、錯誤處理、驗證和配置。

常見問題解答

使用此技能的前提條件是什麼？

必須安裝並經過身份驗證 gh CLI，且倉庫中已安裝 Seer by Sentry GitHub 應用。

哪個機器人登入名用於標識需要修復的評論？

評論來自 seer-by-sentry[bot]；該技能強調這並非 sentry[bot] 或 sentry-io[bot]。

如果我不提供 PR 編號會發生什麼？

它將列出近期的開放 PR，並統計每個 PR 上的 Seer 評論數量，報告哪些 PR 帶有未解決的 Seer 反饋。

它如何決定是否實際應用修復？

對於每個問題，它會讀取引用行處的檔案，確認當前程式碼中問題仍然存在，評估其是真實問題還是誤報，然後在考慮邊緣情況和迴歸風險的同時實施修復。

Seer 何時對拉取請求執行審查？

當 PR 狀態設定為“準備審查”或在其就緒狀態下推送提交時，以及收到手動 sentry 審查評論時，Seer 會自動執行審查；草稿 PR 會被跳過。