SuperAPI AI 工具集

sentry

部署与运维

查看项目

更新于 10-21 12:51

技能介绍

Sentry Operations 技能用于在 harness 中执行实时的 Sentry 调查工作流。

用途 该技能面向 Sentry 的线上调查与操作,包括:问题(issue)、事件(event)、日志(log)、追踪(trace)、组织(org)、项目(project)、回放/深度链接、Sentry 产品功能使用情况、项目/团队配置、告警/监控器创建,以及 API 查询。它不适用于仓库、源代码、提交、分支或拉取请求相关工作,即使用户提到某个 Sentry 功能或产品领域。

主要能力

  • 通过 sentry CLI 执行结构化查询,解析或汇总结果时优先使用 --json。
  • 生成面向用户范围或特定实体的深度链接,而不是直接调用 CLI。
  • 按用户明确要求执行写操作,覆盖项目、团队、告警和监控器。
  • 在高层 CLI 命令无法覆盖请求时,使用 sentry api <endpoint> 作为回退。
  • 对指标告警优先使用 sentry alert metrics;仅当实时 CLI 帮助确认一等命令无法表达所需告警行为(例如动态异常检测)时,才使用 sentry api。

使用方式

  1. 确认操作与目标:确定操作类型;从频道配置解析组织(jr-rpc config get sentry.org);解析项目(jr-rpc config get sentry.project,可选,许多查询跨多个项目);若组织缺失且需要,询问用户。
  2. 若存在活跃仓库上下文(已克隆仓库或已配置 github.repo),在形成查询前检查仓库根目录的 TELEMETRY.md。存在时,将其查询配方、组织/项目映射和调查切入点作为仓库特定指导;用户明确指定的目标、ID、URL 和会话配置仍然优先。不存在时正常继续。
  3. 通过 CLI 执行:使用 sentry <command> 进行结构化查询;运行时为本技能认证 Sentry HTTP 流量,不要设置或打印令牌环境变量;选择命令形态、目标格式、标志、API 回退或故障排查行为时阅读 references/cli-commands.md;依赖沙箱凭据前阅读 references/sandbox-runtime.md。
  4. 在声明某个 Sentry 数据面不可用之前,先验证当前 CLI 帮助:运行 sentry --help 查看顶层命令组;在使用记忆中的命令形态前运行 sentry <command> --help 或 sentry help <command>;若记忆中的复数命令失败,先检查当前的单数命令组再阻塞,优先使用规范形式,如 sentry issue list、sentry org list、sentry log list、sentry trace list。
  5. 认证与权限错误处理:若 Sentry API 调用返回 401,或明确表示令牌无效、过期、撤销或未授权,重新运行一次真实的 Sentry 命令,让运行时在需要时触发重连流程;若明确表示缺少 scope、缺少 scopes 或 scope 不足,同样重新运行一次真实命令以触发重连;若返回通用 403、权限拒绝,或未指明缺失 scope 但表明缺少组织/项目访问权限,则停止并告知用户当前 Sentry 连接无法访问所请求的 Sentry 数据。仅当 CLI 或 API 错误明确点名某个 scope 时才提及该缺失 scope,不要从通用 403 猜测 scope 名称。
  6. 执行请求的写操作:阅读 references/cli-commands.md 了解写命令形态;在 API 写入前使用 sentry schema <resource> 确认当前端点和字段;解析精确的组织、项目、团队和成员 slug 或 ID,目标不明确时询问,不要猜测;先读取当前状态,遇到可能的重复项(例如相同 slug 的项目或团队)时停止并报告;仅修改用户要求的字段,不要重置或重写其他设置;先以 --dry-run 运行完整命令,再不带 --dry-run 运行一次;再次读取资源并报告变更内容(变更前 → 变更后)及 Sentry URL。对于破坏性或不可逆的变更(删除、从项目移除团队、slug 重命名或转移),确保用户在当前请求中明确点名了该确切操作。
  7. 生成深度链接:对于用户范围或特定实体的视图,生成 URL 而非 CLI 调用;阅读 references/deep-link-patterns.md 获取 URL 模板。
  8. 报告结果:内联返回问题详情、回放链接、深度链接或 CLI 输出;包含 Sentry Web URL 以便导航。

适用场景 适用于需要实时查询 Sentry 遥测、调查问题/事件/日志/追踪、查看组织与项目信息、生成 Sentry 深度链接,或在用户明确要求下修改 Sentry 项目、团队、告警与监控器配置的场景。

限制与护栏

  • 仅在用户要求该变更时才执行写操作。
  • 避免推测性的 Sentry CLI 子命令;使用捆绑参考文档加实时 sentry --help 输出验证当前命令。
  • 不要打印凭据值。
  • 组织缺失且需要时询问用户。
  • 链接到 Sentry Web UI 时优先使用深度链接而非原始数据转储。
  • 不用于仓库、源代码、提交、分支或拉取请求工作。
  • 关于具体收费、价格、平台支持范围等事实,资料中暂未提供。