技能介绍

要解决什么问题

跨语言迁移或对照阅读时，常见做法是「逐行翻译语法」，结果往往是功能勉强等价、风格却不像目标语言：C 里用 union 和 goto，转到 Java 仍残留不可编译或不可维护的结构；C++ 转 Python 时混用指针思维与动态类型，往返后语义悄悄丢失。

CodeBridge 面向 C、C++、Java、Python 四种语言之间的结构级转译：在给定源码与目标语言后，产出可读、可维护的等价实现，而不是机械替换关键字。

技能如何工作

转译结果按固定结构输出：目标语言代码块（逐行或逐段行内注释说明每个结构如何替代）、翻译指南（针对本次改动点的规则摘要）、语义警告、以及 2～3 条学习建议。

核心约束来自技能内积累的 Gotchas，例如：

内存管理：C→C++ 强制 std::unique_ptr / std::shared_ptr，禁止与裸 new/delete 混用；转到 Java/Python 则去掉手动释放，明确 GC 边界。
联合体：统一选用 std::variant、Java Object + instanceof 或 Python 独立变量等单一方案，并标注 union 内存共享在往返中可能无法恢复。
goto：C→Java/Python 必须重构为 return + 标志位或自定义异常，不得保留 goto。
枚举：使用 enum class、enum Type 或 enum.Enum，禁止用 int 常量冒充枚举。
错误处理与并发：同一输出内风格统一；pthread_mutex → std::mutex → synchronized → threading.Lock 等需正确映射，并在注释中写明线程安全边界。

按需加载方向性参考（如 syntax_c_to_java.md）及专题文档（边界情况、错误处理、并发、标准库等），避免在 Load 阶段一次性塞满上下文。

适用边界

指针运算、setjmp/longjmp、C++ 移动语义、模板与 Java 泛型差异等，没有一对一等价物时，必须在输出中给出 ⚠️ 往返等价性警告。含动态成员的对象禁止按内存布局做 fwrite 式 I/O，应使用流式或序列化。技能还提供 scripts/translive 双屏实时转译 Web 服务与输出模板，但转译质量仍依赖上述规则是否被严格执行。