用途:在 Instantly 工具链与 schema 持续演进时,安全地升级 SDK、CLI、OpenAPI 派生类型或 API v2 契约,并与一次性的 API v1 切换分开处理。需记录假设、证据、审批状态与回滚责任人,便于他人复现。
主要能力:清点当前运行时、依赖锁定、生成类型、路由、fixture 与调用方;读取第一方发布与包元数据,区分破坏性、增量和行为变更;在隔离分支中逐个组件升级并保留旧 lockfile 以便回滚;运行离线类型、契约、错误、分页与脱敏测试;在暂存环境做有界只读金丝雀验证;经负责人评审后再推广。
使用方式:用 Read、Glob、Grep 检查代码与证据;WebFetch 仅用于第一方 Instantly 文档和包元数据;仅在明确要求实现且目标文件已知时使用 Write 或 Edit。认证使用 API v2 密钥,以 Authorization: Bearer <key> 请求 https://api.instantly.ai/api/v2,仅授予所需端点范围,密钥从服务端密钥管理器注入,不得打印、持久化、提交或放入 URL。
限制与边界:TypeScript SDK 处于 beta,稳定 1.0.0 前可能调整;CLI 与 SDK 的 Node.js 最低版本和发布节奏不同;生成资源跟随实时 OpenAPI schema,方法可用性需在已安装版本中核对。未经负责人明确批准,不得创建、轮换、泄露或撤销密钥,不得邀请或移除成员、跨工作区委派、连接发信账户、创建或激活活动、导入或删除线索、更改抑制或保留策略、注册或修改 webhook、调整套餐或付费容量、传输诊断信息或执行其他生产变更。诊断默认只读。401 时停止并核实密钥;403 时核对所需范围,不要默认放宽为 all:all;429 时协调工作区预算并限制重试;schema 或租户不匹配时失败关闭,保留脱敏证据且不重试变更。输出应包含工作区安全范围、检查的文件与契约、API v2 路由与所需范围、证据、验证结果、脱敏字段、剩余风险、负责人、审批状态及回滚或下一步。