Agent Skills
返回列表
编程语言迁移

编程语言迁移

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_35d642b5/lang-migration。

技能介绍

要解决什么问题

跨语言迁移开源项目不只是批量翻译代码，还涉及目录结构、算法步骤、控制流、测试数据、生态差异和跨会话状态。若由 Agent 自主执行，容易出现“标记完成但未读源码”、批量生成、静默确认、提前进入下一阶段等问题。

工作流如何约束迁移

lang-migration 用一套可审计的多会话工作流处理该问题：每个源文件都要分析并分配迁移策略，优先保持 1:1 结构等价，只有生态差异无法结构复刻时才转向行为等价；测试要求真实实现和真实测试数据，不允许 mock；无法自主决策时进入 BLOCKED，等待人工输入，而不是跳过。

核心步骤包括：P0 初始化 migration_workspace/ 与 YAML 状态；P1 资产扫描；P2 生态映射；P3 IPO 分析；P4 翻译；P5 验证；每次修复都要执行 TDD 复盘，并在全量重跑测试；每个阶段结束后执行 PGR 门审，只有零发现且 phase_gates.PGR_N.passed_at 写入后才能标记 DONE。

适用边界

它更偏向有明确源项目、目标语言和可运行测试的工程迁移；对缺少测试、结构混乱或目标语言生态差异过大的项目，会频繁触发阻塞与人工确认。

使用场景

  • 接手一个 Python 开源库，需要迁移到 Rust，并保留目录、控制流和测试结构。
  • 把 C++ 命令行工具转成 Go，要求逐文件分析、真实测试且不能 mock。
  • 跨会话继续大型迁移，依赖 migration-state.yaml 恢复阶段、任务和阻塞状态。
  • 在每次编译或测试失败后执行 TDD 复盘，沉淀根因规则并全量重跑。

适合人员

  • 负责旧系统语言迁移的资深工程师，需要可审计的迁移状态和阶段门审。
  • 使用 AI Agent 做重构的开发负责人，需要防止任务被批量伪造或提前标记完成。
  • 维护开源项目核心的维护者，要在语言切换后保留控制流、测试证据和修复根因。
  • 做技术债治理的平台工程师，需要把跨语言迁移拆成可恢复、可检查的 YAML 流程。