SuperAPI AI 工具集

flexport-incident-runbook

编程与开发

查看项目

更新于 10-15 23:25

技能介绍

该技能是一份 Flexport 交付缺口事故响应手册,核心原则是优先保证货运数据正确性:冻结不确定的写操作,区分供应商投递与本地处理,并通过有据可查的资源/事件读取来重建受影响状态。

用途:在 Flexport 集成出现事故时(如事件停止、载荷解析异常)提供结构化处置流程。前提包括明确事故负责人、严重级别、开始时间、受影响租户/工作流、最后已知良好版本与配置,以及有界对账查询与争议状态业务负责人。

主要步骤:一、遏制:禁用自动订舱与受影响写入,仅在持久化入队与去重正确时保留已认证 webhook 接收。二、界定窗口:按面、操作、版本、凭据别名定位首个/末个错误接收,避免查看大量敏感载荷。三、拆分故障域:独立测试 OAuth、REST 读取、MCP 连接、webhook 入口、队列处理与下游状态。四、只读对账:用 /events 或受影响资源读取比对供应商状态与本地持久操作键,不要假设 Flexport 存在 webhook 重放端点。五、确定性修复:精确一次地重处理已认证持久事件或应用已批准的状态修正;重试前先对不确定的创建/订舱对账。六、恢复与学习:按队列恢复流量、验证完整事故窗口、必要时轮换泄露凭据、添加脱敏回归夹具。

认证方式:REST 调用使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌,受众为 https://api.flexport.com,或明确接受宽泛 API 密钥;每个工作负载使用不同凭据,切勿记录凭据或令牌。MCP 调用使用到 https://mcp.flexport.com/mcp 的已认证连接,并受各工具账户权限约束。

工具纪律:用 Read 和 Grep 做发现与取证;仅在批准的产物、代码、配置、测试或回执上使用 Write 或 Edit,不得做未经批准的 Flexport 侧更改。

输出:范围明确的决策或实现产物、脱敏操作与验证回执、失败/回滚/后续责任记录。回执形如:surface、operation、decision、outcome、evidence(release_sha 记录在带外、provider_reference 脱敏)、rollback_owner。

限制:资料未提供具体价格、平台支持或效果保证;若敏感载荷需求出现,应升级访问权限并最小化字段,而非复制宽泛日志。