如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

执行代码迁移

分阶段迁移旧技术栈,在每个检查点验证结果。

难度 Advanced
时间跨度 1h

使用 Codex 梳理旧系统与新技术栈的对应关系,按里程碑推进迁移,并在每次切换前验证新旧系统的行为是否一致。

最适合

  • 从旧技术栈迁移到现代技术栈时,需要更换框架、运行时或构建系统,或适应新平台约定的项目。
  • 需要使用兼容层、分阶段切换,并在每个迁移检查点验证结果的团队。

目录

    ← 所有使用场景

    执行代码迁移

    分阶段迁移旧技术栈,在每个检查点验证结果。

    使用 Codex 梳理旧系统与新技术栈的对应关系,按里程碑推进迁移,并在每次切换前验证新旧系统的行为是否一致。

    Advanced
    1h

    使用 Codex 梳理旧系统与新技术栈的对应关系,按里程碑推进迁移,并在每次切换前验证新旧系统的行为是否一致。

    Advanced
    1h

    最适合

    • 从旧技术栈迁移到现代技术栈时,需要更换框架、运行时或构建系统,或适应新平台约定的项目。
    • 需要使用兼容层、分阶段切换,并在每个迁移检查点验证结果的团队。

    技能与插件

    • 合并前,检查高风险的迁移改动、依赖项变更以及系统对外暴露的部分。
    • 每完成一个迁移里程碑,就修复导致 CI 检查失败的问题,避免把问题留到最后。
    • 如果迁移涉及 ASP.NET Core 应用模型、`Program.cs`、中间件、测试、性能或版本升级,请参考该框架的专门指南。
    技能 使用理由
    Security Best Practices 合并前,检查高风险的迁移改动、依赖项变更以及系统对外暴露的部分。
    Gh Fix Ci 每完成一个迁移里程碑,就修复导致 CI 检查失败的问题,避免把问题留到最后。
    Aspnet Core 如果迁移涉及 ASP.NET Core 应用模型、`Program.cs`、中间件、测试、性能或版本升级,请参考该框架的专门指南。

    起始提示词

    试试在 GPT-6.2 Astra 中使用这条提示词。

    将此代码库从 [legacy stack or system] 迁移到 [target stack or system]。 要求: - 先梳理旧系统赖以运行的各项假设,涵盖路由、数据模型、身份验证与授权、配置、构建工具、测试、部署和对外接口约定。 - 列出旧技术栈各部分在新技术栈中的对应项,并指出哪些部分没有直接对应项。 - 提出渐进式迁移计划,引入兼容层或设置检查点,避免一次性重写整个系统。 - 除非迁移明确要求改变用户可感知的行为,否则保持现有行为不变。 - 按里程碑推进。每完成一个里程碑,就运行代码规范检查、类型检查和针对本阶段改动的测试。 - 在切换完成前,始终明确列出可用的回滚或备用方案。 - 如果验证失败,先修复问题,再继续迁移。 - 第一步是梳理迁移范围,并提出检查点设置方案。
    AstraMedium
    将此代码库从 [legacy stack or system] 迁移到 [target stack or system]。 要求: - 先梳理旧系统赖以运行的各项假设,涵盖路由、数据模型、身份验证与授权、配置、构建工具、测试、部署和对外接口约定。 - 列出旧技术栈各部分在新技术栈中的对应项,并指出哪些部分没有直接对应项。 - 提出渐进式迁移计划,引入兼容层或设置检查点,避免一次性重写整个系统。 - 除非迁移明确要求改变用户可感知的行为,否则保持现有行为不变。 - 按里程碑推进。每完成一个里程碑,就运行代码规范检查、类型检查和针对本阶段改动的测试。 - 在切换完成前,始终明确列出可用的回滚或备用方案。 - 如果验证失败,先修复问题,再继续迁移。 - 第一步是梳理迁移范围,并提出检查点设置方案。
    AstraMedium

    简介

    从一个技术栈迁移到另一个技术栈时,您可以让 Codex 梳理迁移范围,并按计划分步实施。迁移可能涉及路由、数据模型、配置、身份验证、后台作业、构建工具、部署和测试,甚至包括编程语言和框架本身的惯例。

    Codex 可以盘点旧系统,梳理新旧概念之间的对应关系,并分阶段完成改动,无须一次性大规模重写。当您需要在产品持续运行的同时淘汰旧框架、将代码移植到新的运行时环境,或用新技术栈逐步替换旧技术栈时,这种方式尤其有用。

    使用方法

    1. 先盘点迁移涉及的内容,包括旧系统使用的软件包、框架惯例、路由、数据访问、身份验证、配置、构建工具、测试、部署所依赖的假设,以及迁移后仍须遵守的对外契约。
    2. 让 Codex 梳理旧系统中的概念在目标技术栈中的对应关系,并指出哪些概念没有直接对应项。
    3. 选择渐进式迁移策略,例如引入兼容层、逐个移植模块、通过抽象层切换实现,或采用绞杀者模式,每次沿一个系统边界替换旧实现。
    4. 保持系统行为稳定。只有在迁移确实要求改变可观察行为时才做调整,并明确列出这些例外。
    5. 每完成一个阶段,就在足以确认新旧实现行为一致的最小范围内进行验证,例如运行静态代码检查、类型检查、针对性测试、契约测试或冒烟测试,也可以并排对比新旧代码路径的执行结果。
    6. 在每个检查点审查代码差异,并评估后续迁移仍面临的风险,无须等到整个系统重写完毕。

    使用 ExecPlans

    我们在代码现代化实践指南中介绍了 ExecPlans。这类文档让 Codex 能够掌握整体清理进度、明确最终要达到的状态,并记录每一轮的验证结果。 让 Codex 执行复杂迁移时,请它为系统的每个部分分别创建一份 ExecPlan,确保每项决策和技术栈选型都有记录,便于日后审查。

    配合目标使用

    如果某一部分的迁移需要较长时间,可以设置一个目标,指引 Codex 完成这部分工作。设定目标时,请明确最终要达到的状态、如何验证新旧实现的行为一致、对回滚有何要求,以及满足什么条件时应停止。

    相关使用场景