vibe-fork

一个用于代码库跨语言翻译的Claude技能,通过多智能体循环确保语义保真。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:vibe-fork。
它的用途是:一个用于代码库跨语言翻译的Claude技能,通过多智能体循环确保语义保真。
完整的 Skill 内容见:https://321skill.com/skills/vibe-fork/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我想把这段C++的数值计算内核用vibe-fork的方式移植到Rust。” 它会引导你设置路由和设计文档,然后启动构建者-批评者-修复者的循环,确保翻译后的Rust代码在NaN传播和溢出处理等边界条件上与C++原版行为完全一致。

介绍

vibe-fork 解决了一个常见痛点:将一个稳定运行的代码库从一种编程语言翻译到另一种语言时,容易产生表面正确但语义上存在细微差异的代码,导致在边界条件(如NaN处理、溢出、错误哨兵值)下行为不一致。

它通过安装一个由四个智能体(文档作者、构建者、批评者、修复者)组成的循环,配合两个预工具使用钩子和一个路由表来强制实施机械化的翻译纪律。核心流程是“读→写→验证→提交”,其中验证环节由批评者智能体专门负责寻找语义分歧,并用失败的测试用例来“钉住”这些差异,而非模糊的描述。

这个技能非常适合需要将大型、复杂的已知可工作的上游代码库(如Linux内核、PyTorch框架)移植到新语言(如Rust、Go)的开发团队或独立开发者,尤其适用于对正确性要求极高的系统软件、框架或库的迁移项目。

使用建议:在开始前确保目标项目已初始化为Git仓库,并仔细定制 goal.md 合同和路由表。翻译过程中应严格遵循其设定的循环,不要跳过批评环节,并利用钩子来防止常见反模式。

核心特点

与简单的代码翻译提示词或单智能体翻译不同,vibe-fork 强制实施了一个多智能体、对抗性的验证循环,用自动化的、可复现的失败测试来精确“钉住”语义分歧,从根本上避免了翻译过程中的“氛围式”理解导致的隐蔽错误。

注意事项

不适合全新的绿地项目、没有上游代码可供移植的独立库开发,或纯文档/工具类项目。

常见问题

vibe-fork 能用来把Python脚本翻译成Go吗?

可以,它非常适合用于库或代码模块的跨语言移植,只要你有稳定可靠的上游Python代码作为参照。

使用这个技能需要提前准备什么?

需要一个已初始化的Git仓库作为目标项目,以及对上游代码库的访问权限,以便设置路由和设计文档。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/vibe-fork/raw/index.md 读取 vibe-fork 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。