SuperAPI AI 工具集

ramp-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:28

技能介绍

用途:当 Ramp 集成的 API、schema、scope、endpoint 或行为发生变化时,按迁移流程处理,而不是静默改动。

主要能力:冻结新旧 OpenAPI 校验和、指南与 changelog 快照、客户端版本、endpoint 清单、scope、存储 schema 与部署产物;比对路径、动词、请求/响应字段、枚举、必填性、分页、金额单位、错误、限制、弃用与授权;将各消费方与存储记录分类为兼容、需适配、需回填、行为变更、scope 变更或阻塞;更新窄适配器与 fixture,必要时签发新最小 scope token,运行新旧沙箱测试与回滚兼容测试;暗发布、单队列金丝雀、对账后扩展或回滚。

使用方式:先确认 Ramp 应用、环境、业务实体、受影响数据与工作流、负责人与回滚边界;阅读 references/official-docs.md 并复核 endpoint schema、scope、限制与支持状态;在生产访问与业务影响获批前使用合成 fixture 或 Ramp 沙箱;准备已批准的密钥存储与脱敏证据位置。工具使用上,用 Glob 定位候选代码与证据,用 Grep 查找 endpoint、字段、权限、标识符、错误与过时假设,用 Read 检查最小必要文件,Write 仅用于新批准的本地草稿、测试、配置或证据,Edit 仅用于有已知回滚的受限变更。

适用场景:将虚拟卡管理从已弃用的旧 Cards 操作迁移到基于资金的当前 endpoint;采用变更后的会计响应字段并双读旧记录对账。

限制:本地文件工具不授权 Ramp 操作,也不替代负责人批准;API/应用负责人批准契约变更,安全批准新授权/scope,数据/财务负责人批准 schema、回填与业务影响变更;新增配置 scope 不会更新现有 token,需新 token;未知字段是否被接受需按当前 schema 测试;回滚无法读取新写入数据时,应保持写入禁用直至双读或可逆迁移得到验证;未解决的供应商行为、授权或财务状态应视为停止条件。