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 会被跳过。