SuperAPI AI 工具集

ramp-ci-integration

测试与质量

查看项目

更新于 10-15 23:28

技能介绍

用途:该技能用于为 Ramp 集成搭建 CI 门禁,把快速、确定性的契约检查与需要凭据的沙箱冒烟测试分开,使 CI 能拒绝模式漂移和不安全的生产目标,同时不进行资金写入、不依赖易变的实时数据。

主要能力:固定经过审查的官方 OpenAPI 文档副本或校验和,并仅针对集成实际使用的端点生成模式夹具;用经过脱敏的成功、校验、授权、限流、超时和分页夹具运行单元测试,并断言密钥脱敏与幂等行为;增加漂移任务,将固定契约与当前官方文档比对并生成需人工审查的变更报告,而不是静默重新生成客户端;产出 CI 门禁图、固定契约回执、确定性测试结果、脱敏沙箱冒烟回执、漂移报告以及发布/回滚决策。

必要用法与前置条件:需先确认 Ramp 应用、环境、业务实体、受影响的数据与工作流、责任人和回滚边界;阅读 references/official-docs.md,并在任何实时操作前重新核对端点模式、权限范围、限制和支持状态;在获得明确批准前使用合成夹具或 Ramp 沙箱。沙箱与生产隔离且不能转移真实资金,当前 API 主机为 https://demo-api.ramp.com。需凭据的检查仍要求最小 OAuth 权限范围,生产凭据不得进入拉取请求任务。需要配置经批准的密钥存储与脱敏的证据位置。请求夹具必须针对确切的端点模式进行校验,因为未知字段在某些端点可能被忽略、在另一些端点可能被拒绝。

工具纪律与限制:用 Glob 定位候选代码、清单、夹具与证据而不扩大范围,用 Grep 查找相关端点、字段、权限、标识符、错误与过期假设,用 Read 检查最小的必需本地文件与权威证据,仅对新批准的本地草稿、测试、配置或证据工件使用 Write,仅对已知回滚的有界已批准变更使用 Edit。本地文件工具不能授权 Ramp 操作,也不能替代责任人批准。仓库所有者批准 CI 策略,安全负责人批准受保护的沙箱凭据;生产探测、真实资金写入和自动化客户端重新生成需要单独明确批准。若派生分支无法访问密钥,应保留确定性测试为强制项,并把受信沙箱探测标记为不可用而非削弱门禁;若 OpenAPI 差异很大,应分类为破坏性、增量和仅文档变更,仅在端点负责人审查后重新生成;若测试解析到生产主机,应在网络访问前失败关闭并轮换暴露给该任务的凭据。日志不得包含访问令牌、客户端密钥、卡数据、收据图像或个人数据;未解决的厂商行为、权限或财务状态应作为停止条件。