用途:在 Lucid 集成存在依赖或契约变更时,规划并执行可逆的升级与迁移,覆盖 SDK、CLI、清单、API 版本、Standard Import 格式和连接器。核心原则是一次只移动一个契约边界,并保留不可变基线、代表性夹具、金丝雀证据和经过测试的回滚。
主要能力:清点当前与目标包/CLI 版本、API 版本头、清单与作用域、导入夹具、连接器 schema 和部署产物;建立干净基线(构建、类型、清单、测试、夹具导入导出、数据对账、回滚);重新获取官方文档并检查目标已安装类型与变更日志,形成破坏性变更矩阵;将变更拆分为可逆步骤:工具/依赖、编译修复、清单/作用域、格式/schema、API 版本、部署。
使用方式:使用 Read、Glob、Grep 做版本与用法清点,用 WebFetch 获取当前官方迁移契约,仅用 Write 或 Edit 做已批准的本地更改、测试和回执。逐步应用变更,用项目包管理器重新生成锁文件,先运行窄范围再运行完整受影响门禁;测试新旧代表性夹具并比较渲染、数据、标识符、错误和性能;批准后部署有界金丝雀,对账、监控,超阈值即回滚。
限制与边界:不得仅因存在新版本就升级包、更改 API 版本/作用域、重写存储数据、重装扩展或部署。保留凭据类别与最小作用域,除非有文档化目标契约要求变更;新作用域、重定向 URI、同意、账户授权和密钥轮换应作为单独批准的迁移。若目标类型移除已用 API,应停止并用受支持原语重新设计,不得用类型转换掩盖;若导入渲染不同,保留双方产物、量化差异并要求负责人接受;若回滚会改变数据/schema,需先测试前向修复和恢复副本。输出基线/目标矩阵、官方证据、变更文件、依赖与作用域差异、测试、金丝雀、渲染/数据差异、批准和回滚状态。仅在金丝雀一致、已知差异被明确接受且从确切产物测试回滚后,才进行推广。