用途:该技能用于只读查询 Sentry,检查 Issue 与事件、汇总近期生产错误、拉取基本健康数据,全部通过 Sentry API 完成,不做启发式推断、不做缓存。
主要能力:使用随附脚本 scripts/sentry_api.py 执行确定性 API 调用,处理分页并在瞬时错误时重试一次。支持列出 Issue(按最近排序)、将短 ID 解析为 Issue ID、查看 Issue 详情、查看 Issue 事件、查看事件详情(默认不含堆栈)。仅使用 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}/。
使用方式:先设置 SENTRY_AUTH_TOKEN(只读 scope,如 project:read、event:read、org:read),可选设置 SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。脚本路径示例: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";issue-detail;issue-events;event-detail。
默认值:org/project 为 {your-org}/{your-project},时间范围 24h,环境 prod,limit 默认 20、最大 50,分页直至达到 limit。
输出规则:Issue 列表显示 title、short_id、status、first_seen、last_seen、count、environments、top_tags,按最近排序;事件详情包含 culprit、timestamp、environment、release、url;无结果需明确说明;输出需脱敏邮箱与 IP,不打印原始堆栈,不回显令牌,也不要让用户在聊天中粘贴完整令牌。若令牌缺失,引导用户到 https://sentry.io/settings/account/api/auth-tokens/ 创建只读令牌并在本地设置环境变量。
限制:仅只读;依赖有效令牌与网络;适用场景与平台兼容性等更多信息暂未提供。