SuperAPI AI 工具集

notion-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:在 Notion SDK 或 API 契约发生变更时,安全地升级现有集成。涵盖盘点、兼容性测试、分阶段灰度发布与回滚,在正式操作前产出可审计的决策或工件。

主要能力:

  1. 盘点所有客户端、显式或默认 API 版本、SDK 版本锁定、操作、对象类型、测试夹具与 Webhook 订阅版本。
  2. 阅读官方升级指南,构建前后契约矩阵。
  3. 将数据库查询假设替换为数据源标识,更新搜索与模式操作。
  4. 更新区块位置、回收站状态与会议纪要块处理,以及未知字段容错。
  5. 运行离线夹具、双读对比、拒绝路径、可逆沙箱写入与回滚测试。
  6. 对单一有界工作负载做金丝雀发布,核对结果,仅在保留回滚工件的前提下推进。

使用方式:使用专用非生产连接与合成内容进行升级测试,切勿为测试兼容性轮换生产凭据。使用 Read、Glob、Grep 检查文档、配置、代码与夹具;Write、Edit 仅用于获批的仓库工件。版本或 SDK 推进需发布审批,任何实时兼容写入或迁移需内容负责人审批。

限制:不更新 SDK 就静默继承新 API 契约,或把旧夹具强制转换为新类型使测试通过,均属禁止。对象标识、回收站状态或一致性出现偏差时应回滚。可变的字段、端点、版本、限制或交付行为需重新核对有日期的官方证据;观察到的租户行为仅为环境特定证据,不构成 Notion 的通用保证。具体价格、平台支持与完整安装命令资料暂未提供。