SuperAPI AI 工具集

incident-triage

部署与运维

查看项目

更新于 10-30 16:29

技能介绍

用途:面向 Superset 托管服务的生产事故首轮分诊。技能只负责收集事实并起草报告,由人工决定并对外发布;开始前需阅读 docs/runbooks/incidents.md 中的“Severity”和“Status page updates”章节。

主要能力:

  • 框定报告:各写一行,说明用户看到的现象、开始时间(首次报告或首个信号)、影响范围(全部用户、单一区域、单一功能、单一版本或单一用户)。若仅一个用户或一台机器受影响,则停止分诊,提示这属于支持问题并建议使用 superset doctor。
  • 信号采集:并行执行可并行的检查并记录时间。包括近期部署(gh run list 查“Deploy Production”最近 5 次,git log 查 6 小时内 origin/main 提交,必要时用 gh run view 查看失败或缓慢的 job,尤其是 deploy-database 迁移);Sentry 异常(在已连接 Sentry MCP 工具时,检索 api、web、admin、marketing、docs、relay(含 realtime)、sandbox、desktop、host-service、mobile 各项目近 2 小时内首次出现或激增的问题,记录标题、事件数、首次出现时间与版本);健康检查(仅 GET、10 秒超时,请求 relay、realtime、api 的 /health,并读取 status.superset.sh 的 summary.json);Vercel(CLI 已关联时用 vercel ls 与 vercel logs 查看部署与错误);上游状态(指出信号指向的上游提供商 Vercel、Cloudflare、Neon、GitHub,请人工自行查看其状态页)。
  • 提出建议:输出“Triage draft (not posted)”块,包含摘要、各信号结果、推测原因、建议严重级别(SEV1/2/3)、建议的状态页更新文案(Investigating/Identified/Monitoring/Resolved)以及给负责人的后续步骤,最后注明等待批准且未发布、未部署、未更改任何内容。

使用方式:按上述步骤执行检查,工具未连接或检查失败时写“not checked”及原因,不猜测;所有时间使用 UTC。输出仅为对话内的草稿。

适用场景:Superset 托管服务疑似生产事故的首轮排查与状态页文案起草。

限制:全程只读,不得部署、回滚、禁用工作流、修改开关、解决 Sentry 问题或执行写 SQL;不得向 status.superset.sh、Slack、Discord、Plain、X 等渠道发布内容,不得宣布事故;批准后由人工在 incident.io 自行发布,回滚等写操作属于本技能之外的独立请求;上游状态页默认不自行抓取,除非人工要求。