前言¶
把现有项目从一种语言迁到另一种，常见做法是让模型「按感觉重写」：目录对不齐、资源文件漏拷、测试用 mock 糊弄过去，多轮对话后也很难判断到底迁完了没有。下面介绍 SkillHub 上的 编程语言迁移（坐标 @user_35d642b5/lang-migration，当前版本 v1.3.1）。它不是你在终端里单独跑的二进制，而是一套装进 AI 编码代理里的 协议：规定迁移顺序、要留什么证据、以及如何证明工作确实完成，并针对模型容易走捷径的行为做了约束。
这是什么¶
编程语言迁移 在 SkillHub 上归类为 dev-programming，来源为社区（发布者 user_35d642b5）。官方把它定义为 AI 技能——一份可迁移、与具体代理实现无关的规范，告诉有能力的 LLM 如何迁移代码库、按什么顺序推进、需要什么证据、以及如何验收。
可以把它类比成实验室里的操作规程：目标不是「写得更聪明」，而是让执行过程可检查、可延续，减少「看起来做完了」和「实际上没迁全」之间的落差。页面标注 requires_api_key=false，安装与使用本身不依赖额外 API Key 配置。
核心功能（以官方描述为准）¶
官方简介强调的能力边界如下，写作与使用时宜按字面理解，不要把它当成黑盒转换器。
-
迁移方法论，而非独立工具
技能通过SKILL.md等通用 Skill 格式进入代理上下文，由代理在仓库里按协议执行读写、对照与记录，而不是替代你的构建系统或编译器。 -
顺序、证据与完成证明
协议要求明确「先做什么、后做什么」，并在过程中留下可核对的证据，最终要能说明迁移是否真正完成，而不是只交付一版新语言源码。 -
防捷径设计
描述中明确指出：规范用于检测并防止执行者（包括 LLM）倾向于抄近路；适合需要 可审计、可接力 的整库迁移，而不是一次性 demo。 -
代理无关
同一套坐标可在支持 Skill 的多种编码代理中安装；行为由协议驱动，不绑定某一家的内置命令。
关于评分与热度：已抓取资料记载 SkillHub 评分 100000、下载 1460（以抓取时点为准；页面展示可能更新）。
安装与启用¶
安装流程以 SkillHub 官方文档 SkillHub 安装与优先源配置 为准。Skill 详情页给出的提示是：让 AI 按该文档安装 @user_35d642b5/lang-migration。
1、确认 CLI¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按官方脚本安装（完整安装含 CLI 与默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装到当前代理的 skills 目录¶
官方强调：安装时必须用 --dir 指向 当前 Agent 正在使用的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。常用路径示例（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在对应目录下执行（将 <skills 目录> 换成你的实际路径）：
skillhub install @user_35d642b5/lang-migration --dir <skills 目录>
也可先搜索再安装：
skillhub search lang-migration
skillhub install @user_35d642b5/lang-migration --dir <skills 目录>
安装后按你所用客户端的要求重启或刷新 Agent，使 Skill 进入上下文。不同客户端（Cursor、Codex CLI、Claude Code 等）的差异主要在 skills 目录位置，安装命令本身一致；未在官方文档单独说明的差异此处不展开。
典型用法¶
官方页面未提供固定的一键示例仓库，可复现的用法是「先装 Skill，再在对话里声明迁移意图」：
- 按上一节把
@user_35d642b5/lang-migration装进当前代理的 skills 目录。 - 在已打开目标代码库的工作区中，用自然语言说明源语言、目标语言及验收期望（具体步骤由 Skill 协议在会话中展开）。
- 让代理按协议分阶段输出进度与证据；需要多轮或换人接力时，在同一工作区内延续对话，并以协议要求的记录为准。
若你更习惯「把安装说明交给 AI」，可直接发送 SkillHub 页面上的安装提示：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_35d642b5/lang-migration`。
适用场景与注意¶
更适合： 需要把 整个代码库 从一种语言迁到另一种、且希望过程可检查、可多人或多轮接力的团队；已在使用 Cursor、Claude Code、Codex 等支持 Skill 的编码代理的开发者。
需要心里有数：
- 这是 代理内协议，不会自动替代你的 CI、测试框架或语言工具链；编译、测试、发布仍要在真实环境中跑。
- 迁移质量取决于模型能力、仓库规模与领域复杂度；协议降低漏项和糊弄的概率，不保证零人工复核。
- 安装路径错误是最常见的「装了但没用」原因，务必核对
--dir与客户端文档中的 skills 目录。 - 社区来源技能，升级前可用
skillhub查看是否有新版本（当前介绍版本为 1.3.1）。
结尾¶
编程语言迁移 v1.3.1 把「换语言」从一次性提示词，收敛成可安装的迁移协议：强调顺序、证据与完成证明，并针对 LLM 走捷径的风险做了方法论层面的约束。若你正在评估整库迁移方案，可从 SkillHub 详情页与安装文档入手。
- SkillHub 页面：https://www.skillhub.cn/skills/user_35d642b5/lang-migration
- 官方 API 条目：https://api.skillhub.cn/user_35d642b5/lang-migration
- 安装说明：https://skillhub.cn/install/skillhub.md
