SuperAPI AI 工具集

fix-sentry-issues

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

用途:该技能用于通过 Sentry MCP 发现、分诊并修复生产环境问题,强调做根因分析,而非简单关闭 Sentry 议题。适用场景包括被要求修复 Sentry 问题、分诊生产错误等。

主要能力与用法:第一阶段“发现与分诊”先用 ToolSearch 加载工具,再依次调用 find_organizations → find_projects → search_issues,可用 naturalLanguageQuery: "all unresolved issues sorted by events"。建立分诊表,Action 只能填 Investigate 或 Ignore,并通过 mcp__sentry__update_issue(..., status: "ignored") 或 status: "resolved" 应用。第二阶段“调查”一次只处理一个议题:先拉取事件级数据(get_issue_details、search_issue_events),提取 URL、参数、堆栈、状态码、时间戳;再用 traceId 在 Axiom 交叉查询,命令为 axiom query "['shiori-events'] | where traceId == '<traceId>'" -f json;然后阅读失败代码路径、向上追踪输入路径、用真实失败输入复现、确定根因。第三阶段“修复”:每个议题单独分支 git checkout main && git pull && git checkout -b fix/<descriptive-name>,先写测试,再实现根因修复,验证后提交 PR,合并后再在 Sentry 中解决。

限制与反模式:不批量把问题归类为“expected”而不调查;不把“有回退路径”当作“不是问题”;不把多个议题合并进一个 PR;不丢弃错误详情(不移除 catch 的 error、不剥离状态码);不在分诊阶段决定修复方案。只有在确实是预期状态(如可选列缺失、资源已删除)时才可降日志级别,有回退的失败不适用。资料未提供其安装方式、依赖版本或收费信息。