用途:该技能用于以只读方式访问 Sentry,检查 Sentry 问题、汇总生产环境错误并拉取健康数据,适用于用户说“check Sentry”或询问近期错误等场景。
主要能力:列出问题(按最近排序)、将问题短 ID 解析为问题 ID、查看问题详情、查看问题事件、查看事件详情(默认不含堆栈跟踪)。全部通过 Sentry API 的 GET 端点完成,不依赖启发式判断或缓存。
使用方式:需先认证。请用户自行创建只读权限的 SENTRY_AUTH_TOKEN(如 project:read、event:read、org:read),令牌创建地址为 https://sentry.io/settings/account/api/auth-tokens/,并将其设置为环境变量;不要让用户在聊天中粘贴完整令牌,只请其本地设置后确认。可选默认值包括 SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。
核心调用使用自带脚本 scripts/sentry_api.py,可处理分页并在瞬时错误时重试一次。设置技能路径: export AGENT_SKILLS_HOME="${AGENT_SKILLS_HOME:-$HOME/.agent-skills}" export SENTRY_API="$AGENT_SKILLS_HOME/skills/sentry/scripts/sentry_api.py" 常用命令包括 list-issues、issue-detail、issue-events、event-detail,参数涵盖 --org、--project、--environment、--time-range、--limit、--query。
默认值:org/project 为 {your-org}/{your-project},时间范围 24h(作为 statsPeriod),环境 prod,limit 默认 20、最大 50。
输出规则:问题列表显示标题、short_id、状态、first_seen、last_seen、计数、环境、top_tags,按最近排序;事件详情包含 culprit、timestamp、environment、release、url;无结果时明确说明;输出需对邮箱、IP 等 PII 脱敏,不打印原始堆栈跟踪,绝不回显认证令牌。
限制:仅只读,不能修改或解决 Sentry 问题;必须使用指定 GET 端点;缺少令牌时无法运行;不缓存、不做启发式推断。