sentry

sentry skill 概览

sentry skill 是一个只读的 Observability 工具，专门用于快速排查 Sentry 数据：issues、events、健康信号，以及大致的生产影响。它最适合想直接回答“哪里坏了、坏在哪、严重到什么程度？”的人，而不用手动在 Sentry 里层层点击。和通用 prompt 相比，sentry skill 针对基于 CLI 的检查做了优化，所以在你需要最新数据、可重复查询和结构化输出时更可靠。

当你已经明确需要 Sentry 相关洞察，并且想要的是一份可落地的 sentry 排查指南，而不是泛泛的 Observability 概述时，就该用这个 skill。它很适合事故响应人员、检查回归问题的工程师，以及需要从实时 Sentry 数据里拿到简短、可验证总结的分析人员。

sentry skill 擅长做什么

它支持通过 sentry 命令进行只读调查，并默认偏向快速分诊：近期时间窗口、优先看生产环境过滤、以及便于下游处理的 JSON 输出。这个 skill 在你需要列出未解决问题、按短 ID 检查某个特定 issue，或拉取结构化数据且不想丢掉分页和认证处理时，尤其有用。

什么时候适合用这个 skill

如果你的任务依赖实时 Sentry 状态、需要可复现的查询，或者你预计会围绕 environment、project、时间范围或优先级反复调整过滤条件，那么就选 sentry skill。它也很适合想要一个可复用的 sentry Observability 工作流、并且后续可能被自动化或 agent 分析复用的场景。

安装前需要先知道什么

这个 skill 是只读的。它不会创建 issue、不会修改告警，也不会改动项目设置。最常见的使用阻碍是认证缺失、org/project 定位不清，或者把它拿去处理非 Sentry 数据。如果你需要写入操作或 dashboard，这不是合适的 skill。

如何使用 sentry skill

安装并完成认证

使用 npx skills add openai/skills --skill sentry 安装 sentry skill。如果本地还没有 CLI，先安装 Sentry CLI，然后通过 sentry auth login 或 SENTRY_AUTH_TOKEN 在本地完成认证。在请求调查工作之前，先用 sentry auth status 确认权限可用。不要把 token 直接粘贴到聊天里。

给 skill 正确的输入

想获得更好的 sentry 使用效果，提问时要同时给出明确的调查目标和范围。高质量输入通常会写清楚症状、环境和时间窗口，例如：“调查最近 24 小时内最新的生产 5xx 激增，并总结最主要的未解决 issues。”如果你知道 project，最好一并提供；如果不知道，可以先让自动识别尝试。CLI 往往可以根据 DSN、源代码、配置默认值和目录名推断 org/project。

先看对的文件和命令

先读 SKILL.md，再查看 agents/openai.yaml，了解默认行为和 prompt 组织方式。需要发现可用 endpoint 或字段时，用 sentry schema <resource>。如果你要机器可读结果，始终加上 --json，并配合 --fields 缩小输出噪音，让摘要更准确。

提升结果质量的实用工作流

一个稳妥的 sentry 指南式工作流是：先确认认证，再核实目标 org/project，然后跑一个窄范围的列表查询，最后查看一两个 issue 详情再做总结。比如，先从最近 24 小时内未解决的生产 issues 开始，如果第一轮范围太大，再按 release、environment 或 priority 继续收窄。这样可以让分析紧贴当前数据，避免被某个噪声事件带偏。

sentry skill 常见问题

sentry skill 需要 Sentry CLI 吗？

需要。sentry skill 是围绕 sentry CLI 设计的，不是浏览器工作流。如果本地还没有 CLI，先安装并完成认证。正是这套准备工作，让 sentry 安装后在可重复、只读调查上真正值得使用。

它和普通 prompt 有什么不同？

普通 prompt 也能描述 Sentry 查询，但 sentry skill 额外提供了明确的操作路径：认证预期、默认查询约定、JSON 输出和字段选择。这会减少猜测，也让结果更容易验证或自动化。

sentry skill 对新手友好吗？

友好，前提是用户能把问题说清楚。新手通常只要提供“哪里坏了、什么时候坏的、哪个环境出问题了”就能取得不错效果，而不必自己拼出精确的 CLI 查询。这个 skill 负责查询机制，用户只需要定义调查目标。

什么时候不该用它？

不要把 sentry skill 用在编辑 Sentry 配置、修改告警策略，或任何需要写权限的工作流里。如果你没有相关 org/project 的访问权限，或者你的问题其实是 Sentry 之外的应用日志，这个 skill 也不合适。

如何改进 sentry skill

提供更清晰的调查上下文

sentry skill 在你明确写出 environment、时间范围和关注症状时效果最好。相比“总结最近的错误”，“找出 2.4.1 发布后最近 6 小时内最主要的未解决生产错误”要强得多。更好的上下文会改善 issue 排序、减少误报，并帮助 agent 选择更合适的过滤条件。

要求结构化输出

如果你想要一份真正有用的 sentry Observability 结果，可以要求返回表格或项目符号摘要，并包含短 ID、标题、严重程度和大致影响。这样会把工作流引导到可执行的输出，而不是空泛叙述。如果你需要机器消费结果，就要求返回适合 --json 的字段，让响应保持紧凑且可解析。

通过收窄来迭代，而不是一味放大范围

如果第一轮结果太杂，就按 release、environment 或某个具体 issue short ID 继续收窄，而不是要求“把所有内容都列出来”。如果第一轮结果太少，先扩大时间窗口，再考虑移除过滤条件。最好的 sentry 使用方式，通常是先做一次聚焦查询，再做一次精确收敛，而不是一把梭的大搜索。