用途:该技能用于升级 Exa SDK 或 API 用法,流程包括契约清单、fixture 差异对比、金丝雀验证和可回滚的依赖变更。适用于操作或审查 Exa 相关代码的场景。
主要能力:记录当前依赖、锁文件、端点调用、类型、请求头和功能开关;阅读目标 SDK 规范与 Exa 变更日志以识别破坏性变更;对比自有 fixture 的请求、响应、错误、状态码和成本;仅更新应用适配层并确定性重新生成锁文件;先跑离线契约测试,再在目标版本上执行经批准的合成金丝雀;保留依赖回滚,观察后再移除兼容代码。
使用方式:使用 Read、Glob、Grep 检查仓库代码、配置、fixture 和证据;仅对经批准的实现或文档变更使用 Write 和 Edit。正常 REST 调用需从服务端密钥管理器注入 EXA_API_KEY,并仅以 Authorization: Bearer 发送到配置的第一方 Exa API 主机。
限制与边界:不得因调用本技能而自动调用 Exa、执行付费研究,或创建、修改 Monitor、Webset、Agent 运行、Batch、团队、成员、API 密钥、预算、Webhook 或部署。涉及敏感意图的实时查询、生产凭据、花费或速率限制变更、强制实时爬取、生成摘要、外部交付、部署、成员或密钥变更、计划创建,以及破坏性取消、停止、删除或撤销,均需有责任负责人批准。只读仓库检查和合成离线验证不授权实时供应商操作。不得自动回退到旧 SDK 或搜索类型;编译通过不能证明响应、错误或计费兼容;Beta 请求头和功能必须显式且可独立移除。输出需排除凭据、原始查询、提示词、预签名 URL、检索内容、生成输出和客户衍生数据,除非另行批准。
当前契约:Search 使用 auto、fast、instant、deep-lite、deep 和 deep-reasoning;neural 是新代码中的遗留术语。SDK 方法名和请求大小写因语言而异,较新产品面可能受 Beta 门控。第一方 SDK 规范和变更日志是迁移权威。