用途:该技能用于只读方式检查 Sentry 问题(issues)与事件(events),汇总近期生产错误,或通过 Sentry API 拉取基础健康数据。
主要能力:列出问题(按最近排序)、将问题短 ID 解析为问题 ID、查看问题详情、查看问题事件、查看事件详情(默认不含堆栈)。所有调用均走 Sentry API,不做启发式推断、不缓存。
使用方式:先准备只读权限的 SENTRY_AUTH_TOKEN(如 project:read、event:read、org:read),在 https://sentry.io/settings/account/api/auth-tokens/ 创建,并设置为环境变量;可选默认值 SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。不要将完整 token 粘贴到聊天中,请在本地设置后确认。核心任务使用捆绑脚本 scripts/sentry_api.py,它处理分页并在瞬时错误时重试一次。技能路径设置: export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}" export SENTRY_API="$CODEX_HOME/skills/sentry/scripts/sentry_api.py" 常用命令示例: python3 "$SENTRY_API" list-issues --org {your-org} --project {your-project} --environment prod --time-range 24h --limit 20 --query "is:unresolved" python3 "$SENTRY_API" issue-detail 1234567890 python3 "$SENTRY_API" issue-events 1234567890 --limit 20 python3 "$SENTRY_API" event-detail --org {your-org} --project {your-project} abcdef1234567890
默认与限制:org/project 默认 {your-org}/{your-project},时间范围默认 24h(statsPeriod),环境默认 prod,limit 默认 20、最大 50(分页直到达到上限)。仅使用 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}/。输出需脱敏 PII(邮箱、IP),不打印原始堆栈,不回显 token;无结果时明确说明。示例提示:“List the top 10 open issues for prod in the last 24h.”