SuperAPI AI 工具集

flexport-debug-bundle

测试与质量

查看项目

更新于 10-15 23:26

技能介绍

用途:在 Flexport 相关 API、MCP、OAuth 或 webhook 故障升级时,收集能区分契约、权限、版本、传输与供应商故障的最小证据集,而非打包整个环境、日志目录、请求体、webhook 负载或凭据文件。

前置条件:事件 ID、时间窗口、表面(surface)与失败操作;已批准的脱敏规则与证据接收方;已知凭据别名、应用发布版本与预期 Flexport 版本。

主要步骤:一、先声明允许清单,仅列入时间戳、发布 SHA、surface、操作、版本头、状态/代码/消息、关联 ID、负载摘要等精确元数据字段;二、记录配置形态,包括变量名、端点主机、功能开关与凭据别名,不包括取值、令牌、密钥后缀或 .env 内容;三、汇总尝试记录,列出有边界的尝试时间戳与结果,排除原始请求/响应体、文档数据、路由细节、姓名、邮箱与地址;四、仅在复现失败所必需时,加入最小脱敏夹具或字段名差异;五、两次复核,先跑自动化密钥/敏感数据扫描,再由人工负责人批准清单与接收方;六、通过批准的支持渠道传输,记录校验和与过期时间,并按事件证据策略删除。

认证: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、rollback_owner),但绝不放入凭据或供应商负载。

错误处理:密钥扫描触发则停止传输、移除材料,若已暴露则轮换并重新扫描;若复现需要负载,则创建合成最小夹具而非发送生产内容;接收方或目的不明则不构建也不发送清单;归档工具若建议宽泛路径,则拒绝并仅使用显式允许清单。

适用场景:webhook 升级、API 权限或版本排查、OAuth 问题定位等需要最小化证据的场景。限制:资料未提供具体 Flexport 版本号、价格、支持渠道名称及各类故障的完整处置细节。