Advanced
1 hour
How to 运行代码迁移 with Eigent
在受控检查点中迁移遗留技术栈——将旧系统映射到新系统,分阶段完成迁移,并在每次切换前验证一致性。
What you need
- Eigent 桌面应用
- 代码库访问权限(本地或已连接的仓库)
- 测试套件、lint 和类型检查工具
Best for
- 需要更换框架、运行时或平台约定的遗留到现代技术栈迁移
- 需要兼容层、分阶段过渡以及在每个检查点进行明确验证的团队
- 管理增量式 strangler-fig 或 branch-by-abstraction 迁移的工程师
Starter Prompt
将这个代码库从 [legacy stack or system] 迁移到 [target stack or system]。 要求: - 先盘点遗留系统的假设:路由、数据模型、认证、配置、构建工具、测试、部署和外部契约。 - 将旧技术栈映射到新技术栈,并指出任何没有直接对应项的部分。 - 提出增量迁移计划,使用兼容层或检查点,而不是一次性重写。 - 除非迁移明确要求用户可见的变更,否则保持行为不变。 - 按里程碑推进,并在每个里程碑后运行 lint、类型检查和聚焦测试。 - 在迁移完成前,始终保留回滚或降级方案可见。 - 如果验证失败,先修复再继续。 先从梳理迁移范围并提出检查点计划开始。
工作原理
- 盘点遗留系统的假设——路由、数据模型、认证、配置、构建工具、测试、部署和外部契约。
- 将旧技术栈映射到新技术栈,并指出任何没有直接对应项的部分。
- 提出增量迁移计划,使用兼容层或检查点,而不是一次性重写。
- 除非迁移明确要求用户可见的变更,否则保持行为不变。
- 每个里程碑完成后,运行 lint、类型检查和聚焦测试,以在继续前证明一致性。
- 在迁移完成前,始终保留回滚或降级方案可见。
试试这些更多提示
- 这个代码库中有哪些内容在目标技术栈里没有直接对应项?我们应该如何处理每一个差距?
- 提出一个兼容层,让旧代码和新代码在过渡期间可以共存。
- 在这个里程碑之后,能证明与遗留路径一致的最小测试或检查是什么?
- 如果这个检查点的迁移在生产环境失败,回滚步骤是什么?
如何使用
在 Eigent 中连接好你的代码库,并描述源技术栈和目标技术栈。从迁移范围盘点开始——这能让你在任何代码变更之前,完整了解需要迁移的内容。按里程碑逐步推进,并在每一步后验证。若迁移跨越多天,可让 Eigent 创建一份 ExecPlan 文档,用于跨会话跟踪决策、延期事项和验证结果。
预期输出
一份迁移范围盘点、一个基于检查点的迁移计划、每个里程碑的实现差异,以及一份在每一步后确认一致性的验证摘要。每个切换点都会标注回滚方案。
限制
- 复杂的数据模型变更可能需要手动编写 schema 迁移脚本,Eigent 可以起草,但你必须审核。
- 外部契约变更需要在迁移之外进行协调。
- 大规模重写最好拆分为多个小里程碑——避免在每个里程碑中批量处理超过技术栈一层的变更。