sentry：把线上错误整理成可追查的问题清单（旧版独立 Skill）

线上告警多时，先弄清哪些错误仍在发生，比立即改代码更有用。sentry 让 Codex 查询指定项目的 Issue、查看事件并整理发生次数、最近出现时间和关联版本，适合值班交接或排查前收集证据。这个独立 Skill 的范围是只读观察；查询结果和 AI 根因建议仍需结合项目代码验证。

安装与准备

本文介绍 openai/skills 保留的独立 Skill 版本。该仓库已弃用，当前官方示例转至 openai/plugins；这里的步骤对应本页链接的旧仓库版本，不代表最新插件。

在 Codex 对话框输入下面这一行；它不是终端命令。安装后若找不到该 Skill，重启 Codex 再试。

提示词

$skill-installer sentry

能访问目标组织和项目的 Sentry 账号
安装 cli.sentry.dev 介绍的 sentry CLI；不能用旧 sentry-cli 命令替代
目标项目、真实环境名称和明确的查询时间范围

先按 Sentry 官网准备 CLI，再在终端执行 sentry auth login，用 sentry auth status 检查登录。令牌应只在本地配置，不放进对话。CLI 可以从项目配置识别组织和项目，但第一次查询仍应核对识别结果。 ^[4]

第一次怎么用

填入项目与真实环境名称后，可以先检查最近一天：

提示词

$sentry
只读检查 Sentry 中 [组织]/[项目] 最近 24 小时的未解决 Issue，环境名称是 [填写 Sentry 中的真实值]，最多列出 10 项并按最近出现排序。先确认目标项目和筛选条件，给出标题、短编号、次数、最近出现时间及可用链接。再展开最值得排查的两项，列关联事件和版本；缺失字段明确标注。不要修改状态或代码，隐藏邮件地址和 IP，不粘贴原始堆栈。

接下来怎样推进

先锁定查询范围。 给出组织、项目、时间窗口和环境。production 与 prod 是两个不同的字符串，必须使用数据中真正存在的值。自动识别错项目时，显式指定组织/项目。
先看列表，再查事件。 让 Codex 用只读 Issue 查询获取概览，程序处理时使用 JSON。挑选具体短编号，例如 ABC-123，再查看详情与近期事件；不要把内部数字 ID 当作短编号。
把证据与推断分开。 结合最近出现时间、次数、版本与环境说明优先级。根因解释和修复计划只能作为待验证建议；先记录支持它的事件，再决定后续代码排查范围。

从告警走到可定位的事件

先给一个明确问题：“过去 24 小时，production 环境里的支付回调错误是否集中在某个发布版本？” 说明组织和项目；若 CLI 自动识别到错误项目，显式传入 组织/项目。使用 --json 读取 Issue 列表，再选一个短编号深入事件。短编号与内部数字 ID 不同，复制错误会导致查不到事件。

一个 Issue 聚合了多个事件，先看发生时间、版本、环境和近几条事件详情，再与发布记录对齐。注意 prod 和 production 是不同环境字符串，筛错环境可能让真实问题“消失”。访问不到项目时检查本地认证与权限，不要让用户把完整 token 发到对话里。

明确观察与解释的边界

输出应说明筛选条件、看到的事件数量或样本、关键错误栈、受影响版本以及下一步要检查的代码路径。CLI 或 AI 根因建议只是候选解释；如果日志没有足够上下文，应写“目前无法确认”，而不是声称已经找到原因。这个 Skill 只读查询，不会因为你看过 Issue 就自动修复或关闭它。

交付后先检查什么

应得到一份带查询范围的错误清单，以及少量重点 Issue 的事件摘要。抽查短编号和链接是否对应目标项目，次数与时间是否来自当前查询；时间窗口内没有结果时，应明确写出“无结果”，不能据此断言整个系统健康。保留脱敏后的必要上下文，避免整段复制事件载荷。

把反复出现的错误先归类

若同一类错误反复出现，别只看最晚的一条。可以先让这个只读 Skill 汇总一段时间内的相关 Issue 与事件，按异常原因分组，选一组对照代码和发布记录。Claire Vo 分享过让 Codex 从 Sentry 历史事件里归类编辑错误，再逐类修复、回看剩余事件的做法；那是更广的 Codex 工作流，并未说明使用本页 Skill。这里先把查询与证据整理好，代码修复和结果验证另行执行。

常见卡点

明明有错误却查不到。 先比较环境名称、时间窗口、项目和 unresolved 条件，尤其检查 production 与 prod 是否写反；一次只放宽一个筛选条件。

命令不存在或登录失败。 确认安装的是提供 sentry 命令的新 CLI，并检查登录状态与项目访问权限；不要把令牌粘贴给 Codex 排错。

摘要缺少次数或版本。 让它读取相应详情或事件；字段不可用就保留缺失说明，不从标题猜测数值。

建议看起来像确定根因。 要求列出所依赖的事件、代码位置和未验证假设。只读查询本身并没有证明修复有效。