用途:迁移真实存在的 Attio 集成,先证明受影响端点与数据形态符合当前 Attio 合同,而非假设通用历史版本跳跃。
主要能力:维护端点、作用域、分页、数据形态与 webhook 清单;对每个受影响端点做方法、路径、请求/响应字段、值形态与分页校验;将官方 OpenAPI 作为差异输入;识别记录与条目查询可能使用 offset 分页和基于分数的速率计数,其他端点可能使用游标;webhook 需保留原始 body 签名验证与至少一次幂等。
使用方式:用 Read、Glob、Grep 盘点现有假设与测试;仅对当前官方 Attio 文档和 OpenAPI 使用 WebFetch;在合同差异、发布边界和回滚点记录后再用 Write 或 Edit。先冻结调用点、依赖、合同、夹具、指标与生产行为基线,逐一对比官方文档与 OpenAPI,将变更分类为兼容、新增、行为敏感或破坏性,添加分页、值形态、错误、幂等与脱敏的适配器和测试,运行影子读取或干跑对账,再以明确健康与回滚阈值对单个工作区或负载做金丝雀,分阶段扩展,保留回滚直至对账通过,最后有意移除废弃路径。
适用场景:已有 Attio 集成需要随合同演进升级、验证行为兼容性并控制发布风险。
限制:新增作用域、更改破坏性变更、切换全部租户或移除回滚路径均需负责人批准并留证据;官方来源冲突时暂停端点并保留两份参考;影子结果不一致时保持旧路径;金丝雀错误预算失败即回滚;回滚无法恢复状态时须先修复恢复能力。输出应包含前后合同矩阵、风险分类、适配器计划、测试证据、影子或金丝雀结果、对账状态与回滚决策。具体命令与定价暂未提供。