名称: sentry 描述: 当用户要求检查Sentry问题或事件、总结最近的生产错误或通过Sentry API拉取基本Sentry健康数据时使用；使用捆绑脚本执行只读查询并需要`SENTRY_AUTH_TOKEN`。元数据: 作者: github.com/openai/skills 版本: ‘1.0.0’

Sentry（只读可观测性）

快速入门

如果尚未认证，请用户提供有效的SENTRY_AUTH_TOKEN（只读范围如project:read、event:read）或在运行命令前登录并创建一个。
设置SENTRY_AUTH_TOKEN为环境变量。
可选默认值：SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。
默认值：组织/项目 {your-org}/{your-project}，时间范围 24h，环境 prod，限制20（最大50）。
始终调用Sentry API（无启发式，无缓存）。

如果令牌缺失，给用户这些步骤：

创建Sentry认证令牌：https://sentry.io/settings/account/api/auth-tokens/
创建具有只读范围的令牌，如project:read、event:read和org:read。
在系统中设置SENTRY_AUTH_TOKEN为环境变量。
如果需要，指导他们根据操作系统/Shell设置环境变量。

永远不要要求用户在聊天中粘贴完整令牌。请他们本地设置并确认就绪。

核心任务（使用捆绑脚本）

使用scripts/sentry_api.py进行确定性API调用。它处理分页并在瞬时错误上重试一次。

技能路径（设置一次）

export AGENT_SKILLS_HOME="${AGENT_SKILLS_HOME:-$HOME/.agent-skills}"
export SENTRY_API="$AGENT_SKILLS_HOME/skills/sentry/scripts/sentry_api.py"

用户范围的技能安装在$AGENT_SKILLS_HOME/skills下（默认：~/.agent-skills/skills）。

1) 列出问题（按最近排序）

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"

2) 解析问题短ID到问题ID

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

使用返回的id进行问题详情或事件。

3) 问题详情

python3 "$SENTRY_API" \
  issue-detail \
  1234567890

4) 问题事件

python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20

5) 事件详情（默认无堆栈跟踪）

python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

API要求

始终使用这些端点（仅GET）：

列出问题：/api/0/projects/{org_slug}/{project_slug}/issues/
问题详情：/api/0/issues/{issue_id}/
问题事件：/api/0/issues/{issue_id}/events/
事件详情：/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

输入和默认值

org_slug、project_slug：默认为{your-org}/{your-project}（避免非生产组织）。
time_range：默认24h（作为statsPeriod传递）。
environment：默认prod。
limit：默认20，最大50（分页直到达到限制）。
search_query：可选query参数。
issue_short_id：首先通过list-issues查询解析。

输出格式化规则

问题列表：显示标题、短ID、状态、首次出现、最后出现、计数、环境、顶部标签；按最近排序。
事件详情：包括罪魁祸首、时间戳、环境、发布、URL。
如果没有结果，明确声明。
在输出中编辑PII（电子邮件、IP）。不要打印原始堆栈跟踪。
永远不要回显认证令牌。

黄金测试输入

组织：{your-org}
项目：{your-project}
问题短ID：{ABC-123}

示例提示：“列出过去24小时内生产环境的Top 10未解决问题。” 预期：有序列表，带有标题、短ID、计数、最后出现。

名称: sentry 描述: 当用户要求检查Sentry问题或事件、总结最近的生产错误或通过Sentry API拉取基本Sentry健康数据时使用；使用捆绑脚本执行只读查询并需要SENTRY_AUTH_TOKEN。 元数据: 作者: github.com/openai/skills 版本: ‘1.0.0’