SuperAPI AI 工具集

linear-incident-runbook

数据与分析

查看项目

更新于 10-15 23:27

技能介绍

用途:在 Linear 集成出现事故时,按只读优先的方式分析并遏制问题,覆盖认证、授权、配额、GraphQL schema、Webhook 投递、下游队列与数据对账等故障类别。

主要能力:先声明严重级别、指挥官、受影响工作区/团队、开始时间、客户影响与写操作冻结状态;检查 Linear 服务状态并执行最小只读认证查询,采集脱敏错误与速率头;对故障分类;遏制重试、暂停非必要生产者、保留 Webhook 投递 ID;通过最小获批变更恢复,仅重放幂等或已明确对账的工作;最后做差距分析、遗漏事件对账、凭据审查与回归测试。

必要用法:使用 Read、Glob、Grep 检查代码与配置;WebFetch 仅用于 Linear 一方文档与包元数据;Write/Edit 仅用于已知目标文件的实现。认证上,个人 API 密钥仅用于所有者控制的脚本,用户委托应用用 OAuth with PKCE,获批自动化用 client-credentials;个人密钥用 Authorization: <API_KEY>,OAuth 用 Authorization: Bearer <ACCESS_TOKEN>,凭据存于服务端密钥管理器。

关键契约:Webhook 五秒超时,失败后按一分钟、一小时、六小时重试,最多三次;速率证据来自请求、端点、复杂度头及 RATELIMITED GraphQL 错误;OAuth client-secret 轮换会立即失效 client-credentials 令牌,但本身不撤销已有工作区访问/刷新令牌。

限制:未经责任所有者明确批准,不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、变更范围或团队访问、变更工作区数据、配置 Webhook、导入导出数据、变更角色/SCIM/审计流、传输诊断信息或变更付费权益;诊断保持只读,除非已请求实现。输出需包含范围、认证模式(不含凭据值)、检查的文件与契约、操作名、证据、验证结果、脱敏字段、剩余风险、所有者、审批状态与回滚或下一步。